# 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 |
- 产品简介
- 快速上手
- Step 1 安装部署
- Step 2 激活系统创建项目
- Step 3 开启您的分析旅程
- 1. 集成 SDK
- 2. 可视化埋点
- 3. 创建分析模型
- 附:埋点方案设计
- 附:数据分析思路
- 产品更新日志
- V5.5 新增LTV分析功能等
- V5.3 UI 升级、分布分析重构、维度表动态更新、细节优化等
- V5.2 新增归因分析、消息中心、重构埋点方案、优化看数据体验……
- V5.1.0317 体验优化& Bug修复
- V5.1 升级可视化埋点、增强权限控制……
- Part I 产品功能说明
- 名词解释
- 指标说明
- 看板
- 5.3.3 看板 UI 重构
- 分析
- 事件分析
- 渠道分析
- 渠道相关名词解释
- 来源识别规则
- 搜索引擎
- 社交媒体
- 小程序场景值
- Session 分析
- Session 规则
- 实时分析
- 留存分析
- 转化漏斗
- 智能路径
- 归因分析
- 热图分析
- Web/H5 热图
- APP 热图
- 分布分析
- 间隔分析
- 属性分析
- LTV 分析
- 多主体分析
- 自定义查询
- 用户
- 用户分群
- 用户探查
- 用户标签
- 标签体系应用概览
- 标签体系
- 标签生命周期管理
- 标签加工
- 如何自定义SQL创建标签
- 单用户档案
- 运营
- 广告跟踪
- 微信小程序渠道追踪
- 预置广告媒介和渠道
- App 推广监测(Beta版本)
- 电子邮件(即将下线)
- 短信(即将下线)
- 消息通知(即将下线)
- 项目管理
- 项目概览
- 项目角色管理
- 项目成员管理
- 数据接入管理
- 埋点方案
- 可视化埋点
- 集成SDK接入数据
- 数据验证
- 用户数据导入
- 微信小程序全埋点事件定义
- 元数据管理
- 元事件
- 虚拟事件
- 事件属性
- 用户属性
- Session 管理
- 页面组管理
- 维度表
- 服务集成配置
- 监控告警
- 智能监控
- 自定义监控
- 平台管理
- 企业概览
- 项目管理
- 成员管理
- 安全设置
- 企业设置
- 日志管理
- 帐号设置
- Part II 技术文档
- 技术接入准备工作
- 部署环境检测工具
- 数据模型
- 数据格式
- 预置事件和属性
- App预置事件/属性
- JS 预置事件/属性
- 如何准确识别用户
- 如何设计埋点方案
- 分平台上报数据 vs 跨平台打通
- SDK 指南
- Android SDK
- 快速集成
- 全埋点模块
- 消息推送模块
- Android Hybrid模式
- SDK Gradle集成方式
- 多渠道打包
- 易观小工具
- 合规相关
- iOS SDK
- 快速集成
- 全埋点介绍
- iOS Hybrid模式
- 消息推送模块
- JS SDK
- 快速集成
- JS SDK基础版
- JS SDK插件
- uni-app SDK
- 快速集成
- 打包原生APP
- 开启移动端全埋点
- uni-app SDK标准版
- 微信小程序 SDK
- 快速集成
- 微信小程序标准版
- 微信小程序插件版
- 微信小程序通用框架版
- 支付宝小程序 SDK
- 支付宝小程序标准版
- 支付宝小程序通用框架版
- 字节跳动小程序 SDK
- 字节跳动小程序标准版
- 字节跳动小程序通用框架版
- 百度小程序 SDK
- 百度小程序标准版
- 百度小程序通用框架版
- 钉钉小程序 SDK
- 钉钉小程序标准版
- 钉钉小程序通用框架版
- QQ小程序 SDK
- QQ小程序标准版
- QQ小程序通用框架版
- 快应用 SDK
- 华为WeCode小程序
- WeCode SDK 标准版
- WeCode SDK插件
- PhoneGap SDK
- mPaaS SDK
- ReactNative SDK
- Flutter SDK
- Java SDK
- Python SDK
- PHP SDK
- C++ SDK
- C# SDK
- Node JS SDK
- Lua SDK
- Golang SDK
- SDK FAQ
- identify与alias的区别
- 爬虫数据如何识别?
- 页面停留如何获取时间?
- 如果获取SDK及更新日志
- 代码埋点和无埋点有什么区别
- Web页面中发现丢失某一个事件
- 自研 SDK 注意事项
- 页面时长统计功能
- 飞书小程序 SDK
- 飞书小程序标准版
- 飞书小程序通用框架版
- Unreal Engine SDK
- 数据验证
- 客户端埋点验证
- Debug 数据验证
- 数据入库验证
- 数据导入
- 接口导入
- JAVA工具包
- 标准json文件导入
- csv格式导入
- 数据导入FAQ
- 数据导出
- JAVA工具包
- 事件数据导出
- 用户数据导出
- 直接从Kafka中消费数据
- 使用程序访问数据库
- 脚本工具
- API
- 分析API
- 事件分析
- 留存分析
- 自定义查询
- 转化漏斗
- 属性分析
- Session分析
- 渠道分析
- 分布分析
- 用户API
- 分群查询
- 用户档案
- 分群管理
- 管理API
- 权限管理
- 元数据管理
- 埋点方案管理
- 维度表管理
- 运营API
- 广告跟踪
- APP推广监测
- 平台管理API
- 项目管理
- 成员管理
- 第三方登录
- OAuth2.0登录
- LDAP登录
- GDPR 合规
- Part III 常见问题
- License 许可
- 产品试用及采购
- 参与贡献