network_type

网络类型，小程序端：使用平台提供getNetworkType方法获取网络类型，值有：wifi/2g/3g/4g/unknown(Android下不常见的网络类型)/none(无网络)

string

系统 API

是

否

ab_version

AB实验的实验版本ID（VID）。

list

系统 API

是

否

app_channel

渠道属性，上报结果为集成SDK时手动设置的app_channel取值。

string

用户传入

是

否

language

系统语言

string

系统 API

是

否

os_name

操作系统

string

固定值

是

否

os_version

系统版本

string

系统 API

是

否

package

安装包名

string

是

否

platform

数据上报的的平台属性。

string

固定值

是

否

region

系统国家/系统地区

string

系统 API

是

否

resolution

分辨率

string

系统 API

是

否

sdk_lib

SDK版本
web: js，安卓：android，ios: ios，小程序：mp_common，鸿蒙：openHarmony

string

固定值

是

否

sdk_version

SDK版本

string

固定值

是

否

$user_unique_id_type

用户ID类型

string

用户传入

看客户是否设置

否

app_region

软件地区/软件国家
Android：
优先取 config.setRegion 中的值，如果没有走系统当前 region 兜底
iOS
优先取 track.setAppRegion 中的值，如果没有走系统当前 region 兜底
无法通过枚举一一列举，国内为 cn

String

用户传入

是

否

app_version_minor

APP版本的Build 号，iOS从系统API获取build号，Android端需在集成SDK时手动设置。

String

用户传入

是

否

network_carrier

运营商信息，DataFinder在数据构建时会有清洗逻辑到设备库进行映射，如果映射不到就使用上报的值，
iOS端不支持收集运营商相关属性数据。

String

系统 API

是

是，Android端通过“setOperatorInfoEnabled”开关控制是否采集运营商信息

cpu_abi

cpu架构对应的abi

String

系统 API

是

否

device_brand

手机品牌

String

系统 API

是

否

app_region

软件国家/软件地区。
Android：
优先取 config.setRegion 中的值，如果没有走系统当前 region 兜底
iOS
优先取 track.setAppRegion 中的值，如果没有走系统当前 region 兜底

String

用户传入,系统 API

是

否

app_version_minor

APP版本的Build 号，iOS从系统API获取build号，Android端需在集成SDK时手动设置。鸿蒙暂不支持。

String

系统 API

是

否

network_carrier

运营商信息，DataFinder在数据构建时会有清洗逻辑到设备库进行映射，如果映射不到就使用上报的值，
iOS端不支持收集运营商相关属性数据。

String

系统 API

是

是，鸿蒙端通过“setOperatorInfoEnabled”开关控制是否采集运营商信息。

cpu_abi

cpu架构对应的abi

String

系统 API

是

否

device_brand

手机品牌

String

系统 API

是

否

ab_version

AB实验的实验版本ID（VID）。

list

应用信息

否

否

browser

浏览器。
web: 从浏览器的userAgent采集而来。
枚举值有：Chrome，Safari，FireFox，Microsoft Edge，Microsoft Internet Explorer，sougoubrowser，qqbrowser，weixin，360browser，baidubrowser，xiaomi，Opera

string

设备信息

是

否

browser_version

浏览器版本。
web: 从浏览器的userAgent采集而来，先识别出对应的浏览器型号，再从特定的位置解析出版本号，没有枚举值。如:
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 浏览器是Chrome，版本号是134.0.0.0

string

设备信息

是

否

device_brand

手机品牌

string

设备信息

是

否

language

系统语言

string

设备信息

是

否

os_name

操作系统

string

设备信息

是

否

os_version

系统版本

string

设备信息

是

否

platform

数据上报的的平台属性。

string

固定值

是

否

resolution

分辨率

string

设备信息

是

否

screen_height/height

当前屏幕的高度，单位：px

int

设备信息

是

否

screen_width/width

当前屏幕的宽度，单位：px

int

设备信息

是

否

web_id

生成的设备web_id，详情请参见帮助文档：https://www.volcengine.com/docs/84129/1261513。

string

服务端生成

是

否

$latest_traffic_source_type

业务设置 traffic_type 后主动上报

string

系统API

是

否

device_brand

手机品牌

string

系统 API

是

否

device_model

手机型号

string

系统 API

是

否

language

系统语言

string

系统 API

是

否

os_name

操作系统

string

系统 API

是

否

os_version

系统版本

string

系统 API

是

否

platform

平台

string

固定值

是

否

resolution

屏幕分辨率

string

系统 API

是

否

sdk_lib

SDK 类型

string

固定值

是

否

sdk_version

SDK 版本号

string

固定值

是

否

user_id

用户传入的登录态

string

用户传入

客户主动设置

否

$user_unique_id_type

