菜单

预置事件/属性

在满足数据格式的要求下，本质上用户可以上报任意的事件与属性。但DT要实现特色功能（如ROI计算、用户归因等），会内置一些事件和属性。这些事件名和属性名是固定的，不允许修改的，客户无法通过SDK的track接口上报，而只能通过SDK指定的接口进行数据上报。

预置数据中，有一类是系统数据（以$开头），即完全由DT后台生成，不允许SDK或用户上报

一、预置事件

1.1 基础事件

事件名	显示名	说明	设置方式
#app_install	app 安装	在 APP 安装后的首次启动时上报（即用户触发上报的首个事件），APP 升级并不会触发安装事件，而删除重装后会上报安装事件；实现上是 Android 通过 InstallReferrer 拿到应用安装信息	客户端 SDK 自动
#session_start	app 打开	进入 app 页面时触发，包含用户开启 APP 或从后台唤醒 APP 两种情况	客户端 SDK 自动
$app_install	app 安装（服务端）	DataTower.ai 通过客户授权的三方归因平台拿到的应用安装事件信息	系统自动；需用户接入三方归因平台数据
DT@first_install	app 首次安装	DT 预置虚拟事件；用作计算新用户人数、买量支出成本的必要事件	系统自动
#session_end	app 关闭	离开 app 页面时触发，包含用户关闭 APP 或将 APP 调至后台两种情况	客户端 SDK 自动

1.2 收入事件

事件名	显示名	说明	采集方式
#ad_show	广告展示	参与广告收益计算的重要事件；在广告展示后上报	用户主动上报
#ad_conversion	广告收益	参与广告收益计算的重要事件；在用户获得广告奖励后上报	用户主动上报
$ad_conversion	广告收益转化(服务端)	DataTower.ai依赖客户授权的变现平台数据计算出的广告收益事件	系统自动；需用户接入三方变现平台数据
#iap_purchase_success	购买成功	参与内购收益计算的重要事件；在用户购买成功后上报	用户主动上报
#ias_subscribe_success	订阅成功	参与订阅收益计算的重要事件；在用户订阅成功后上报	用户主动上报

1.3 其他广告事件

事件名	显示名	说明	采集方式
#ad_paid	广告展示价值	广告平台给每个广告的预估价值	用户主动上报
#ad_load_begin	广告加载开始	广告加载开始	用户主动上报
#ad_load_end	广告加载结束	广告加载结束	用户主动上报
#ad_to_show	广告预展示	将要展示广告	用户主动上报
#ad_show_failed	广告展示失败	广告展示失败	用户主动上报
#ad_close	广告关闭	广告已经关闭	用户主动上报
#ad_click	广告点击	参与广告收益计算的重要事件；在广告点击时上报	用户主动上报
#ad_rewarded	广告获得奖励	只针对激励广告获得奖励	用户主动上报

二、预置属性

2.1 事件属性

应用内每个事件都会带有的公共属性

