menu
Is this helpful?

# 预置属性与系统字段

提示

本节将会介绍TE中所有的的预置属性以及系统字段,具体平台的预置属性可以参考:

Android平台iOS平台Web平台小程序&小游戏平台服务端

预置属性指的是由 TE 生成或取得的属性,所有的预置属性以"#"开头,且都为事件属性,且这些属性的中文名以及意义都已经确定。系统字段指的是数据中的结构字段(如#account_id#event_time等),或者数据库中具有特殊用途的字段,在分析模型中往往不会被使用,或者被间接使用。

除以下罗列的预置属性外,任何以"#"开头的属性都被视为非法字段,将无法入库,因此不建议您将自定义属性设置成以"#"开头,所有系统字段不能作为事件或用户属性,在数据接入时传入。

请注意,除了#ip之外的所有预置属性,不建议您直接使用,只有在同时使用客户端 SDK 与其他传输方式,需要让多端数据的属性一致时,建议在 TE 工作人员的引导下进行设置。

  • 预置属性
属性名 中文名 属性类型 说明
#ip
客户端
IP
文本
用户的
IP
地址,
TE
将以此获取用户的地理位置信息
#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 等
#device_type
设备类型
文本
用户设备的类型,如iPad,iPhone等
#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
#background_duration
后台
停留时长
数值
记录两次start事件发生区间内,应用进入后台的时长,单位是秒
#start_reason
启动原因
文本
只有当应用被非launcher方式启动时存在该属性,如deeplink方式或者其他应用startActivity启动,数据样例:"#start_reason":"{"url":"thinkingdata:\/\/","data":""}"
#ua
用户当前的代理信息
文本
用能够识别客户使用的操作系统及版本、CPU 类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等。
#utm
广告系列来源属性
文本
用户来源的广告信息,其中包含广告来源,广告媒介等信息
  • 事件表中的系统字段
字段名 中文名 属性类型 说明
$part_event
事件分区字段
文本
事件分区字段,取自 #event_name,即事件名
$part_date
日期分区字段
时间
日期分区字段,取自 #event_time ,也就是事件发生的日期
#app_id
项目ID
文本
事件所属项目ID
#user_id
用户唯一 ID
数值
用户在系统中的唯一用户标识
#account_id
账户 ID
文本
账户 ID,相当于数据中的 #account_id
#distinct_id
访客 ID
文本
访客 ID,相当于数据中的 #distinct_id
#event_name
事件名称
文本
事件名称,相当于数据中的 #event_name 字段
#event_time
事件时间
时间
事件时间,相当于数据中的 #time 字段
#server_time
服务端时间
时间
服务端收到数据的时间
#dw_create_time
首次入库时间
时间
该条事件数据入库时间,可更新事件该属性都是nul
#dw_update_time
入库更新时间
时间
该条事件数据入库更新时间,非可更新事件该属性都是null
#kafka_offset
kafka偏移值
数值
事件存储在kafka上的偏移值
#uuid
UUID
文本
事件的识别ID
  • 用户表中的系统字段
字段名 中文名 属性类型 说明
#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
服务端时间
时间
收到的最后一条用户属性数据的服务器时间
#dw_update_time
入库更新时间
时间
该条用户数据最新更新时间
#event_date
最新的事件日期
数值
该用户最新一条事件入库日期
#user_operation
用户操作类型
文本
用户属性数据的操作类型
#kafka_offset
kafka偏移值
数值
用户属性数据存储在kafka上的偏移值
#uuid
UUID
文本
用户属性数据的识别ID