用户传入的登录态类型

string

用户传入

客户主动设置

否

network_type

网络类型，例如"wifi"

String

系统 API

是

否

device_brand

手机品牌，例如，"iPhone"

String

系统 API

是

否

mp_platform_app_version

微信版本号

String

系统 API

是

否

mp_platform_basic_version

客户端基础库版本，例如"1.1.0"

String

系统 API

是

否

mp_platform

小程序平台

String

DataFinder服务端生成

是

否

rangers_mp_from_uid

用于记录小程序分享时的来源标识，其值通常为分享者的 ssid。通过这个属性，可以追踪用户是通过哪个分享链接进入小程序的，进而分析分享行为和效果

String

DataFinder服务端生成

是

否

$anonymous_id

SDK随机生成的匿名id，支持自定义改写，客户端在上报device_id、web_id的同时会将客户侧生成的唯一设备标识上报为anonymous_id。

string

DataFinder服务端生成

是

否

$app_id

应用的唯一标识AppID值。取值为客户传入。

int

是

否

$event_name

事件名

string

是

否

$event_time

事件发生时间，客户端 SDK 仅 crash 事件有，为崩溃发生时间

• crash事件目前只有App才会报
• 记录的是crash的那个时间点，但是在下次再进App时上报
• 格式是都是时间戳，记录在local_time_ms字段

datetime

是

否

$is_first_day

是否首日访问。
APP端上报事件时，基于指标事件激活时间（first_event_time）与指标事件发生的事件（event_time）是否是同一天，来标识用户是否是首日访问，可用于识别用户是否是新用户。

int

是

否

$is_login

是否登录，user_unique_id不为空赋值1 否则为0

int

是

否

$latest_referrer

用户在访问目标页面时，同时上报的访问当前页面前所在的最后一个页面地址。

string

是

否

$latest_referrer_host

用户在访问目标页面时，同时上报的访问当前页面前所在的最后一个页面域名。

string

是

否

device_id

设备ID

string

是

否

loc_city_id

城市信息，DataFinder在数据构建时根据client_ip生成此属性的取值。

string

是

否

loc_country_id

国家信息，DataFinder在数据构建时根据client_ip生成此属性的取值。

string

是

否

loc_province_id

省份信息，DataFinder在数据构建时根据client_ip生成此属性的取值。

string

是

否

origin_ab_version

宽口径的AB实验VID，关联A/B测试的ablog表进行筛选。用户首次入组后始终统计在当前组，即后续用户分组变化后仍然会被统计在首次的分组。实验统计使用该口径。

int

是

否

referrer

上报页面访问（Page_view）事件时，上报的页面访问来源的地址信息，主要由三部分组成： protocol://host[:port]/path。其中，host生成方式是将字符串解析为java.net.URL对象，并调用getHost()方法得到。

string

是

否

referrer_host

上报页面访问（Page_view）事件时，上报的页面访问来源的域名信息，生成逻辑和枚举值详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

是

否

user_id

用户ID

string

是

否

client_ip

IP地址

string

是

first_event_time

激活时间

Datetime

服务端生成

是

否

last_active_date

最后活跃日期

Datetime

服务端生成

是

否

user_is_new

在数据查询分析的时间周期内，用户是否是新用户。

Number

服务端生成

是

否

cpu_abi

cpu架构对应的abi

String

系统 API

是

否

cpu_abi

cpu架构对应的abi

String

系统 API

是

否

screen_height/height

当前屏幕的高度，单位：px

int

设备信息

是

否

screen_width/width

当前屏幕的宽度，单位：px

int

设备信息

是

否

web_id

生成的设备web_id，详情请参见帮助文档：https://www.volcengine.com/docs/84129/1261513。

string

服务端生成

是

否

$latest_traffic_source_type

业务设置 traffic_type 后主动上报

string

系统API

是

否

$event_name

事件名

string

DataFinder服务端生成

是

否

$is_login

是否登录，user_unique_id不为空赋值1 否则为0

int

是

否

$is_first_day

是否首日访问。
APP端上报事件时，基于指标事件激活时间（first_event_time）与指标事件发生的事件（event_time）是否是同一天，来标识用户是否是首日访问，可用于识别用户是否是新用户。

int

是

否

$event_time

事件发生时间，客户端 SDK 仅 crash 事件有，为崩溃发生时间

• crash事件目前只有App才会报
• 记录的是crash的那个时间点，但是在下次再进App时上报
• 格式是都是时间戳，记录在local_time_ms字段

datetime

是

否

$latest_referrer

用户在访问目标页面时，同时上报的访问当前页面前所在的最后一个页面地址。

string

是

否

$latest_referrer_host

用户在访问目标页面时，同时上报的访问当前页面前所在的最后一个页面域名。

string

是

