菜单

预置属性总表格

注意

  • 由于 iOS 系统限制，iOS 16.4 及以上版本，iOS SDK 无法采集运营商信息。即，iOS 16.4 及以上系统，iOS SDK 所有事件，都没有预置属性 $carrier（参考：iOS & iPadOS 16.4 Release Notes）
  • iOS SDK v4.8.3 及以上，不再采集 $carrier
  • Android SDK v6.8.0 及以上，不再采集 $carrier

 

预置事件属性

类别 属性名 属性显示名

数据类型

 详细说明

是否自动采集

是否支持关闭

是否默认显示

 隐私风险相关 采集端
保留属性 distinct_id 用户 ID STRING

登录前为匿名 ID，一般为设备 ID

登录后为登录 ID

更多详情参考标识用户——简易用户关联（IDM 2.0 & IDM 1.0）

 是 否 / 高
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
  • 后端 SDK
time 时间 DATETIME

事件触发的时间（精确：毫秒）

 是 否 / 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
  • 后端 SDK
基础预置属性 $app_state App 状态 STRING

App 当前的状态

仅 $AppStartPassively 具有此属性

 是 否 是 无
  • iOS SDK
$app_id 应用唯一标识 STRING

App 的标识

Android、iOS、小程序具有此属性

 是 否 是 无
  • Android SDK
  • iOS SDK
  • 小程序 SDK
$app_name 应用名称 STRING 应用名称 是 否 是 无
  • Android SDK
  • iOS SDK
$app_version 应用版本 STRING App 的版本号 是 否 是 低
  • Android SDK
  • iOS SDK
$resume_from_background 是否从后台唤醒 BOOL App 是否从后台唤醒 是 否 是 无
  • Android SDK
  • iOS SDK
$is_first_day 是否首日访问 BOOL

事件是否在首日触发，服务端进行二次修正

更多详情参考新增用户及首日首次标记 

 是 否 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$is_first_time 是否首次触发事件 BOOL

是否当前用户第一次触发此事件，服务端进行二次修正

更多请参考新增用户及首日首次标记

 是 否 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$timezone_offset 时区偏移量 NUMBER 设备所在的时区偏移量的分钟数 * -1 是 否 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$event_duration 事件时长 NUMBER 事件的持续时长（单位：秒） 是 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$latitude 纬度 NUMBER 纬度，iOS 和 Android 需要手动开启 否 是 是 高
  • Android SDK
  • iOS SDK
  • 小程序 SDK
$longitude 经度 NUMBER 经度，iOS 和 Android 需要手动开启 否 是 是 高
  • Android SDK
  • iOS SDK
  • 小程序 SDK
$title 页面标题 STRING

Android：Activity 的 android:label 属性值

iOS：ViewController 的 title 或 titleView 上的文本信息

 是 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$screen_name 页面名称 STRING

Android：Activity 或 Fragment 对应的包名.类名

iOS：ViewController 的类名

 是 是 是 低
  • Android SDK
  • iOS SDK
$app_crashed_reason 崩溃原因 STRING App 崩溃时的调用栈信息 否 是 是 无
  • Android SDK
  • iOS SDK
$url 页面地址 STRING

Android(v3.2.8+ 支持)、iOS( v1.11.5 )：值同 $screen_name

Web JS：windows.location.href

 否 否 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$url_host 页面地址域名 STRING

页面地址域名

 是 否 是 低
  • Web SDK
$url_query 页面参数 STRING H5 页面 URL 中”?“之后内容 是 是 是 低
  • 小程序 SDK
$url_path 页面路径 STRING H5 页面 URL 中 ”/“ 和 ”?“ 之间内容 是 是 是 低
  • Web SDK
  • 小程序 SDK
$referrer 前向地址 STRING

上一页面的 $url 信息

微信小程序为上一页面的 $url_path

 是 是 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$referrer_host 前向域名 STRING $referrer 中 host 部分 是 是 是 中
  • Web SDK
$referrer_title 前向页面标题 STRING 上一页面的页面标题 否 是 是 无
  • 小程序 SDK
$user_agent UserAgent STRING UserAgent，服务端解析获取 否 是 否 中 /
$scene 启动场景 STRING 打开小程序时的场景信息 是 是 是 低
  • 小程序 SDK
$share_depth 分享次数 NUMBER

当前用户在分享链上的层级