属性名	数据类型	显示名	说明	上报时机
$uid	文本	DT 用户 ID	DT 系统中的用户唯一 ID；区分唯一事件流	由DT后台基于#acid和#dt_id自动生成
$server_time	日期和时间	事件时间（服务端）	服务端接收到事件，获取时间戳，精确到毫秒	由DT后台自动生成，无需SDK上报
$ip	文本	设备 IP	用户设备外网 IP	由DT后台自动生成，无需SDK上报
$country_code	文本	设备国家/地区代码	用户设备外网 IP 所在的国家/地区代码	由DT后台自动生成，无需SDK上报
$city	文本	城市	用户设备外网 IP 所在的城市	由DT后台自动生成，无需SDK上报
#acid	文本	账号ID	应用内的用户账号 ID，用户在登录状态下的唯一标识	用户主动设置，调用SDK提供的接口
#dt_id	文本	DT-ID	DT 系统中的设备唯一 ID；用户在未登录状态下的唯一标识，应用卸载重新安装后，该 ID 不会变化	由DT后台自动生成，无需SDK上报
#event_name	文本	事件名称	事件的名称	调用接口时，传参确定
#event_time	日期和时间	事件时间	事件发生时的客户端时间，获取时间戳，精确到毫秒	SDK上报时记录
#event_syn	文本	事件ID	event_name 的事件发生多次，event_syn 均不相同	由 SDK 生成，用于区分事件同一个
#bundle_id	文本	应用包名	应用包名	应用包名
#session_id	文本	会话 ID	每次 app 打开事件触发时会重置；app 从打开到关闭之前，这期间产生事件的 app_session 相同；若应用在后台触发事件，则不上报会话 ID	app 打开事件触发时生成
#device_manufacturer	文本	设备制造商	用户设备的制造商，如 Apple，vivo 等	SDK自动采集
#is_foreground	布尔	应用是否在前台	事件发生的时候，应用是否在前台	SDK自动采集
#android_id	文本	谷歌应用 ID	由于谷歌隐私政策，有可能不上报	SDK自动采集
#gaid	文本	谷歌广告标识 ID	不同 app 在同一个设备上gaid 一样，但是因为权限可能无法获取	客户端 SDK 自动iOS 不采集
#mcc	文本	移动信号国家/地区码	用户设备的移动信号国家/地区码	SDK自动采集
#mnc	文本	移动信号网络码	用户设备的移动信号网络码	SDK自动采集
#os_country_code	文本	系统国家/地区代码	用户设备的系统国家/地区代码	SDK自动采集
#os_lang_code	文本	系统语言代码	用户设备系统的国家语言代码	SDK自动采集
#app_version_code	数值	应用版本号	APP 的应用版本号	SDK自动采集
#app_version_name	文本	应用版本名	APP 的应用版本名	SDK自动采集
#sdk_type	文本	SDK 类型	APP 接入的 SDK 类型，如 Android，iOS，Unity，Flutter，Web 等	SDK自动采集
#sdk_version_name	文本	SDK 版本名	app 接入的 SDK 版本名，如 1.1.2	SDK自动采集
#os	文本	操作系统	用户设备的操作系统，如 Android、iOS 等	SDK自动采集
#os_version_name	文本	操作系统版本名	用户设备的系统操作版本名，如 iOS 11.2.2、Android 8.0.0 等	SDK自动采集
#os_version_code	数值	操作系统版本号	用户设备的系统操作版本号，如 33、31 等	SDK自动采集
#device_brand	文本	设备品牌	用户设备的设备平台，如 Galaxy、Pixel	SDK自动采集
#device_model	文本	设备型号	用户设备的型号，如 iPhone 8 等	SDK自动采集
#build_device	文本	驱动名称	用户设备的驱动名称，如 redfin 等	SDK自动采集
#screen_height	数值	屏幕高度	用户设备的屏幕高度，如 1920 等	SDK自动采集
#screen_width	数值	屏幕宽度	用户设备的屏幕宽度，如 1080 等	SDK自动采集
#memory_used	文本	设备内存使用状态	用户设备的当前剩余内存和总内存，如 1.4GB/2.4GB	SDK自动采集
#storage_used	文本	设备存储空间状态	用户设备的当前剩余存储空间和总存储空间，如 30GB/200GB	SDK自动采集
#network_type	文本	网络状态	nonetwork、wifi、2g、3g、4g、5g	SDK自动采集
#simulator	布尔	是否是模拟器	是否是模拟器	SDK自动采集
#fps	数值	FPS	用户设备的当前图像每秒传输帧率，如 60	SDK自动采集
#firebase_iid	文本	Firebase id	用于三方数据回传使用客户端SDK(3.0.2版本更新后新增)	调用SDK对应的设置三方数据ID后，所有的事件将会增加对应的ID属性
#appsflyer_id	文本	Appsflyer id	用于三方数据回传使用客户端SDK(3.0.2版本更新后新增)	调用SDK对应的设置三方数据ID后，所有的事件将会增加对应的ID属性
#adjust_id	文本	Adjust id	用于三方数据回传使用客户端SDK(3.0.2版本更新后新增)	调用SDK对应的设置三方数据ID后，所有的事件将会增加对应的ID属性
#kochava_id	文本	Kochava id	用于三方数据回传使用客户端SDK(3.0.2版本更新后新增)	调用SDK对应的设置三方数据ID后，所有的事件将会增加对应的ID属性
#zone_offset	数值	时区偏移	数据时间相对 UTC 时间的偏移小时数	SDK自动采集
#event_duration	数值	事件时长	事件的持续时长，精确到毫秒；需要调用 DTAnalyticsUtils 中的计时功能	任意调用DTAnalyticsUtils中计时功能事件

