You need to enable JavaScript to run this app.
导航
预置用户属性/预置事件公共属性
最近更新时间:2025.10.29 11:32:22首次发布时间:2024.03.01 18:36:18
复制全文
我的收藏
有用
有用
无用
无用

背景信息
  • 事件/属性类型说明:当前为您介绍的是预置用户属性和预置事件公共属性,此外,DataFinder各个端支持的“预置事件”和“预置事件属性”可查看各个端的预置事件和属性文档,各类型的属性介绍请参见预置属性总表
  • 上报机制:详情请参见数据上报&缓存策略

私有化

SDK采集:APP

Android、iOS、鸿蒙-通用字段

预置事件公共属性名

属性描述

属性值类型

数据来源

是否自动采集

开关控制

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

用户传入

看客户是否设置

Android特有

预置事件公共属性名

属性描述

属性值类型

数据来源

是否自动采集

开关控制

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

iOS特有

预置事件公共属性名

属性描述

属性值类型

数据来源

是否自动采集

开关控制

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

SDK采集:Web

预置事件公共属性名

属性描述

属性值类型

数据来源

是否自动采集

开关控制

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,详情请参见帮助文档:支持的用户唯一标识

string

服务端生成

$latest_traffic_source_type

业务设置 traffic_type 后主动上报

string

系统API

SDK采集:小程序

预置事件公共属性名

属性描述

属性值类型

数据来源

是否自动采集

开关控制

user_id

用户传入的登录态

string

用户传入

$user_unique_id_type

用户传入的登录态类型

string

用户传入

sdk_lib

SDK 类型

string

固定值

sdk_version

SDK 版本号

string

固定值

device_brand

手机品牌

string

系统 API

platform

平台

string

固定值

device_model

手机型号

string

系统 API

language

系统语言

string

系统 API

os_name

操作系统

string

系统 API

os_version

系统版本

string

系统 API

resolution

屏幕分辨率

string

系统 API

network_type

网络类型,例如"wifi"

String

系统 API

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)是否是同一天,来标识用户是否是首日访问,可用于识别用户是否是新用户。

说明

DataFinder同时为您提供了user_is_new属性,可用于一段分析周期内判断用户是否是新用户,与$is_first_day主要差异在于:

  • $is_first_day是判断指标事件激活时间(first_event_time)与指标事件发生的事件(event_time)是否是同一天;
  • user_is_new的计算结果与数据分析的时间粒度有关,是指标事件激活时间(first_event_time)与指标事件发生的事件(event_time)是否是同一时间周期,因此分析的时间周期不一样可能user_is_new的计算结果不一样。

int

$is_login

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

int

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

预置用户属性

用户属性名

属性描述

属性值类型

数据来源

是否自动采集

开关控制

first_event_time

激活时间

Datetime

服务端生成

last_active_date

最后活跃日期

Datetime

服务端生成

user_is_new

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

说明

DataFinder同时为您提供了$is_first_day属性,可用于判断用户是否是某一天的新用户,与user_is_new主要差异在于:

  • $is_first_day是判断指标事件激活时间(first_event_time)与指标事件发生的事件(event_time)是否是同一天;
  • user_is_new的计算结果与数据分析的时间粒度有关,是指标事件激活时间(first_event_time)与指标事件发生的事件(event_time)是否是同一时间周期,因此分析的时间周期不一样可能user_is_new的计算结果不一样。

Number

服务端生成

gender

性别

String

服务端生成