如.原始访问者为 0，通过原始访问者分享打开页面的访问者为 1

 是 是 是 中
  • 小程序 SDK
$share_distinct_id 分享者 STRING 当前小程序分享者的用户 ID 是 是 是 中
  • 小程序 SDK
$share_url_path 分享路径 STRING 小程序被分享时的路径信息 是 是 是 低
  • 小程序 SDK
$share_method 分享时途径 STRING 小程序被分享时的途径，朋友圈分享、转发消息卡片等 是 是 是 低
  • 小程序 SDK
$source_package_name 来源应用包名 STRING

来源应用的包名

 是 是 是 中  
$bot_name 爬虫名称 STRING SDK 判断为爬虫访问时，才会尝试解析此值 是 是 是 低
  • 小程序 SDK
$viewport_height 视区高度 NUMBER 浏览器实际视区高度（单位：px） 否 是 是 低
  • Web SDK
$viewport_position 视区距顶部的位置 NUMBER

单位：px

若页面没有滚动条，则此属性为 0

 否 是 是 低
  • Web SDK
$viewport_width 视区宽度 NUMBER 浏览器实际视区宽度（单位：px） 否 是 是 低
  • Web SDK
$item_join Item 匹配模式 - 对应维度表的名称 否 是 是 无  
$receive_time $receive_time NUMBER 服务端接收到该条事件的时间 是 否 否 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
  • 后端 SDK
$lib_plugin_version SDK 插件版本号  LIST  神策分析各插件的版本号 是 否 否 无
  • Android SDK
  • iOS SDK
设备相关 $brand 设备品牌 STRING 设备品牌 是 否 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$manufacturer 设备制造商 STRING 设备制造商 是 否 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$model 设备型号 STRING 设备型号 是 否 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$os 操作系统 STRING 操作系统 是 否 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$os_version 操作系统版本 STRING 操作系统版本号 是 否 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$screen_height 屏幕高度 NUMBER 手机屏幕高度 是 否 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$screen_width 屏幕宽度 NUMBER 手机屏幕宽度 是 否 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$wifi 是否 WIFI BOOL 是否 WIFI 网络 是 否 是 低
  • Android SDK
  • iOS SDK
$carrier 运营商 STRING 设备运营商信息 是 否 是 中
  • Android SDK（v6.8.0 开始不再采集）
  • iOS SDK（v4.8.3 开始不再采集）
$network_type 网络类型 STRING 网络类型 是 否 是 低
  • Android SDK
  • iOS SDK
  • 小程序 SDK
$device_id 设备 ID STRING

Android：AndroidID

iOS：IDFA 或 IDFV

 否 否 是 高
  • Android SDK
  • iOS SDK
$screen_orientation 屏幕方向 STRING

设备当前方向（横屏或竖屏）

 否 是 是 低
  • Android SDK
  • iOS SDK
浏览器相关 $browser 浏览器 STRING 浏览器 是 否 是 中
  • Web SDK
  • 小程序 SDK
$browser_language 用户浏览器语言 STRING 用户浏览器语言 是 否 是 无
  • Web SDK
$browser_version 浏览器版本 STRING 浏览器版本 是 否 是 中
  • Web SDK
  • 小程序 SDK
点击事件相关 $element_id 元素 ID STRING Android：控件 android:id 是 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
$element_name 元素名称 STRING 元素名称 是 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
$element_type 元素类型 STRING 控件的类型 是 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
$element_content 元素内容 STRING 元素内容 是 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
$element_position 元素位置 STRING 被点击元素在列表控件内的位置 是 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
$element_selector 元素选择器 STRING

元素的路径信息

App 热力分析使用此属性进行匹配

 否 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
$element_path 元素路径 STRING

元素路径信息

可视化全埋点使用此属性进行匹配

 否 是 是 低
  • Android SDK
  • iOS SDK
  • Web SDK
$element_target_url 元素链接地址 STRING 元素链接地址 是 是 是 低
  • Web SDK
$element_class_name 元素样式名 STRING 元素样式名 是 是 是 低
  • Web SDK
$page_x 页面 X 坐标 NUMBER 点击时页面的 X 坐标值 是 是 是 低
  • Web SDK
$page_y 页面 Y 坐标 NUMBER 点击时页面的 Y 坐标值 是 是 是 低
  • Web SDK
latest 相关属性 $latest_referrer 最近一次站外地址 STRING 最近一次站外地址 是 是 是 中
  • Web SDK
