埋点事件属性设计方案

事件分类

按事件的作用对象来给事件分为三大类

事件类型	作用对象	描述	示例
预制事件	应用程序	作用于整个应用程序本身，通常由埋点采集系统自身上报，不需要额外埋点； 每个端的预制事件都不一样，比如小程序、Android、iOS、H5等都有自己特定的预制事件	app_launch 应用启动；
页面事件	页面	页面的进入和离开	page_view 页面浏览
元素事件	元素	元素的点击和曝光，自定义事件

公共属性

所有自定义事件都需要上报的公共属性

属性	是否在火山里设置成公共属性	描述
event_type	否	事件类型：click 点击，exposure 曝光，access 访问
page_id	否	页面ID
page_url	否	页面地址

1. 预制事件

预制事件通常由第三方的埋点系统自己上报，市面上有比较多的第三方埋点系统，例如神策、GrowingIO、火山引擎Finder、阿里云Quick Audience等

2. 页面事件

2.1 页面打开事件 page_view

每一个页面进入的时候，需要上报 page_view 事件，事件名称为 页面浏览

page_view 包含的属性

属性ID	属性名
site_id	站点ID
event_type	事件类型，固定为 access
page_id	页面ID
page_url	页面地址
pre_page_id	前向页面ID
pre_page_url	前向页面地址

2.2 页面离开事件 page_leave

每一个页面离开的时候，需要上报 page_leave 事件，事件名称为 页面离开

page_leave 包含的属性

属性ID	属性名
event_type	事件类型，固定为 access
page_id	页面ID
page_url	页面地址
duration	页面停留时长（毫秒）

3. 元素事件

事件的通用属性，每个元素事件都需要上传

属性	描述	示例值
event_type	事件类型：click 点击，exposure 曝光，access 访问	click
page_id	页面ID，每个页面有一个唯一ID（多平台的同一个页面应该是同一个ID）	P103
page_url	页面完整URL，带参数
area_id	区域位置ID，每个区域位置都有一个唯一ID，是一组元素的集合	P100_A02
item_position	元素相对区域中的下标位置，从左到右，从上到下，从0开始	0
item_id	元素ID， 每个元素都有一个唯一ID，是最小单元，静态元素以FI_开头，在系统里面维护，如果为动态元素，则值为 DI_{area_id}_{position}	FI_3975
item_name	元素名称，和元素ID一一对应，动态元素则根据业务需求传入和元素ID对应的名称	搜索框

除了通用属性外，通常根据不同的业务，或操作展现性质，会有不同的属性，为了让事件属性不要膨胀，建议在埋点管理系统中将事件和事件属性进行严格管控。

可以规定事件创建的时候，属性必须是从现有的属性池中选择，而不是随意添加。

如果列表中没有，则需要先维护属性列表，才能上报该属性。

下表是一个常见的属性列表例子供产考

属性	数据类型	描述	示例值
show_text	string	显示的文本内容	搜索
input_text	string	输入的文本内容
is_checked	int	是否选中 ：1 是，0 否	1
is_success	int	是否成功 ：1 是，0 否	1
medium_id	string	素材id	100031
medium_url	string	素材文件url	https://www.xxx.com/aaa.jpg
target_url	string	素材跳转目标url	https://www.xxx.com
extension	string	扩展信息	Json值
longitude	string	经度	30.17911
latitude	string	维度	120.560645
order_no	string	订单号	203010102020

其他关于埋点的文章：用户行为埋点采集方案架构概览-CSDN博客