注意

由于 iOS 系统限制,iOS 16.4 及以上版本,iOS SDK 无法采集运营商信息。即,iOS 16.4 及以上系统,iOS SDK 所有事件,都没有预置属性 $carrier。

参考:iOS & iPadOS 16.4 Release Notes


预置事件属性

类别属性名属性显示名

数据类型

详细说明

是否自动采集

是否支持关闭

是否默认显示

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

登录前为匿名 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_stateApp 状态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应用版本STRINGApp 的版本号
  • Android SDK
  • iOS SDK
$resume_from_background是否从后台唤醒BOOLApp 是否从后台唤醒
  • 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崩溃原因STRINGApp 崩溃时的调用栈信息
  • 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页面参数STRINGH5 页面 URL 中”?“之后内容
  • 小程序 SDK
$url_path页面路径STRINGH5 页面 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_agentUserAgentSTRINGUserAgent,服务端解析获取/
$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爬虫名称STRINGSDK 判断为爬虫访问时,才会尝试解析此值
  • 小程序 SDK
$viewport_height视区高度NUMBER浏览器实际视区高度(单位:px)
  • Web SDK
$viewport_position视区距顶部的位置NUMBER

单位:px

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

  • Web SDK
$viewport_width视区宽度NUMBER浏览器实际视区宽度(单位:px)
  • Web SDK
$item_joinItem 匹配模式-对应维度表的名称
$receive_time$receive_timeNUMBER服务端接收到该条事件的时间
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
  • 后端 SDK
$lib_plugin_versionSDK 插件版本号 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是否 WIFIBOOL是否 WIFI 网络
  • Android SDK
  • iOS SDK
$carrier运营商STRING设备运营商信息
  • Android SDK
  • iOS SDK
$network_type网络类型STRING网络类型
  • Android SDK
  • iOS SDK
  • 小程序 SDK
$device_id设备 IDSTRING

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元素 IDSTRINGAndroid:控件 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 相关$libSDK 类型STRINGSDK 类型,如 Android、iOS
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
$lib_versionSDK 版本STRINGSDK 版本
  • 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_sourceApp 渠道匹配所需要的设备指纹信息STRINGAndroid:IMEI 信息
iOS:IDFA 信息

属性不入库

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

/
  • Android SDK
  • iOS SDK
$channel_device_infoApp 渠道匹配所需要的设备指纹信息(与上方事件变量名不同)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

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

  • Android SDK
  • iOS SDK
$short_url_key短链 KeySTRING

短链 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渠道广告主 IDSTRING/
$channel_campaign_id渠道广告计划 IDSTRING/
$channel_adgroup_id渠道广告组 IDSTRING/
$channel_ad_id渠道广告创意 IDSTRING/
$channel_click_id渠道监测点击 IDSTRING与广告平台核对点击数据/
$channel_active_result渠道有效激活标识BOOL
/
IP 相关$ipIPSTRINGNginx 解析
  • 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_ispIP 运营商STRING根据 IP 解析
  • Android SDK
  • iOS SDK
  • Web SDK
  • 小程序 SDK
用户关联相关$is_login_id是否登录 IDBOOL事件的 distinct_id 是否为登录 ID,事件入库时添加
  • 后端 SDK
$track_signup_original_id关联原始 IDSTRING用户登录时,用于关联的匿名 ID/
通用数据接入$data_ingestion_source数据接入来源LIST数据接入来源/
$data_ingestion_job_id数据接入任务 IDSTRING数据接入任务 ID/
item 相关预置属性

item_id物品 IDSTRING物品 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_timeNUMBER
$first_channel_name首次渠道名称STRING
$first_channel_account_id首次渠道广告主 IDSTRING
$first_channel_campaign_id首次渠道广告计划 IDSTRING
$first_channel_adgroup_id首次渠道广告组 IDSTRING
$first_channel_ad_id首次渠道广告创意 IDSTRING
$first_channel_click_id首次渠道监测点击 IDSTRING


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