$latest_referrer_host 最近一次站外域名 STRING 最近一次站外域名 否 是 是 中
  • Web SDK
$latest_search_keyword 最近一次搜索引擎关键词 STRING 由 $latest_referrer 解析出的搜索关键词 是 是 是 中
  • Web SDK
$latest_traffic_source_type 最近一次流量来源类型 STRING 最近一次流量来源类型 是 是 是 中
  • Web SDK
$latest_landing_page 最近一次落地页 STRING 最近一次落地页 否 是 是 中
  • Web SDK
$latest_utm_campaign 最近一次广告系列名称 STRING 最近一次广告系列名称 是 是 是 中
  • Web SDK
$latest_utm_content 最近一次广告系列内容 STRING 最近一次广告系列内容 是 是 是 中
  • Web SDK
$latest_utm_medium 最近一次广告系列媒介 STRING 最近一次广告系列媒介 是 是 是 中
  • Web SDK
$latest_utm_source 最近一次广告系列来源 STRING 最近一次广告系列来源 是 是 是 中
  • Web SDK
$latest_utm_term 最近一次广告系列字词 STRING 最近一次广告系列字词 是 是 是 中
  • Web SDK
$latest_scene 最近一次启动场景 STRING 最近一次启动场景 是 是 是 低
  • 小程序 SDK
$latest_share_method 最近一次分享时途径 STRING 最近一次分享时途径 是 是 是 低
  • 小程序 SDK
$latest_share_distinct_id 最近一次分享者 STRING 最近一次分享者 是 是 是 低
  • 小程序 SDK
$latest_share_depth 最近一次分享深度 NUMBER 最近一次分享深度 是 是 是 低
  • 小程序 SDK
$latest_share_url_path 最近一次分享路径 STRING 最近一次分享路径 是 是 是 低
  • 小程序 SDK
SDK 相关 $lib SDK 类型 STRING SDK 类型，如 Android、iOS 是 否 是 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$lib_version SDK 版本 STRING SDK 版本 是 否 否 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$lib_method 埋点方式 STRING

埋点的触发方式（全埋点、自定义埋点）

web 和小程序 SDK 统一为自定义埋点

 是 否 否 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$lib_detail 埋点细节 STRING 触发埋点时的调用栈信息 是 是 否 无
  • Android SDK
  • iOS SDK
渠道相关 $ios_install_source App 渠道匹配所需要的设备指纹信息 STRING Android：IMEI 信息
iOS：IDFA 信息

属性不入库

服务端进行渠道匹配后将属性删除

 否 是 / 高
  • Android SDK
  • iOS SDK
$channel_device_info App 渠道匹配所需要的设备指纹信息（与上方事件变量名不同） STRING

属性不入库

服务端进行渠道匹配后将属性删除

 否 是 / 高
  • Android SDK
  • iOS SDK
$ios_install_disable_callback 是否不进行追踪回调 BOOL 是否不进行追踪回调 否 是 是 低
  • Android SDK
  • iOS SDK
$is_channel_callback_event 是否进行渠道匹配回调 BOOL 事件渠道匹配结果是否需要回调给渠道商 否 是 否 低
  • Android SDK
  • iOS SDK
$channel_extra_information 渠道额外信息 STRING

渠道监测链接中添加的额外信息

如 IMEI、OAID

 否 是 否 高

/
$utm_matching_type 渠道追踪匹配模式 STRING 模糊匹配、精准匹配 否 是 是 低
  • Android SDK
  • iOS SDK
$utm_source 广告系列来源 STRING 广告系列来源 否 是 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$utm_medium 广告系列媒介 STRING 广告系列媒介 否 是 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$utm_term 广告系列字词 STRING 广告系列字词 否 是 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$utm_content 广告系列内容 STRING 广告系列内容 否 是 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$utm_campaign 广告系列名称 STRING 广告系列名称 否 是 是 中
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$matched_key 渠道匹配关键字 STRING

在 App 端采集事件时默认没有该属性，而是在 extractor 模块添加，是App 渠道追踪匹配成功时，记录匹配关键字段，比如是用 IMEI 匹配成功的，则记录 md5 后的IMEI，如果是用 IP_UA  的方式匹配成功的，则记录为 IP_UA。如果没有匹配成功，该属性值在事件分析页面展示为「未知」。

 否 是 是 高
  • Android SDK
  • iOS SDK