app 打开（#session_start）事件的额外属性

属性名	数据类型	显示名	说明	设置方式
#is_first_time	布尔	app 是否首次打开	true，首次打开 false，非首次打开	客户端 SDK 自动
#resume_from_background	布尔	app 是否从后台打开	true，从后台唤醒 false，冷启动 APP	客户端 SDK 自动
#start_reason	文本	app 打开原因	内容为 JSON 字符串，只有当应用被非 launcher 方式启动时存在该属性，如 deeplink 方式或者其他应用 startActivity 启动，数据样例："#start_reason"："{"url"："dataTower：\/\/"，"data"：""}"	客户端 SDK 自动

app 安装（#app_install）事件的额外属性，注意：仅 Android SDK 会采集以下属性，iOS SDK 不采集

属性名	数据类型	显示名	说明
#referrer_url	文本	安装来源网址	已安装软件包的引荐来源网址
#referrer_click_time	日期和时间	安装来源网址点击时间	引荐来源网址点击事件发生时的客户端时间戳（以秒为单位）
#app_install_time	日期和时间	安装时间	应用安装开始时的客户端时间戳（以秒为单位）
#app_install_time_server	数值	安装时间（服务端）	应用安装开始时的服务端时间戳（以秒为单位）
#instant_experience_launched	布尔	是否为免安装体验	表明应用的免安装体验是否为过去 7 天内发布的
#failed_reason	文本	获取安装信息失败原因	获取安装信息失败原因
#cnl	文本	渠道名称	初始化的传入的渠道名称
$dt_cid	文本	$dt_cid	使用了渠道包自归因，且配置了 tracking 校验时才会存在
$fraud_network_id	文本	欺诈-渠道
$channel_id	文本	广告计划 ID	由广告投放平台生成的推广通道方式 ID，例如广告计划 ID
$channel_name	文本	广告计划	由广告投放平台生成的推广通道方式名称，例如广告计划名称
$channel_sub_id	文本	广告组 ID	由广告投放平台生成的一级渠道下再次细分渠道 ID，例如广告组 ID
$channel_sub_name	文本	广告组	由广告投放平台生成的一级渠道下再次细分渠道名称，例如广告组名称
$channel_ssub_id	文本	广告 ID	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材 ID
$channel_ssub_name	文本	广告	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材名称
$channel_platform_id	文本	流量平台 ID	用户自主在 DataTower【归因管理-全局配置】创建渠道时添加流量平台时自动生成
$channel_platform_name	文本	流量平台	用户自主在 DataTower【归因管理-全局配置】创建渠道时添加流量平台时自动生成

app 安装（服务端）（$app_install）事件的额外属性

属性名	数据类型	显示名	说明
$channel_id	文本	广告计划 ID	由广告投放平台生成的推广通道方式 ID，例如广告计划 ID
$channel_name	文本	广告计划	由广告投放平台生成的推广通道方式名称，例如广告计划名称
$channel_sub_id	文本	广告组 ID	由广告投放平台生成的一级渠道下再次细分渠道 ID，例如广告组 ID
$channel_sub_name	文本	广告组	由广告投放平台生成的一级渠道下再次细分渠道名称，例如广告组名称
$channel_ssub_id	文本	广告 ID	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材 ID
$channel_ssub_name	文本	广告	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材名称
$channel_platform_id	文本	流量平台 ID	用户自主在 DataTower【归因管理-全局配置】创建渠道时添加流量平台时自动生成
$channel_platform_name	文本	流量平台	用户自主在 DataTower【归因管理-全局配置】创建渠道时添加流量平台时自动生成
$channel_creative	文本	素材
$channel_creative_id	文本	素材ID
$attribution_source	文本	归因-数据来源	三方归因数据来源，有三方归因数据接入时才会存在
$original_tracker_id	文本	原始投放者 id	原始投放者 id，有三方归因数据接入时才会存在
$original_tracker_name	文本	原始投放者名称	原始投放者名称，有三方归因数据接入时才会存在
$original_network_id	文本	原始渠道 id	原始渠道 id，有三方归因数据接入时才会存在
$original_network_name	文本	原始渠道名称	原始渠道名称，有三方归因数据接入时才会存在
$site_id	文本	子渠道ID	3.6.1.0版本后，三方归因数据增加子渠道ID处理

