> For the complete documentation index, see [llms.txt](https://arkdocs.analysys.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arkdocs.analysys.cn/integration/prepare/default-data/app-default.md).

# App预置事件/属性

### **基础预置事件**

| 事件ID         | 属性ID                  | 数据类型 | 事件显示名称    | 事件说明                                            |
| ------------ | --------------------- | ---- | --------- | ----------------------------------------------- |
| $startup     |                       |      | 启动        | APP启动                                           |
|              | $is\_first\_time      | 布尔   | 是否安装后首次访问 | 是否安装后首次访问                                       |
|              | $is\_from\_background | 布尔   | 是否从后台唤醒   | 是否从后台唤醒恢复                                       |
|              | $start\_source        | 字符串  | 启动来源      | 标识APP的启动来源，e.g. 通过点击图标启动、点击通知、URL唤醒、3D touch等   |
|              | $预制属性                 |      |           | 其他预制通用属性                                        |
| $end         |                       |      | 关闭        | APP关闭                                           |
|              | $duration             | 数值   | 使用时长      | <p>从启动到关闭的使用时长<br>单位：毫秒</p>                     |
|              | $预制属性                 |      |           | 其他预制通用属性                                        |
| $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         | 字符串  | <p></p><p>收数服务会自动记录上报的数据来源 IP，根据 IP 解析为国家、省份、城市三个字段</p>    |
| $country              | 国家         | 字符串  | 默认根据用户IP解析获取,或用户手动上传覆盖                                     |
| $province             | 省份         | 字符串  | 默认根据用户IP解析获取,或用户手动上传覆盖                                     |
| $city                 | 城市         | 字符串  | 默认根据用户IP解析获取,或用户手动上传覆盖                                     |
| $utm\_campaign\_id    | 活动ID       | 字符串  | <p>根据添加的内容自动生成，</p><p>标识一次活动</p>                           |
| $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               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://arkdocs.analysys.cn/integration/prepare/default-data/app-default.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.