预置事件和属性
为了帮助开发者更快速的集成SDK,了解采集哪些用户行为和属性,我们预置了一些事件、事件属性和用户属性。
说明
部分默认自动采集,Android、iOS、JS 和 小程序端略有差异;
非默认采集的字段,如有需要,可以直接使用预置字段作为事件 ID、属性 ID 进行上报,以便数据集成时,能够自动生成预置看板。
以下表格中涉及标识为 Y/N/- 的含义
事件
- Y 表示相应平台默认自动采集
- N 表示相应平台不默认采集
- S 表示由服务端处理
- - 表示相应平台不支持采集该事件
属性
- Y 表示采集事件后相应属性可以自动获取,无需额外配置
- N 表示需要额外配置才能有值
- S 表示由服务端根据相应规则自动处理
- - 表示相应平台不支持该属性
除了预置的事件和属性ID会以$开头,其他自定义的事件ID和属性ID,须注意命名方式:仅支持字母、数字和下划线,不能以数字或下划线开头,上限125个半角字符。
基础预置事件会默认加入到方舟埋点方案
启动、关闭、浏览页面事件会在集成了基础 SDK 后会自动采集;
$app_click、$web_click 用于记录点击网页/APP页面,用于分析点击位置热图、点击元素热图,集成 SDK 时设置参数autoHeatmap 设置为 true ;
$webstay 用于记录用户停留在可视区域,分析浏览深度线,集成 SDK 时设置参数 autoWebstay 为 true;
$user_click 用于采集用户点击元素的事件,集成 SDK 时开启全埋点功能,即设置参数 autoTrack 为 true
对于用不到的事件可以选择不用,比如集成的平台中没有小程序时,可以不用 $share;没有 APP 时,可以不用 $app_crash
事件ID | 事件显示名称 | 事件说明 | Android | iOS | JS | 小程序 |
$startup | 启动 | APP启动 / 打开网站 | Y | Y | Y | Y |
$end | 关闭 | APP关闭 | Y | Y | - | - |
$pageview | 浏览页面 | 浏览APP/网站页面 | Y | Y | Y | Y |
$user_click | 点击元素 | 全埋点自动采集元素点击行为 | N | N | N | N |
$app_click | App点击 | App热图点击事件(用于热图分析) | N | N | - | - |
$web_click | Web点击 | Web热图点击事件(用于热图分析) | - | - | N | - |
$webstay | 视区停留 | 停留在可视区域(用于分析网页浏览深度) | - | - | N | - |
$share | 小程序分享 | 点击小程序分享按钮 | - | - | - | N |
$app_crash | APP崩溃 | APP崩溃信息 | N | N | - | - |
在首次创建 APP 推广监测成功后,系统会自动将 APP 推广监测相关事件添加在埋点方案中
无需在 SDK 中进行特殊设置,用户点击来推广链接激活后会自动上报数据
事件ID | 事件显示名称 | 事件说明 | Android | iOS | JS | 小程序 |
$campaign_track | APP推广监测 | APP扫描监测扫描二维码时上报 | S | S | - | - |
$first_installation | 首次安装激活 | APP扫描监测扫描二维码后首次打开APP会时上报激活事件 | S | S | - | - |
在服务集成配置中配置消息通知推送通道后,系统会自动将这 3 个事件添加到埋点方案中
事件ID | 事件显示名称 | 事件说明 | Android | iOS | JS | 小程序 |
$push_receiver_success | 消息推送成功 | 设备收到推送消息时触发 | N | N | - | - |
$push_click | 点击推送消息 | 设备点击了推送消息时触发 | N | N | - | - |
$push_process_success | 成功处理push消息 | 成功处理push消息 | N | N | - | - |
事件ID | 事件显示名称 | 事件说明 | Android | iOS | JS | 小程序 |
$alias | 绑定用户实名信息 | 用户实名认证 | S | S | S | S |
$alias 事件之外的Profile 系列的事件用于上报用户属性,所以同样不会作为单独的事件去分析,即不会出现在分析模型中事件的选项中,也不会计入任意事件的计算。
事件ID | 事件说明 | Android | iOS | JS | 小程序 |
$alias | 用户实名认证 | N | N | N | N |
$profile_set | 设置用户信息,覆盖写 | N | N | N | N |
$profile_set_once | 设置用户信息,有则不进行任何操作 | Y | Y | Y | Y |
$profile_increment | 增加或减少用户信息中的数字类型的属性 | N | N | N | N |
$profile_delete | 删除用户信息 | N | N | N | N |
$profile_append | 数组属性添加值 | N | N | N | N |
$profile_unset | 设置用户信息中的某个属性为空 | N | N | N | N |
除了上述预置事件之外,更多业务相关的事件,需要自定义埋点上报。
事件属性描述事件发生的方式和内容,是分析过程中的维度,也可以用于条件过滤。
- 事件通用属性:所有事件共同拥有的属性,e.g. 平台、应用版本、操作系统等;
- 事件自有属性:某个事件独有的事件属性,e.g. 浏览页面事件 $pageview 会有 $url、$title 等属性。
属性ID | 属性显示名称 | 数据类型 | 属性说明 | Android | iOS | JS | 小程序 |
$platform | 平台 | 字符串 | 应用平台,枚举取值:JS/iOS/Android/Wechat | Y | Y | Y | Y |
$app_version | 应用版本 | 字符串 | 应用版本,e.g. V1.0 | Y | Y | - | - |
$device_type | 设备类型 | 字符串 | 设备类型,e.g. PC、移动设备 | S | S | S | S |
$manufacturer | 设备制造商 | 字符串 | 制造厂商, e.g. 小米 | Y | Y | - | - |
$brand | 设备品牌 | 字符串 | 设备品牌,e.g. 华为荣耀 | Y | Y | S | Y |
$model | 设备型号 | 字符串 | 设备型号,e.g. iPhone8、小米4 | Y | Y | S | Y |
$os | 操作系统 | 字符串 | 操作系统,e.g.Window、MacOS | Y | Y | S | Y |
$os_version | 操作系统版本 | 字符串 | 操作系统版本,e.g.Windows 10 | Y | Y | S | Y |
$browser | 浏览器 | 字符串 | 浏览器名称,e.g. Chrome | - | - | S | Y |
$browser_version | 浏览器版本 | 字符串 | 浏览器版本,e.g. Chrome 62.23.23 | - | - | S | Y |
$network | 网络类型 | 字符串 | 网络类型,e.g. WIFI、2G、3G、4G | Y | Y | - | Y |
$carrier_name | 运营商 | 字符串 | 接入运营商名称,e.g. 中国联通 | Y | Y | - | - |
$screen_width | 屏幕宽度 | 数值 | 屏幕宽度/屏幕分辨率,e.g. 1920 | Y | Y | Y | Y |
$screen_height | 屏幕高度 | 数值 | 屏幕高度/屏幕分辨率,e.g. 768 | Y | Y | Y | Y |
$is_login | 是否是注册用户 | 布尔 | 是否是注册用户 | Y | Y | Y | Y |
$ip | IP | 字符串 | IP地址 | S | S | S | S |
$country | 国家 | 字符串 | 事件发生时所在国家, e.g. 中国、美国 | S | S | S | S |
$province | 省份 | 字符串 | 事件发生时所在省份, e.g. 北京、上海、福建 | S | S | S | S |
$city | 城市 | 字符串 | 事件发生时所在城市, e.g. 北京、厦门 | S | S | S | S |
$utm_campaign_id | 活动ID | 字符串 | 根据添加的内容自动生成, 标识一次活动 | Y | Y | Y | Y |
$utm_campaign | 活动/广告名称 | 字符串 | 特定的推广活动,e.g. 双11推广 | Y | Y | Y | Y |
$utm_medium | 活动/广告媒介 | 字符串 | 推广类型,e.g. SEM,cpc | Y | Y | Y | Y |
$utm_source | 活动/广告来源 | 字符串 | 推广来源,e.g. 今日头条 | Y | Y | Y | Y |
$utm_content | 活动/广告内容 | 字符串 | 广告内容,e.g. 优惠信息 | Y | Y | Y | Y |
$utm_term | 活动/广告关键字 | 字符串 | 广告关键字,e.g. 用户画像 | Y | Y | Y | Y |
$is_first_day | 是否安装后首日访问 | 布尔 | 是否安装后首日访问 | Y | Y | Y | Y |
$channel | 下载渠道 | 字符串 | 下载渠道,SDK 初始化时传入。仅 Android 通过渠道包分发时才有意义,iOS 会统一为“App Store” | Y | Y | - | - |
$lib | SDK类型 | 字符串 | SDK类型,e.g. python、iOS等 | Y | Y | Y | Y |
$lib_version | SDK版本 | 字符串 | SDK版本, e.g. :11.2.5 | Y | Y | Y | Y |
$session_id | SessionID | 字符串 | 会话ID,e.g. 515950b8f1a6221c | Y | Y | Y | Y |
$language | 语言 | 字符串 | 系统语言,e.g. zh-cn | Y | Y | Y | Y |
$time_zone | 用户时区 | 字符串 | 用户时区,e.g.GMT+08:00 | Y | Y | Y | Y |
$user_agent | UA | 字符串 | UA | - | - | Y | - |
$web_crawler | 是否是爬虫 | 布尔 | 爬虫识别 | - | - | Y | - |
$is_time_calibrated | 是否与服务端时间校准 | 布尔 | 是否与服务端时间校准 | N | N | - | N |
$device_id | 设备ID | 字符串 | 设备ID,idfa/oaid > idfv/androidid > uuid | N | N | - | - |
xwho | 用户ID | 字符串 | 用户ID | Y | Y | Y | Y |
xwhen | 触发时间 | 日期 | 事件发生的时间 | Y | Y | Y | Y |
distinct_id | 唯一ID | 字符串 | 系统在 xwho 的基础上根据一些规则生成的唯一 IDS | S | S | S | S |
$importflag | 是否工具导入 | 数值 | 标识是否是工具导入,1为工具导入 | N | N | N | N |
$debug | Debug模式 | 数值 | 标识数据处理方式,0:非debug 1:debug,不入库 2:debug,入库 | Y | Y | Y | Y |
非自动采集的属性,会根据相应字段自动解析
$ip :方舟的收数服务会自动记录上报的数据来源 IP,根据 IP 解析为国家、省份、城市三个字段
$county:通过 IP 解析
$province:通过 IP 解析
$city :通过 IP 解析
$device_type:通过 UA 解析
部分自动采集的属性不会作为独立的属性用于分析
$debug:用于标识是否入库
- 0:表示关闭 Debug 模式
- 1:表示打开 Debug 模式,但该模式 下发送的数据仅用于调试,不计入平台数据统计
- 2:表示打开 Debug 模式,该模式下发送的数据可计入平台数据统计
$session_id:标识一次会话
$user_agent:UA,用于解析设备类型、浏览器、浏览器版本、操作系统、操作系统版本
$device_id:系统唯一标识,默认不采集(4.4.5版本新增)
Andorid 采集规则:advertising id > android id > uuid,按照先后顺序获取
iOS 采集规则:idfa>idfv>uuid,按照先后顺序获取
部分预置事件在通用属性之外,还有自身独有的属性
集成基础 SDK 后自动采集
属性ID | 属性显示名称 | 数据类型 | 属性说明 | Android | iOS | JS | 小程序 |
$is_first_time | 是否安装后首次访问 | 布尔 | 是否安装后首次访问 | Y | Y | Y | Y |
$is_from_background | 是否从后台唤醒 | 布尔 | 是否从后台唤醒恢复 | Y | Y | - | - |
$start_source | 启动来源 | 字符串 | 标识APP的启动来源,e.g. 通过点击图标启动、点击通知、URL唤醒、3D touch等 | N | N | - | - |
$scene | 场景值 | 字符串 | 标识小程序的场景值,e.g 顶部搜索框的搜索结果页 | - | - | - | Y |
$scene_type | 场景值类型 | 字符串 | 标识小程序场景值类型 | - | - | - | S |
集成基础 SDK 后自动采集
属性ID | 属性显示名称 | 数据类型 | 属性说明 | Android | iOS | JS | 小程序 |
$duration | 使用时长 | 数值 | 从启动到关闭的使用时长
单位:毫秒 | Y | Y | - | - |
集成基础 SDK 后自动采集
属性ID | 属性显示名称 | 数据类型 | 属性说明 | Android | iOS | JS | 小程序 |
$url | 页面URL(含参) | 字符串 | 页面完整路径 | Y | Y | Y | Y |
$url_domain | 页面URL | 字符串 | 去参的页面URL | - | - | S | - |
$title | 页面标题 | 字符串 | 页面标题 | Y | Y | Y | - |
$referrer | 页面来源 | 字符串 | 页面来源 | Y | Y | Y | Y |
$referrer_domain | 页面来源域名 | 字符串 | 页面来源域名 | - | - | Y | - |
$traffic_source_type | 流量来源类型 | 字符串 | 流量来源类型,数据处理 | - | - | S | - |
$search_engine | 搜索引擎 | 字符串 |