# 预置属性与系统字段
预置属性指的是由 TA 生成或取得的属性，所有的预置属性以"#"开头，且都为事件属性，且这些属性的中文名以及意义都已经确定。系统字段指的是数据中的结构字段（如#account_id、#event_time等），或者数据库中具有特殊用途的字段，在分析模型中往往不会被使用，或者被间接使用。
除以下罗列的预置属性外，任何以"#"开头的属性都被视为非法字段，将无法入库，因此不建议您将自定义属性设置成以"#"开头，所有系统字段不能作为事件或用户属性，在数据接入时传入。
请注意，除了#ip之外的所有预置属性，不建议您直接使用，只有在同时使用客户端 SDK 与其他传输方式，需要让多端数据的属性一致时，才建议在 TA 工作人员的引导下进行设置。
- 预置属性
| 属性名 | 中文名 | 属性类型 | 说明 |
|---|---|---|---|
| #ip | 客户端 IP | 文本 | 用户的 IP 地址，TA 将以此获取用户的地理位置信息 |
| #country | 国家地区 | 文本 | 用户所在国家或地区，根据 IP 地址生成 |
| #country_code | 国家地区代码 | 文本 | 用户所在国家或地区的国家地区代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成 |
| #province | 省份 | 文本 | 用户所在省份，根据 IP 地址生成 |
| #city | 城市 | 文本 | 用户所在城市，根据 IP 地址生成 |
| #os_version | 操作系统版本 | 文本 | iOS 11.2.2、Android 8.0.0 等 |
| #manufacturer | 生产商 | 文本 | 用户设备的制造商，如 Apple，vivo 等 |
| #os | 操作系统 | 文本 | 如 Android、iOS 等 |
| #device_id | 设备 号 | 文本 | 用户的设备 ID，iOS 取用户的 IDFV 或 UUID，Android 取 androidID |
| #screen_height | 屏幕高度 | 数值 | 用户设备的屏幕高度，如 1920 等 |
| #screen_width | 屏幕宽度 | 数字 | 用户设备的屏幕宽度，如 1080 等 |
| #device_model | 设备型号 | 文本 | 用户设备的型号，如 iPhone 8 等 |
| #app_version | app 版本 | 文本 | 您的 APP 的版本 |
| #bundle_id | 应用包名 | 文本 | APP包名或者进程名 |
| #lib | SDK 类型 | 文本 | 您接入 SDK 的类型，如 Android，iOS 等 |
| #lib_version | SDK 版本 | 文本 | 您接入 SDK 的版本 |
| #network_type | 网络 类型 | 文本 | 事 件发生 时的网络状态，如 WIFI、3G、4G 等 |
| #carrier | 运营商 | 文本 | 用户设备的网络运营商，如中国移动，中国电信等 |
| #browser | 浏览器 | 文本 | 用户使用的浏览器类型，如 Chrome，Firefox 等 |
| #browser_version | 浏览器版本 | 文本 | 用户使用的浏览器的版本，如 Chrome 61.0，Firefox 57.0 等 |
| #duration | 事件时长 | 数值 | 使用计时功能记录的时长，单位是秒 |
| #url | 页面地址 | 文本 | 自动采集事件中使用，当前页面（非业务定义的页面）的地址。在web页面中取值为 location.href，Android / iOS 平台取值为自定义的页面路径 |
| #url_path | 页面路径 | 文本 | 自动采集事件中使用，当前页面（非业务定义的页面）的路径。取值为 location.pathname |
| #referrer | 前向地址 | 文本 | 自动采集事件中使用，跳转前页面（非业务定义的页面）的地址。在 web 页面中取值为 document.referrer，Android / iOS 平台取值为自定义的前项页面路径 |
| #referrer_host | 前向 域名 | 文本 | 自动采集事件中使用，跳转前页面（非业务定义的页面）的路径。取值为 referrer 的 host |
| #title | 页面标题 | 文本 | 自动采集事件中使用,当前页面（非业务定义的页面）的标题。在web页面中取值为document.title。Android 平台取值为 Activity 的标题，取值为 Activity 的 title 属性的值。iOS平台取值为 View Controller 的标题，取值为 controller.navigationItem.title 属性的值 |
| #screen_name | 页面名称 | 文本 | 自动采集事件中使用，页面（非业务定义的页面）的名称。Android 平台取值为 Activity 的包名.类名；iOS平台取值 View Controller 的类名 |
| #element_id | 元素 ID | 文本 | 自动采集事件中使用，控件的 ID |
| #element_type | 元素类型 | 文本 | 自动采集事件中使用，控件的类型 |
| #resume_from_background | 是否从后台唤醒 | 数值 | 自动采集事件中使用，应用是否从后台唤醒，布尔型 |
| #element_selector | 元素选择器 | 文本 | 自动采集事件中使用，控件的 viewPath |
| #element_position | 元素位置 | 文本 | 自动采集事件中使用，控件的位置信息 |
| #element_content | 元素内容 | 文本 | 自动采集事件中使用，控件上的内容 |
| #scene | 场景值 | 数值 | 微信小程序启动时传入的场景值 |
| #mp_platform | 小程序平台 | 文本 | 标识应用所在的平台 |
| #app_crashed_reason | 异常信息 | 文本 | 自动采集事件中使用，记录 APP 崩溃的堆栈信息 |
| #zone_offset | 时区偏移 | 数值 | 数据时间相对 UTC 时间的偏移小时数 |
| #system_language | 系统 默认 语言 | 文本 | 用户设备的系统语言(ISO 639-1，即两位小写英文字母)，如 zh, en 等 |
| #install_time | App 安装时间 | 时间 | 用户安装应用的时间，值来源于系统 |
| #simulator | 是否为模拟器 | 数值 | 设备是否是模拟器 true/false |
| #ram | 内存(GB) | 文本 | 用户设备的当前剩余内存和总内存，单位GB，如 1.4/2.4 |
| #disk | 硬盘(GB) | 文本 | 用户设备的当前剩余存储空间和总存储空间，单位GB，如 30/200 |
| #fps | FPS | 数值 | 用户设备的当前图像每秒传输帧率，如 60 |
| #backgrou n d_duration | 后台 停留时长 | 数值 | 记录两次start事件发生区间内，应用进入后台的时长，单位是秒 |
| #start_reason | 启动原因 | 文本 | 只有当应用被非launcher方式启动时存在该属性，如deeplink方式或者其他应用startActivity启动，数据样例："#start_reason":"{"url":"thinkingdata:\/\/","data":""}" |
- 事件表中的系统字段
| 字段名 | 中文名 | 属性类型 | 说明 |
|---|---|---|---|
| $part_event | 事件分区字段 | 文本 | 事件分区字段，取自 #event_name，即事件名 |
| $part_date | 日期分区字段 | 时间 | 日期分区字段，取自 #event_time ，也就是事件发生的日期 |
| #user_id | 用户唯一 ID | 数值 | 用户在系统中的唯一用户标识 |
| #account_id | 账户 ID | 文本 | 账户 ID，相当于数据中的 #account_id |
| #distinct_id | 访客 ID | 文本 | 访客 ID，相当于数据中的 #distinct_id |
| #event_name | 事件名称 | 文本 | 事件名称，相当于数据中的 #event_name 字段 |
| #event_time | 事件时间 | 时间 | 事件时间，相当于数据中的 #time 字段 |
| #server_time | 服务端时间 | 时间 | 服务端收到数据的时间 |
- 用户表中的系统字段
| 字段名 | 中文名 | 属性类型 | 说明 |
|---|---|---|---|
| #user_id | 用户唯一 ID | 数值 | 用户在系统中的唯一用户标识 |
| #account_id | 账户 ID | 文本 | 账户 ID，相当于数据中的 #account_id |
| #distinct_id | 访客 ID | 文本 | 访客 ID，相当于数据中的 #distinct_id |
| #active_time | 激活时间 | 时间 | 该用户的第一条数据（含事件和用户属性数据）入库时，该条数据 #time 字段的时间 |
| #reg_time | 注册时间 | 时间 | 该用户的第一条包含账户 ID 的数据（含事件和用户属性数据）入库时，该条数据 #time 字段的时间 |
| #update_time | 更新时间 | 时间 | 收到的最后一条用户属性数据的 #time 字段的时间 |
| #server_time | 服务端时间 | 时间 | 收到的最后一条用户属性数据的服务器时间 |