app 首次安装（DT@first_install）事件的额外属性

属性名	数据类型	显示名	说明	设置方式
vep$is_first_install	布尔	是否首次安装	DT 预置虚拟事件属性；判断应用是否首次安装，用作计算参与买量支出的必要事件属性	系统自动
vep$cac	数值	获客成本	DT 预置虚拟事件属性；广告投放平台买量支出，用作计算参与买量支出的必要事件属性	需用户接入三方投放平台数据

app 关闭（#session_end）事件的额外属性

属性名	数据类型	显示名	说明	设置方式
#session_duration	数值	会话时长	本次打开 app 页面到关闭 app 页面的时长，单位为毫秒（ms）	客户端 SDK 自动

广告相关事件的额外属性

属性名	数据类型	显示名	说明	关联事件
#ad_seq	文本	广告系列行为标识	广告系列事件的标识，需要调用 DTAdReport.generateUUID（）生成	#ad_load_begin, #ad_load_end , #ad_to_show, #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, #ad_conversion, #ad_paid, $ad_conversion
#ad_id	文本	广告单元 id	Network 广告单元 ID	#ad_load_begin, #ad_load_end , #ad_to_show, #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, #ad_conversion, #ad_paid, $ad_conversion
#ad_type_code	数值	广告类型代码	UNKNOWN = -1 // 未知、BANNER = 0 // 横幅、INTERSTITIAL = 1 // 插屏、NATIVE = 2 // 原生、REWARDED = 3 // 激励、REWARDED_INTERSTITIAL = 4 // 插屏激励、APP_OPEN = 5 // 开屏广告、MREC=6 // 中等矩形广告	#ad_load_begin, #ad_load_end , #ad_to_show, #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, #ad_conversion, #ad_paid, $ad_conversion
#ad_platform_code	数值	广告平台代码	UNDISCLOSED = -2 // 未授权、UNKNOWN = -1 // 未知、ADMOB = 0、MOPUB = 1、ADCOLONY = 2、APPLOVIN = 3、CHARTBOOST = 4、FACEBOOK = 5、INMOBI = 6、IRONSOURCE = 7、PANGLE = 8、SNAP_AUDIENCE_NETWORK = 9、TAPJOY = 10、UNITY_ADS = 11、VERIZON_MEDIA = 12、VUNGLE = 13、ADX = 14、COMBO = 15、BIGO = 16、HISAVANA = 17、APPLOVIN_EXCHANGE = 18、MINTEGRAL = 19、LIFTOFF = 20、A4G = 21、GOOGLE_AD_MANAGER = 22、FYBER = 23、MAIO = 24、CRITEO = 25、MYTARGET = 26、OGURY = 27、APPNEXT = 28、KIDOZ = 29、SMAATO = 30、START_IO = 31、VERVE = 32、LOVINJOY_ADS = 33、YANDEX = 34、REKLAMUP = 35	#ad_load_begin, #ad_load_end , #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, #ad_to_show, #ad_conversion, #ad_paid, $ad_conversion
#ad_entrance	文本	广告展示入口	广告展示入口，是广告的通用属性，在每个广告事件里都有，默认 ""	#ad_to_show, #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, $ad_conversion, #ad_conversion, #ad_paid, #ad_load_begin, #ad_load_end
#load_result	布尔	广告加载结果	广告加载结果，true 为广告加载成功	#ad_load_end
#load_duration	数值	广告加载时长	广告加载时长	#ad_load_end
#ad_location	文本	广告位	广告位置，通常为在广告平台配置的位置值	#ad_to_show, #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, #ad_conversion, #ad_paid, $ad_conversion, #ad_load_begin, #ad_load_end
#error_code	数值	错误码	失败码，值为应用接入的对应的广告平台给出的错误码	#ad_load_end , #ad_show_failed
#error_message	文本	错误信息	失败信息，应用接入的对应的广告平台给出的错误信息	#ad_load_end , #ad_show_failed
#ad_value	数值	广告价值	广告价值，应用接入的对应的广告平台给出的广告价值信息	#ad_paid
#ad_currency	文本	广告价值的货币类型	货币，广告价值对应的货币	#ad_paid
#ad_precision	文本	广告价值精确度	精确度，广告价值所对应的精确度	#ad_paid
#ad_country_code	文本	广告所属国家/地区代码	广告展示所在的国家/地区信息	#ad_paid
#ad_mediation_code	数值	聚合广告平台代码	如果不使用聚合广告平台，请传入-1MOPUB = 0、MAX = 1、HISAVANA = 2、COMBO = 3、TOPON = 4、TRADPLUS = 5、TOBID = 6	#ad_load_begin, #ad_load_end ,#ad_to_show, #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, #ad_conversion, #ad_paid, $ad_conversion
#ad_mediation_id	文本	聚合平台广告单元	聚合平台广告单元 ID	#ad_load_begin, #ad_load_end , #ad_to_show, #ad_show, #ad_show_failed, #ad_close, #ad_click, #ad_rewarded, #ad_conversion, #ad_paid, $ad_conversion
#ad_conversion_source	文本	广告转化来源	by_click：点击 by_impression：曝光 by_left_app：跳出 app by_rewarded ：获得激励	#ad_conversion,$ad_conversion
$earnings	数值	广告收益	DT依赖客户授权的变现平台数据计算出的广告收益	$ad_conversion