$matching_key_list 渠道匹配关键字列表 STRING

在 App 端采集事件时默认没有该属性，而是在 extractor 模块添加，是记录该激活事件所有可匹配的关键字，比如 md5 后的 IMEI，Android ID，oaid ，IP_UA 等。在匹配的时候，会按照这些关键字的优先级，和点击广告时记录的关键字进行匹配。

 否 是 否 高
  • Android SDK
  • iOS SDK
$short_url_key 短链 Key STRING

短链 URL 中 path 的最后一个节点值

 否 是 是 低 /
$short_url_target 短链目标地址 STRING 短链所对应的完整 URL 否 是 是 低 /
$channel_active_period_day 有效激活窗口期（天） NUMBER 记录窗口期配置的信息，因窗口期变化造成的激活变化也可进行溯源 是 否 是 无 /
$channel_callback_period_day 深度回传归因窗口期（天） NUMBER 是 否 是 无 /
$channel_attribute_period_hour 激活归因窗口期（小时） NUMBER 是 否 是 无 /
$channel_name 渠道名称 STRING 与前端广告数据关联，生成投放分析报表时做关联、筛选 是 否 是 无 /
$channel_account_id 渠道广告主 ID STRING 是 否 是 无 /
$channel_campaign_id 渠道广告计划 ID STRING 是 否 是 无 /
$channel_adgroup_id 渠道广告组 ID STRING 是 否 是 无 /
$channel_ad_id 渠道广告创意 ID STRING 是 否 是 无 /
$channel_click_id 渠道监测点击 ID STRING 与广告平台核对点击数据 是 否 是 无 /
$channel_active_result 渠道有效激活标识 BOOL   是 否 是 无 /
IP 相关 $ip IP STRING Nginx 解析 是 否 是 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$city 城市 STRING 根据 IP 解析 是 否 是 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$province 省份 STRING 根据 IP 解析 是 否 是 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$country 国家 STRING 根据 IP 解析 是 否 是 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$ip_isp IP 运营商 STRING 根据 IP 解析 是 否 是 无
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
用户关联相关 $is_login_id 是否登录 ID BOOL 事件的 distinct_id 是否为登录 ID，事件入库时添加 是 否 否 低
  • 后端 SDK
$track_signup_original_id 关联原始 ID STRING 用户登录时，用于关联的匿名 ID 是 否 是 高 /
通用数据接入 $data_ingestion_source 数据接入来源 LIST 数据接入来源 是 否 是 无 /
$data_ingestion_job_id 数据接入任务 ID STRING 数据接入任务 ID 是 否 是 无 /
item 相关预置属性

 item_id 物品 ID STRING 物品 ID 是 否 是 低 /
item_type 物品类型 STRING 物品类型 是 否 是 低 /
$create_time 到达时间 NUMBER 创建时间 是 否 是 低 /
$update_time 更新时间 NUMBER 更新时间 是 否 是 低 /

预置用户属性

属性名 属性显示名

数据类型
$city 城市 STRING
$country 国家 STRING
$province 省份 STRING
$first_browser_charset 首次浏览器字符类型 STRING
$first_browser_language 浏览器语言 STRING
$first_referrer 首次前向地址 STRING
$first_referrer_host 首次前向域名 STRING
$first_search_keyword 首次搜索引擎关键词 STRING
$first_traffic_source_type 首次流量来源类型 STRING
$first_visit_time 首次访问时间 DATETIME
$utm_campaign 首次广告系列名称 STRING
$utm_content 首次广告系列内容 STRING
$utm_matching_type 渠道追踪匹配模式 STRING
$utm_medium 首次广告系列媒介 STRING
$utm_source 首次广告系列来源 STRING
$utm_term 首次广告系列字词 STRING
$update_time $update_time NUMBER
$first_channel_name 首次渠道名称 STRING
$first_channel_account_id 首次渠道广告主 ID STRING
$first_channel_campaign_id 首次渠道广告计划 ID STRING
$first_channel_adgroup_id 首次渠道广告组 ID STRING
$first_channel_ad_id 首次渠道广告创意 ID STRING
$first_channel_click_id 首次渠道监测点击 ID STRING

 

本文档仅收录通用的预置属性，关于智能运营、渠道追踪等模块的预置属性，请访问对应文档查看

 

 

上一个
预置事件与预置属性
下一个
App SDK 预置事件和预置属性
最近修改: 2025-01-19