否

referrer_host

上报页面访问（Page_view）事件时，上报的页面访问来源的域名信息，生成逻辑和枚举值详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

是

否

bddid

设备ID，请求之前会请求 did，如果没有 did，不会上报数据，会等到 did 请求回来后才上报

string

是

否

$tr_web_ssid

网页端ssid

string

是

否

referrer

上报页面访问（Page_view）事件时，上报的页面访问来源的地址信息，主要由三部分组成： protocol://host[:port]/path。其中，host生成方式是将字符串解析为java.net.URL对象，并调用getHost()方法得到。

string

是

否

ab_version

AB实验VID

Number

用户传入

是

否

age

年龄

String

是

否

app_channel

渠道属性，上报结果为集成SDK时手动设置的app_channel取值。

String

是

否

app_language

软件语言

String

用户传入

是

否

app_region

软件地区，
Android：
优先取 config.setRegion 中的值，如果没有走系统当前 region 兜底
iOS
优先取 track.setAppRegion 中的值，如果没有走系统当前 region 兜底
无法通过枚举一一列举，国内为 cn

String

是

否

app_version

软件版本

String

系统 API

是

否

brand

手机品牌

String

系统 API

是

否

browser

浏览器，web端 从浏览器的userAgent采集而来。
枚举值有：Chrome，Safari，FireFox，Microsoft Edge，Microsoft Internet Explorer，sougoubrowser，qqbrowser，weixin，360browser，baidubrowser，xiaomi，Opera

String

系统 API

是

否

browser_version

浏览器版本，Web端从浏览器的userAgent采集而来，先识别出对应的浏览器型号，再从特定的位置解析出版本号。如:
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 浏览器是Chrome，版本号是134.0.0.0

String

系统 API

是

否

client_ip

IP地址(最终值)

String

是

否

continent

国家所属大洲（数据构建时根据client_ip生成）

String

服务端生成

是

否

custom_mp_platform

小程序平台

String

是

否

custom_mp_platform_app_version

平台版本号

String

是

否

custom_mp_platform_basic_version

小程序基础库版本号

String

是

否

custom_rangers_mp_from_uid

当前请求ssid（数据流维护）

String

服务端生成

是

否

device_model

设备型号，web: 根据浏览器UA进行解析后采集上报
小程序：使用平台的getSystemInfo方法获取
Android：使用系统 API：Build.MODEL
iOS：systemInfo.machine
鸿蒙：deviceInfo.productModel

String

系统 API

是

否

gender

性别

String

是

否

language

系统语言

String

系统 API

是

否

loc_city_id

城市信息，DataFinder在数据构建时根据client_ip生成此属性的取值。

String

服务端生成

是

否

loc_country_id

国家信息，DataFinder在数据构建时根据client_ip生成此属性的取值。

String

服务端生成

是

否

loc_province_id

省份信息，DataFinder在数据构建时根据client_ip生成此属性的取值。

String

服务端生成

是

否

network_carrier

运营商信息，DataFinder在数据构建时会有清洗逻辑到设备库进行映射，如果映射不到就使用上报的值，
iOS端不支持收集运营商相关属性数据。

String

系统 API

是

否

network_type

网络类型，小程序端：使用平台提供getNetworkType方法获取网络类型，值有：wifi/2g/3g/4g/unknown(Android下不常见的网络类型)/none(无网络)

String

系统 API

是

否

os_name

操作系统

String

系统 API

是

否

os_version

系统版本

String

系统 API

是

否

platform

平台类型

String

固定值

是

否

region

系统地区

String

系统 API

是

否

resolution

分辨率

String

系统 API

是

否

sdk_lib

SDK类型，取值：
web端: js；安卓端：android；ios端: ios；小程序端：mp_common；鸿蒙端：openHarmony

String

固定值

是

否

sdk_version

SDK版本

String

固定值

是

否

user_id

用户ID

String

是

否

user_is_new

在数据查询分析的时间周期内，用户是否是新用户。

Number

服务端生成

是

否

utm_campaign

属性为在广告监测中创建的推广活动的名称。上报时机为，移动app：发生激活时上报；web：点击监测链接跳到落地页随事件上报；小程序：打开小程序监测的落地页，随事件报。

String

服务端生成

是

否

utm_content

属性为在广告监测页面创建web和小程序推广活动中填写的广告内容。上报时机为，web：点击监测链接跳到落地页随事件上报；小程序：打开小程序监测的落地页，随事件上报。

String

服务端生成

是

否

utm_medium

属性为在广告监测页面创建web和小程序推广活动中填写的广告媒介值。上报时机为，web：点击监测链接跳到落地页随事件上报；小程序：打开小程序监测的落地页，随事件上报。

String

服务端生成

是

否

utm_source

