App SDK
App启动
事件ID:$AppStart
事件显示名:App启动
触发条件:启动App或从后台切换进入App时触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$is_first_time | 是否首次触发 | 表示是否是首次启动App | BOOL |
$resume_from_background | 是否从后台唤醒 | 是否从后台唤醒 | BOOL |
$screen_name | 页面名称 | Activity的包名.类名(仅Android端有) | STRING |
$title | 页面标题 | Activity的标题(仅Android端有) | STRING |
App退出
事件ID:$AppEnd
事件显示名:App退出
触发条件:退出App或App进入后台时触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$event_duration | 停留时长 | 表示单次从启动到关闭的时长,单位为秒 | NUMBER |
$screen_name | 页面名称 | Activity的包名.类名(仅Android端有) | STRING |
$title | 页面标题 | Activity的标题(仅Android端有) | STRING |
App浏览页面
事件ID:$AppViewScreen
事件显示名:App浏览页面
触发条件:打开一个Activity/ViewController页面时触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$screen_name | 页面名称 | Activity的包名.类名(仅Android端有) | STRING |
$title | 页面标题 | Activity的标题(仅Android端有) | STRING |
$url | 页面地址 | 自动采集 | STRING |
$referrer | 前向地址 | 自动采集 | STRING |
注意事项
对于Android Fragment默认不会触发,如需采集,需要单独开启
App元素点击
事件ID:$AppClick
事件显示名:App元素点击
触发条件:点击控件时触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$screen_name | 页面名称 | Activity的包名.类名(仅Android端有) | STRING |
$title | 页面标题 | Activity的标题(仅Android端有) | STRING |
$element_position | 元素位置 | 元素在模块中的位置 | STRING |
$element_id | 元素ID | Android端默认获取,iOS端需手动设置 | STRING |
$element_content | 元素内容 | 控件代码中设置的元素内容 | STRING |
$element_type | 元素类型 | 控件的类型 | STRING |
$element_selector | 元素选择器 | 记录一个按钮在App中的位置 | STRING |
$element_path | 元素路径 | 需要手动开启 | STRING |
控件示例
Android端:CheckBox、RadioButton、button、SwitchCompat、Spinner、TextView、ImageView、ImageButton、SeekBar、RatingBar、RadioGroup、MenuItem、ExpandableListView、Dialog、ListView、GridView、TabHost等
iOS端:UIButton、UIBarButtonItem、UISwitch、UISlider、UISegment、UIPageControl、UIStepper、UILabel+手势、UIImageView+手势、UIAlertController、UIMenu等
App激活
事件ID:$AppInstall
事件显示名:App激活
触发条件:App 安装后首次打开触发,第二次打开不会再触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$browser | 浏览器名 | STRING | |
$utm_source | 广告系列来源 | STRING | |
$utm_medium | 广告系列媒介 | STRING | |
$utm_term | 广告系列字词 | STRING | |
$utm_content | 广告系列内容 | STRING | |
$utm_campaign | 广告系列名称 | STRING | |
$ios_install_source | STRING | ||
$utm_matching_type | 渠道追踪匹配模式 | STRING | |
$matched_key | 渠道匹配关键词 | STRING | |
$matching_key_list | 渠道匹配关键词列表 | STRING | |
$channel_active_period_day | 有效激活窗口期 | NUMBER | |
$channel_attribute_period_hour | 激活归因窗口期 | NUMBER |
注意事项
需要调用 trackInstallation / trackAppInstall 接口采集此事件
App崩溃
事件ID:$AppCrashed
事件显示名:App崩溃
触发条件:App崩溃时采集
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$app_crashed_reason | 崩溃原因 | STRING |
注意事项
只有在开启崩溃采集时才会采集
App被动启动
事件ID:$AppStartPassively
事件显示名:App被动启动
触发条件:iOS 端App被系统调起
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$app_state | App状态 | iOS端默认获取,Android端不会获取 | STRING |
$resume_from_background | 是否从后台唤醒 | 是否从后台唤醒 | BOOL |
$is_first_time | 是否首次触发 | 表示是否是首次启动 App | BOOL |
注意事项
iOS端App有此事件,Android端无此事件
远程控制配置变化
事件ID:$AppRemoteConfigChanged
事件显示名:远程控制配置变化
触发条件:SDK获取到远程配置触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$app_remote_config | 远程控制配置信息 | SDK 加载配置生效后,采集该事件 | STRING |
深度链接唤醒App
事件ID:$AppDeepLinkLaunch
事件显示名:深度链接唤醒App
触发条件:App被DeepLink唤醒时触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$deeplink_url | 深度链接地址 | 唤醒 App 的 DeepLink 链接 | STRING |
$utm_source | 广告系列来源 | STRING | |
$utm_medium | 广告系列媒介 | STRING | |
$utm_term | 广告系列字词 | STRING | |
$utm_content | 广告系列内容 | STRING | |
$utm_campaign | 广告系列名称 | STRING | |
$latest_utm_source | 最近一次广告系列来源 | STRING | |
$latest_utm_medium | 最近一次广告系列媒介 | STRING | |
$latest_utm_term | 最近一次广告系列字词 | STRING | |
$latest_utm_content | 最近一次广告系列内容 | STRING | |
$latest_utm_campaign | 最近一次广告系列名称 | STRING |
深度链接匹配结果
事件ID:$AppDeeplinkMatchedResult
事件显示名:深度链接匹配结果
触发条件:SDK解析完成DeepLink的配置时触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$deeplink_url | 深度链接地址 | 唤醒 App 的 DeepLink 链接 | STRING |
$utm_source | 广告系列来源 | STRING | |
$utm_medium | 广告系列媒介 | STRING | |
$utm_term | 广告系列字词 | STRING | |
$utm_content | 广告系列内容 | STRING | |
$utm_campaign | 广告系列名称 | STRING | |
$event_duration | 事件时长 | STRING | |
$deeplink_options | 深度链接参数 | 网页端配置的深度链接参数 | STRING |
$deeplink_match_fail_reason | 深度链接匹配失败原因 | STRING |
App推送点击
事件ID:$AppPushClick
事件显示名:App推送点击
触发条件:推送被点击时触发
携带属性
属性ID | 属性显示名 | 属性说明 | 数据类型 |
---|---|---|---|
$app_push_msg_title | 推送消息标题 | STRING | |
$app_push_msg_content | 推送消息内容 | STRING | |
$app_push_service_name | 第三方推送服务商 | STRING | |
$app_push_channel | App推送通道 | STRING |
所有事件都有的预置属性
属性名 | 属性显示名 | 说明 | 数据类型 |
---|---|---|---|
$app_id | 应用唯一标识 | App 的唯一标识 | STRING |
$app_name | 应用名称 | 应用的名称 | STRING |
$app_version | 应用版本 | APP 的应用版本 | STRING |
$lib | SDK类型 | SDK 类型,比如 Android/iOS | STRING |
$lib_version | SDK版本 | SDK 版本 | STRING |
$manufacturer | 设备制造商 | 设备制造商 | STRING |
$brand | 设备品牌 | 设备品牌 | STRING |
$model | 设备型号 | 设备型号 | STRING |
$os | 操作系统 | 操作系统 | STRING |
$os_version | 操作系统版本 | 操作系统版本 | STRING |
$referrer_title | 前向页面标题 | 前一个页面标题 | STRING |
$screen_height | 屏幕高度 | 屏幕高度 | NUMBER |
$screen_width | 屏幕宽度 | 屏幕宽度 | NUMBER |
$wifi | 是否 WiFi | 事件触发时是否为 WiFi | BOOL |
$carrier | 运营商名称 | 事件触发时设备 SIM 卡的运营商名称 | STRING |
$network_type | 网络类型 | 事件触发时的网络类型 | STRING |
$timezone_offset | 时区偏移量 | App 或系统的时区 | NUMBER |
$is_first_day | 是否首日访问 | 是否是首日触发 | BOOL |
$is_login_id | 是否登录 ID | 数据入库时判断添加 | BOOL |
$ip | IP | 后端通过解析 HTTP 请求而得到 | STRING |
$country | 国家 | 由 IP 解析得到 | STRING |
$province | 省份 | 由 IP 解析得到 | STRING |
$city | 城市 | 由 IP 解析得到 | STRING |
$device_id | 设备ID | Android 端主要取 Android ID ,iOS 端尝试获取 IDFA | STRING |
$screen_orientation | 屏幕方向 | 只有在开启 enableTrackScreenOrientation: 时才会采集 | STRING |
$latitude | GPS信息 | 纬度*106 只有在开启 enableTrackGPSLocation: 时才会采集 |
NUMBER |
$longitude | GPS信息 | 经度*106 只有在开启 enableTrackGPSLocation: 时才会采集 |
NUMBER |
$geo_coordinate_system | 坐标系 | 只有在开启 enableTrackGPSLocation: 时才会采集 | STRING |
预置用户属性
属性名 | 属性显示名 | 说明 | 数据类型 |
---|---|---|---|
$first_visit_time | 首次访问时间 | 新用户首次启动App, 会给此属性赋值 | DATETIME |
$utm_source | 首次广告系列来源 | STRING | |
$utm_medium | 首次广告系列媒介 | STRING | |
$utm_term | 首次广告系列字词 | STRING | |
$utm_content | 首次广告系列内容 | STRING | |
$utm_campaign | 首次广告系列名称 | STRING | |
$utm_matching_type | 渠道追踪匹配模式 | STRING | |
$matched_key | 渠道匹配关键字 | STRING | |
$matching_key_list | 渠道匹配关键字列表 | 渠道匹配关键字列表 | STRING |