购买成功（#iap_purchase_success）事件的额外属性

属性名	数据类型	显示名	说明
#iap_order	文本	内购订单 ID	平台返回的订单号
#iap_sku	文本	内购商品 ID	商品 id
#iap_price	数值	内购商品价格	价格，如 9.99
#iap_currency	文本	内购价格货币类型	货币类型，ISO 4217 三字母货币代码，例 USD，点击查看支持货币类型
$iap_price_exchange	数值	内购商品转换后价格	转换 usd 汇率后的价格，如 9.99

订阅成功（#ias_subscribe_success）事件的额外属性

属性名	数据类型	显示名	说明
#ias_original_order	文本	原始订阅订单 ID	苹果返回的原始订阅订单号
#ias_order	文本	订阅订单 ID	平台返回的订单号
#ias_sku	文本	订阅商品 ID	订阅商品的 id
#ias_price	数值	订阅商品价格	价格，如 9.99
#ias_currency	文本	订阅价格货币类型	货币类型，ISO 4217 三字母货币代码，例 USD，点击查看支持货币类型
$ias_price_exchange	数值	订阅商品转换后价格	转换 usd 汇率后的价格，如 9.99

任意调用DTAnalyticsUtils中计时功能事件的额外属性

属性名	数据类型	显示名	说明	设置方式
#event_duration	数值	事件时长	事件的持续时长，精确到毫秒；需要调用 DTAnalyticsUtils 中的计时功能	用户主动

2.2 用户属性

应用内每个用户都会带有的属性

