# App预置事件/属性
### **基础预置事件**
| 事件ID | 属性ID | 数据类型 | 事件显示名称 | 事件说明 |
| ------------ | --------------------- | ---- | --------- | ----------------------------------------------- |
| $startup | | | 启动 | APP启动 |
| | $is\_first\_time | 布尔 | 是否安装后首次访问 | 是否安装后首次访问 |
| | $is\_from\_background | 布尔 | 是否从后台唤醒 | 是否从后台唤醒恢复 |
| | $start\_source | 字符串 | 启动来源 | 标识APP的启动来源，e.g. 通过点击图标启动、点击通知、URL唤醒、3D touch等 |
| | $预制属性 | | | 其他预制通用属性 |
| $end | | | 关闭 | APP关闭 |
| | $duration | 数值 | 使用时长 | 从启动到关闭的使用时长
单位：毫秒
|
| | $预制属性 | | | 其他预制通用属性 |
| $pageview | | | 浏览页面 | 浏览APP/网站页面 |
| | $url | 字符串 | 页面URL(含参) | 页面完整路径 |
| | $title | 字符串 | 页面标题 | 页面标题 |
| | $referrer | 字符串 | 页面来源 | 页面来源（$referrer 字段在 App 中手动调用 pageview 接口，默认不采集） |
| | $预制属性 | | | 其他预制通用属性 |
| $user\_click | | | 点击元素 | 全埋点自动采集元素点击行为 |
| | $title | 字符串 | 页面标题 | 页面标题 |
| | $parent\_url | 字符串 | 父页面URL | 页面URL，为空则为顶级页(Andorid独有) |
| | $url | 字符串 | 页面URL | 页面URL |
| | $element\_path | 字符串 | 元素路径 | APP 为元素唯一标识；JS 为元素路径 |
| | $element\_id | 字符串 | 元素ID | 元素ID |
| | $element\_type | 字符串 | 元素类型 | 元素类型 |
| | $element\_position | 字符串 | 列表控件位置 | 列表控件位置 （可选） |
| | $element\_content | 字符串 | 元素内容 | 元素的内容优先级：内容>描述>空 |
| | $预制属性 | | | 其他预制通用属性 |
| $app\_click | | | App点击 | App热图点击事件（用于热图分析） |
| | $page\_width | 数值 | 页面宽度 | 热图页面宽度 |
| | $page\_height | 数值 | 页面高度 | 热图页面高度 |
| | $screen\_dpi | 数值 | 屏幕DPI | Android独有 |
| | $screen\_scale | 数值 | 屏幕缩放比 | Android独有 |
| | $click\_x | 数值 | 点击X坐标 | 热图点击X坐标 |
| | $click\_y | 数值 | 点击Y坐标 | 热图点击Y坐标 |
| | $url | 字符串 | 页面URL | 点击热图时页面URL |
| | $element\_x | 数值 | 元素X坐标 | 点击元素X坐标 |
| | $element\_y | 数值 | 元素Y坐标 | 点击元素Y坐标 |
| | $element\_path | 字符串 | 元素路径 | 热图元素路径 |
| | $element\_type | 字符串 | 元素类型 | 热图元素类型 |
| | $element\_content | 字符串 | 元素内容 | 热图元素的内容 |
| | $element\_clickable | 数值 | 是否可以点击元素 | 是否可以点击元素 |
| | $预制属性 | | | 其他预制通用属性 |
| $app\_crash | | | APP崩溃 | APP崩溃信息 |
| | $crash\_data | 字符串 | 崩溃原因 | 崩溃的堆栈信息 |
| $alias | | | | |
| | $original\_id | 字符串 | 匿名ID | 实名绑定前的匿名ID |
### 预置事件通用属性
| 属性ID | 属性显示名称 | 数据类型 | 属性说明 |
| --------------------- | ---------- | ---- | ---------------------------------------------------------- |
| $platform | 平台 | 字符串 | 应用平台，枚举取值：JS/iOS/Android/Wechat |
| $app\_version | 应用版本 | 字符串 | 应用版本，e.g. V1.0 |
| $manufacturer | 设备制造商 | 字符串 | 制造厂商， e.g. 小米 |
| $brand | 设备品牌 | 字符串 | 设备品牌，e.g. 华为荣耀 |
| $model | 设备型号 | 字符串 | 设备型号，e.g. iPhone8、小米4 |
| $os | 操作系统 | 字符串 | 操作系统，e.g.Window、MacOS |
| $os\_version | 操作系统版本 | 字符串 | 操作系统版本，e.g.Windows 10 |
| $browser | 浏览器 | 字符串 | 浏览器名称，e.g. Chrome |
| $browser\_version | 浏览器版本 | 字符串 | 浏览器版本，e.g. Chrome 62.23.23 |
| $network | 网络类型 | 字符串 | 网络类型，e.g. WIFI、2G、3G、4G |
| $carrier\_name | 运营商 | 字符串 | 接入运营商名称，e.g. 中国联通 |
| $screen\_width | 屏幕宽度 | 数值 | 屏幕宽度/屏幕分辨率，e.g. 1920 |
| $screen\_height | 屏幕高度 | 数值 | 屏幕高度/屏幕分辨率，e.g. 768 |
| $is\_login | 是否是注册用户 | 布尔 | 是否是注册用户 |
| $ip | IP | 字符串 | 收数服务会自动记录上报的数据来源 IP，根据 IP 解析为国家、省份、城市三个字段
|
| $country | 国家 | 字符串 | 默认根据用户IP解析获取,或用户手动上传覆盖 |
| $province | 省份 | 字符串 | 默认根据用户IP解析获取,或用户手动上传覆盖 |
| $city | 城市 | 字符串 | 默认根据用户IP解析获取,或用户手动上传覆盖 |
| $utm\_campaign\_id | 活动ID | 字符串 | 根据添加的内容自动生成，
标识一次活动
|
| $utm\_campaign | 活动/广告名称 | 字符串 | 特定的推广活动，e.g. 双11推广 |
| $utm\_medium | 活动/广告媒介 | 字符串 | 推广类型，e.g. SEM，cpc |
| $utm\_source | 活动/广告来源 | 字符串 | 推广来源，e.g. 今日头条 |
| $utm\_content | 活动/广告内容 | 字符串 | 广告内容，e.g. 优惠信息 |
| $utm\_term | 活动/广告关键字 | 字符串 | 广告关键字，e.g. 用户画像 |
| $is\_first\_day | 是否安装后首日访问 | 布尔 | 是否安装后首日访问 |
| $channel | 下载渠道 | 字符串 | 下载渠道，SDK 初始化时传入。仅 Android 通过渠道包分发时才有意义，iOS 会统一为“App Store” |
| $lib | SDK类型 | 字符串 | SDK类型，e.g. python、iOS等 |
| $lib\_version | SDK版本 | 字符串 | SDK版本， e.g. ：11.2.5 |
| $session\_id | SessionID | 字符串 | 会话ID，e.g. 515950b8f1a6221c |
| $language | 语言 | 字符串 | 系统语言，e.g. zh-cn |
| $time\_zone | 用户时区 | 字符串 | 用户时区，e.g.GMT+08:00 |
| $web\_crawler | 是否是爬虫 | 布尔 | 爬虫识别 |
| $is\_time\_calibrated | 是否与服务端时间校准 | 布尔 | 是否与服务端时间校准 |
| $device\_id | 设备ID | 字符串 | 设备ID，idfa/oaid > idfv/androidid > uuid |
| $debug | Debug模式 | 数值 | 标识数据处理方式，0：非debug 1：debug，不入库 2：debug，入库 |
### **预置用户通用属性**
| 属性ID | 属性名称 | 属性值数据类型 | 属性说明 |
| ----------------------- | ---------- | ------- | ----------------------- |
| $original\_id | 匿名ID | 字符串 | 实名绑定前的匿名ID |
| $idfv | IDFV | 字符串 | IDFV（iOS独有） |
| $idfa | IDFA | 字符串 | IDFA（iOS独有） |
| $mac | MAC | 字符串 | MAC（Andorid独有） |
| $imei | IMEI | 字符串 | IMEI（Andorid独有） |
| $phone | 手机号 | 字符串 | 非自动采集，需要用户上传 |
| $email | 邮箱 | 字符串 | 非自动采集，需要用户上传 |
| $platform | 最后一次使用平台 | 字符串 | 最后一次使用平台 |
| $lib | 最新版本的SDK类型 | 字符串 | SDK类型，e.g. python、iOS等 |
| $lib\_version | 最新版本的SDK版本 | 字符串 | SDK版本，e.g. 11.2.5 |
| $country | 所在国家 | 字符串 | 默认根据用户IP解析获取,或用户手动上传覆盖 |
| $province | 所在省份 | 字符串 | 默认根据用户IP解析获取,或用户手动上传覆盖 |
| $city | 所在城市 | 字符串 | 默认根据用户IP解析获取,或用户手动上传覆盖 |
| $is\_login | 是否是注册帐号 | 布尔值 | 是否是调用过alias接口 |
| $signup\_time | 注册时间 | 日期时间 | 注册时间 |
| $first\_visit\_time | 首次访问时间 | 日期时间 | 首次访问时间 |
| $first\_visit\_language | 语言 | 字符串 | 设备语言 |
| $time\_zone | 首次访问时区 | 字符串 | GMT+08:00 |