埋点事件

简介

埋点事件作为用户行为分析的数据基础，在您对应用程序或网站进行埋码采集上报数据之前，请先定义好需要采集上报的事件，包括它们的基本信息、属性信息等。

名词解释

信息	说明
名称	事件在使用过程中的显示名。
标识符	事件在系统内的唯一标识符。 注：仅允许大小写英文、数字、下划线，并且不能以数字开头， 最大长度支持 100 字符。
类型	默认类型为计数器，不可更改。
标签	事件的标签，支持设置多个标签，以便于通过标签对事件进行分组和过滤等操作
描述	事件的描述，可填写事件的触发时机和应用场景。
关联事件属性	该事件需要采集的具体信息。 注：所需属性需要先在事件属性中定义，才能选择。

功能边界或约束

重复性约束

事件的名称和标识符均不可重复

预置事件的编辑范围

预置事件是由系统时安装部署时预置好，而无需您去定义的事件。这些事件有的是由客户端 SDK 自动采集上报的事件，有的是系统离线计算的事件，它们的名称、标识符、类型和描述不可编辑，仅可以添加或调整关联的自定义事件属性或虚拟属性。另外，预置事件不能被删除。

功能说明

新增/创建

通过定义名称、标识符、描述、关联事件属性来完成一条新的埋点事件的定义。

查询

已创建的事件默认按照创建时间逆序排列，支持翻页查看，也支持通过名称或标识符检索来查找已定义的事件。

点击某事件行，除了可查看事件定义详情外，还可以了解该事件过去 7 天的数量趋势。

修改

点击某事件行，在事件详情中，修改事件信息后保存。注：由于标识符是事件的唯一标识，不支持对它的修改。

删除

点击某事件行的操作列的图标，可删除单个事件。也可以在列表中使用复选框选择多个事件，进行批量删除。

事件被删除后不可恢复，引用它的看板图表将受到影响，请谨慎操作。

批量打标

选择一行或多行事件，点击“批量打标”按钮，弹出窗口可以给所选事件增加多个标签。

应用案例

以 APP 中常见的用户点击首页顶部轮播图事件为例，来看看埋点事件的定义方法。

首先，明确对于要分析该点击事件的维度，比如：

• 轮播图的位置索引，这样可以统计轮播图各帧的点击率
• 轮播图的图片类型，这样可以统计不同类型的点击率，常用于流量实验场景

其次，在事件属性中，先定义出如上两个属性

名称	标识符	类型
位置索引	swiper_imgindex	字符串
图片类型	swiper_imgtype	字符串

最后，定义该事件，并将如上两个属性关联到该事件上。

常见问题

Q1：要定义的事件太多，支持批量定义吗？

在批量工具中，支持上传模板文件，将事件及其属性的 CSV 文件上传进行批量创建。