属性名	数据类型	显示名	说明	上报时机
$uid	文本	DT 用户 ID	DT 系统中的用户唯一 ID；区分唯一事件流	系统自动
#dt_id	文本	DT-ID	DT 系统中的设备唯一 ID；用户在未登录状态下的唯一标识，应用卸载重新安装后，该 ID 不会变化	客户端 SDK 自动
#acid	文本	账号 ID	应用内的用户账号 ID，用户在登录状态下的唯一标识	用户主动
$network_id	文本	渠道 ID	用户自主在 DataTower【归因管理-全局配置】创建渠道时自动生成，广告投放平台的公司主体 ID	安装事件(etl 生成)
$network_name	文本	渠道	用户自主在 DataTower【归因管理-全局配置】创建的广告投放平台的公司主体名称，例如 Google、Meta	安装事件(etl 生成)
$tracker_id	文本	代理商 ID	用户自主在 DataTower【归因管理-全局配置】创建渠道时添加流量平台时自动生成	安装事件(etl 生成)
$tracker_name	文本	代理商	用户自主在 DataTower【归因管理-全局配置】创建渠道时添加流量平台时自动生成	安装事件(etl 生成)
$channel_id	文本	广告计划 ID	由广告投放平台生成的推广通道方式 ID，例如广告计划 ID	安装事件(etl 生成)
$channel_name	文本	广告计划	由广告投放平台生成的推广通道方式名称，例如广告计划名称	安装事件(etl 生成)
$channel_sub_id	文本	广告组 ID	由广告投放平台生成的一级渠道下再次细分渠道 ID，例如广告组 ID	安装事件(etl 生成)
$channel_sub_name	文本	广告组	由广告投放平台生成的一级渠道下再次细分渠道名称，例如广告组名称	安装事件(etl 生成)
$channel_ssub_id	文本	广告 ID	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材 ID	安装事件(etl 生成)
$channel_ssub_name	文本	广告	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材名称	安装事件(etl 生成)
$channel_platform_id	文本	流量平台 ID	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材名称	安装事件(etl 生成)
$channel_platform_name	文本	流量平台	由广告投放平台生成的二级渠道下再次细分渠道 ID，例如广告素材名称	安装事件(etl 生成)
$site_id	文本	子渠道ID	用户自主在 DataTower【归因管理-全局配置】创建渠道时添加流量平台时自动生成	安装事件(etl 生成) (3.6.1.0版本后增加归因属性)
$active_server_time	日期和时间	激活时的事件时间（服务端）	服务端接收到事件，获取时间戳，精确到毫秒	安装事件(归因生成)
$active_time	日期和时间	激活时间	用户安装应用后，首次打开应用的时间归因事件中的 first open time 值，如果是三方归因，则是三方归因系统数据中的第一次打开时间	安装事件(归因生成)
$active_event_syn	文本	归因事件的事件ID	当前生效的归因事件的事件ID	安装事件(归因生成)
$attributed_last_click_time	日期和时间	归因-最后点击时间	广告最后点击时间	安装事件(etl 生成)
$account_id	文本	广告账户 ID	广告投放买量的账户 ID	安装事件(etl 生成)
$account_name	文本	广告账户	广告投放买量的账户名称	安装事件(etl 生成)
$active_ip	文本	激活时的设备 IP	用户激活 APP 时的设备外网 IP	user_set_once(etl生成)
$active_city	文本	IP所属城市	基于用户激活时的设备IP，解析的城市	user_set_once(etl生成)
$active_location	文本	IP所处位置	基于用户激活时的设备IP，解析的地理位置	user_set_once(etl生成)
$active_country_code	文本	激活时的设备国家/地区代码	用户激活 APP 时的设备外网 IP 所在国家/地区代码	user_set_once(etl生成)
$cac	数值	获客成本	DataTower.ai 依赖客户授权的广告投放平台数据计算出的获客成本，单位为美元（$）	DT通过投放数据与归因信息定时计算生成 & 安装事件（归因生成）
$cpa	数值	获客方式	0：转化目标为安装	DT通过投放数据与归因信息定时计算生成 & 安装事件（归因生成）
$cac_type	数值	-	-	-
#active_android_id	文本	激活时的谷歌应用 ID	由于谷歌隐私政策，有可能不上报
#active_gaid	文本	激活时谷歌广告标识 ID	不同 app 在同一个设备上gaid 一样，但是因为权限可能无法获取	dt sdk在安装时自动采集的并且上报的用户事件（user_set_once类型），标记了这个用户首次激活的gaid
#active_os	文本	激活时的操作系统	用户设备的操作系统，如 Android、iOS 等	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_mcc	文本	激活时的移动信号国家/地区码	用户设备的移动信号国家/地区码	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_mnc	文本	激活时的移动信号网络码	用户设备的移动信号网络码	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_os_country_code	文本	激活时的系统国家/地区代码	用户设备的系统国家/地区代码	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_os_lang_code	文本	激活时的系统语言代码	用户设备系统的国家语言代码	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_bundle_id	文本	激活时的应用包名	用户激活APP时的应用包名	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_app_version_code	数值	激活时的应用版本号	用户激活 APP 时的应用版本号	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_app_version_name	文本	激活时的应用版本名	用户激活 APP 时的应用版本名	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_sdk_type	文本	激活时的 SDK 类型	用户激活时 app 时接入 SDK 的类型，如 Android，iOS，Unity，Flutter，Web 等	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_sdk_version_name	文本	激活时的 SDK 版本名	用户激活时 app 接入的 SDK 版本名，如 1.1.2	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_os_version_name	文本	激活时的操作系统版本名	用户设备的系统操作版本名，如 iOS 11.2.2、Android 8.0.0 等	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_device_manufacturer	文本	激活时的设备硬件制造商	用户设备的硬件制造商，如 Apple，vivo 等	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_os_version_code	数值	激活时的操作系统版本号	用户激活时的操作系统版本号，例如 33，33	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_build_device	文本	激活时的设备参数	用户设备的驱动名称，如 redfin	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_device_brand	文本	激活时的设备品牌	用户设备的设备平台，如 Galaxy、Pixel	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_device_model	文本	激活时的设备型号	用户设备的型号，如 iPhone 8 等	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_screen_height	数值	激活时的屏幕高度	用户设备的屏幕高度，如 1920 等	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_screen_width	数值	激活时的屏幕宽度	用户设备的屏幕高度，如 1080 等	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_memory_used	文本	激活时的设备内存使用状态	用户设备的当前剩余内存和总内存，如 1.4GB/2.4GB	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_storage_used	文本	激活时的设备存储空间状态	用户设备的当前剩余存储空间和总存储空间，如 30GB/200GB	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_network_type	文本	激活时的网络状态	nonetwork、wifi、2g、3g、4g、5g	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_simulator	布尔	激活时的是否是模拟器	是否是模拟器	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#active_user_agent	文本	激活时的系统默认用户代理	是 Http 请求协议中请求头的一部分，例如：Dalvik/2.1.0 （Linux； U; Android 12; Pixel 4 Build/SQ3A.220605.009.A1)	标记用户第一次的属性，所以通过user_set_once进行，且安装后只上报一次
#latest_firebase_iid	文本	当前的 Firebase App Instance ID	Firebase 的 app_instance_id，用于事件分析时关联，如 cf546ab0543d1f0122677333527edfe4	调用三方关联ID
#latest_kochava_id	文本	当前的 Kochava ID	Kochava ID，用于关联 Kochava	调用三方关联ID
#latest_appsflyer_id	文本	当前的 AppsFlyer ID	AppsFlyer ID，用于关联 AppsFlyer	调用三方关联ID
#latest_adjust_id	文本	当前的 Adjust ID	Adjust ID，用于关联 Adjust	调用三方关联ID
#latest_app_version_code	数值	当前的应用版本号	用户当前的应用版本号	标记用户最新的属性，所以每次启动都会上报
#latest_app_version_name	文本	当前的应用版本名	用户当前的应用版本名	标记用户最新的属性，所以每次启动都会上报
#latest_event_time	日期和时间	当前的事件时间	最后一次客户端 SDK 上报属性里的 event_time，时间戳，精确到毫秒	标记用户最新的属性，所以每次启动都会上报
#latest_debug	布尔	当前的 debug 状态	true：处于 debug 状态 false：不处于 debug 状态	标记用户最新的属性，所以每次启动都会上报

上一个

接入指南

下一个

客户端

最近修改: 2025-06-11

大纲