属性为在广告监测中创建的推广渠道，可以是合作渠道也可以是自己创建的自定义渠道。上报时机为，移动app：发生激活时上报；web：点击监测链接跳到落地页随事件上报；小程序：打开小程序监测的落地页，随事件报。

String

服务端生成

是

否

utm_term

属性为在广告监测页面创建web和小程序推广活动中填写的广告关键字。上报时机为，web：点击监测链接跳到落地页随事件上报；小程序：打开小程序监测的落地页，随事件上报。

String

服务端生成

是

否

network_type

网络类型，小程序端：使用平台提供getNetworkType方法获取网络类型，值有：wifi/2g/3g/4g/unknown(Android下不常见的网络类型)/none(无网络)

string

系统 API

是

否

ab_version

AB实验的实验版本ID（VID）。

list

系统 API

是

否

app_channel

渠道属性，上报结果为集成SDK时手动设置的app_channel取值。

string

用户传入

是

否

language

系统语言

string

系统 API

是

否

os_name

操作系统

string

固定值

是

否

os_version

系统版本

string

系统 API

是

否

platform

数据上报的的平台属性。

string

固定值

是

否

region

系统国家/系统地区

string

系统 API

是

否

resolution

分辨率

string

系统 API

是

否

sdk_lib

SDK版本
web: js，安卓：android，ios: ios，小程序：mp_common，鸿蒙：openHarmony

string

固定值

是

否

sdk_version

SDK版本

string

固定值

是

否

$user_unique_id_type

用户ID类型

string

用户传入

看客户是否设置

否

app_version_minor

APP版本的Build 号，iOS从系统API获取build号，Android端需在集成SDK时手动设置。

String

用户传入

是

否

app_region

软件地区/软件国家
Android：
优先取 config.setRegion 中的值，如果没有走系统当前 region 兜底
iOS
优先取 track.setAppRegion 中的值，如果没有走系统当前 region 兜底
无法通过枚举一一列举，国内为 cn

String

用户传入

是

否

device_brand

手机品牌

String

系统 API

是

否

network_carrier

运营商信息，DataFinder在数据构建时会有清洗逻辑到设备库进行映射，如果映射不到就使用上报的值，
iOS端不支持收集运营商相关属性数据。

String

系统 API

是

是，Android端通过“setOperatorInfoEnabled”开关控制是否采集运营商信息

cpu_abi

cpu架构对应的abi

String

系统 API

是

否

app_region

软件国家/软件地区。
Android：
优先取 config.setRegion 中的值，如果没有走系统当前 region 兜底
iOS
优先取 track.setAppRegion 中的值，如果没有走系统当前 region 兜底

String

用户传入,系统 API

是

否

app_version_minor

APP版本的Build 号，iOS从系统API获取build号，Android端需在集成SDK时手动设置。鸿蒙暂不支持。

String

系统 API

是

否

network_carrier

运营商信息，DataFinder在数据构建时会有清洗逻辑到设备库进行映射，如果映射不到就使用上报的值，
iOS端不支持收集运营商相关属性数据。

String

系统 API

是

是，鸿蒙端通过“setOperatorInfoEnabled”开关控制是否采集运营商信息。

cpu_abi

cpu架构对应的abi

String

系统 API

是

否

device_brand

手机品牌

String

系统 API

是

否

ab_version

AB实验的实验版本ID（VID）。

list

应用信息

否

否

anonymous_id

用户匿名ID

string

用户传入

是

否

browser

浏览器。
web: 从浏览器的userAgent采集而来。
枚举值有：Chrome，Safari，FireFox，Microsoft Edge，Microsoft Internet Explorer，sougoubrowser，qqbrowser，weixin，360browser，baidubrowser，xiaomi，Opera

string

设备信息

是

否

browser_version

浏览器版本。
web: 从浏览器的userAgent采集而来，先识别出对应的浏览器型号，再从特定的位置解析出版本号，没有枚举值。如:
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 浏览器是Chrome，版本号是134.0.0.0

string

设备信息

是

否

device_brand

手机品牌

string

设备信息

是

否

language

系统语言

string

设备信息

是

否

os_name

操作系统

string

设备信息

是

否

os_version

系统版本

string

设备信息

是

否

platform

数据上报的的平台属性。

string

固定值

是

否

resolution

分辨率

string

设备信息

是

否

web_id

生成的设备web_id，详情请参见帮助文档：https://www.volcengine.com/docs/84129/1261513。

string

服务端生成

是

否

$latest_traffic_source_type

业务设置 traffic_type 后主动上报

string

系统API

是

否

user_id

用户传入的登录态

string

用户传入

是

否

$user_unique_id_type

用户传入的登录态类型

string

用户传入

是

否

sdk_lib

SDK 类型

string

固定值

是