1. 预置事件

事件英文变量名	事件显示名	属性英文变量名	事件属性显示名	属性值类型	属性值示例或说明	触发时机	备注
$pageview	Web 浏览页面		$预置属性			打开一个页面时自动采集，根据 autoTrack 的触发进行上报记录，触发时机可以自定义配置，一般建议放在初始化神策 SDK 后立刻执行。	JS SDK通用性采集，打开autoTrack接口后会自动采集，参考文档：JS SDK https://www.sensorsdata.cn/manual/js_sdk.html UTM广告系列参数，可用来进行渠道追踪，参考文档： https://manual.sensorsdata.cn/sa/latest/channel_tracking-22258121.html
		$is_first_time	是否首次	布尔值	新用户首次访问页面时，触发的第一个 $pageview ，该属性值为 true，后续再触发 $pageview 事件时，该属性都为 false。
		$url_path	页面路径	字符串
		$referrer_host	前向域名	字符串	如果直接打开页面，值为空字符串
		$referrer	前向地址	字符串	如果直接打开页面，值为空字符串
		$utm_campaign	广告系列名称	字符串	打开页面的 url 有该参数就采集
		$utm_source	广告系列来源	字符串	打开页面的 url 有该参数就采集
		$utm_medium	广告系列媒介	字符串	打开页面的 url 有该参数就采集
		$utm_term	广告系列字词	字符串	打开页面的 url 有该参数就采集
		$utm_content	广告系列内容	字符串	打开页面的 url 有该参数就采集
$WebClick	Web 元素点击		$预置属性			点击一个元素/控件/按钮（可扩展）时自动采集	JS SDK通用性采集，打开autoTrack接口后会自动采集，参考文档：全埋点和点击图(Web)
		$element_id	元素ID	字符串	元素有 id 属性才采集
		$element_content	元素内容	字符串	元素标签对直接的文本，例如：<a><span>提交</span></a>，采集的是 “提交”
		$element_name	元素名字	字符串	元素有 name 属性的时候才采集
		$element_class_name	元素样式名	字符串	元素有 class 属性的时候才采集
		$element_type	元素类型	字符串	默认采集
		$element_selector	元素选择器	字符串	默认采集
		$element_target_url	元素链接地址	字符串	a 标签默认采集
		$url_path	页面路径	字符串
		$element_path	DOM 树结构的body 后对应结点	字符串	默认采集。优先从最近根路径中有 id 的元素取，所有根路径都没有 id 时取所有路径的拼接，中间加上 ’>‘ 。元素有 id 名称，在元素类型后加 '#'。
		$element_position	元素叶子结点序号	字符串	页面 li 标签以及 li 标签内的子标签（即叶子结点为 li 标签或叶子结点的父节点或父父节点为 li 标签）时采集。
		$page_x	点击位置距网页左侧距离	数值	1.21.5 版本开始采集 $page_x 和 $page_y。
		$page_y	点击位置距网页顶部距离	数值	1.21.5 版本开始采集 $page_x 和 $page_y。
$WebStay	Web 视区停留		$预置属性			有效停留：关注网页区域不滚动，期间鼠标可以移动、点击等操作。有效停留时间：停留时间超过规定的时间，javascript sdk 中默认为 4 秒(参数可设置)。如果发生页面滚动时候，之前的页面停留是有效停留，也就是超过默认的4秒或者自定义的时间，javascript sdk就会发送一次页面停留事件。	若要使用神策分析中热力图-触达率图的功能，则需采集此事件。事件触发条件：在一个页面停留4秒以上并进行有效滑动则触发。不支持增加自定义属性
		$viewport_width	视区宽度	数值	视区宽度（当前浏览器的可视区域的宽度，单位是 px。）
		$viewport_position	视区距顶部的位置	数值	视区距顶部的位置（当前滚动条所在位置，距离页面顶部的高度，单位是 px。）
		$viewport_height	视区高度	数值	视区高度（当前浏览器的可视区域的高度，单位是 px。）
		$event_duration	停留时长	数值	距上次触发 scroll 事件的时间差。页面没有操作，超过 4 秒后滚动页面触发一次事件。如果页面有滚动，时长清零。
		$url_path	页面路径	字符串
$WebPageLeave	Web 页面浏览时长		$预置属性			页面的「活跃状态切换」(页面失去焦点/获得焦点、切换窗口最小化、切换浏览器 tab、电脑睡眠和唤醒)、「离开」(关闭窗口、页面跳转、刷新、浏览器前进后退)这两个生命周期触发 $WebPageLeave 事件，其中 event_duration 是指页面浏览的时长。	详细配置参考
		$url_path	页面路径	字符串
		$referrer_host	前向域名	字符串	如果直接打开页面，值为空字符串
		$referrer	前向地址	字符串	如果直接打开页面，值为空字符串
		$event_duration	浏览时长	数值	页面浏览时长，单位秒
		$viewport_position	视区距顶部的位置	数值	1.21.5 版本开始采集。视区距顶部的位置（当前滚动条所在位置，距离页面顶部的高度，单位是 px。）		1.21.5 版本支持
$WebPageLoad	Web 页面加载时长		$预置属性			使用 performance API 计算页面加载时长，监听页面加载完成，触发 $WebPageLoad 事件。	详细配置参考
		$url_path	页面路径	字符串
		$referrer_host	前向域名	字符串	如果直接打开页面，值为空字符串
		$referrer	前向地址	字符串	如果直接打开页面，值为空字符串
		$event_duration	加载时长	数值	页面加载时长，单位秒
		$page_resource_size	页面资源大小	数值	1.21.7 版本开始采集，页面资源大小，单位是 kb，大小限制大于 0，小于 10G 采集，不满足则不采集。

2. 所有事件都有的预置属性

属性名	属性类型	默认显示名	说明	备注
$lib	字符串	SDK 类型	SDK 类型
$lib_version	字符串	SDK 版本	SDK 版本
$lib_method	字符串	埋点方式	埋点方式，目前值统一为 code
$screen_height	数值	屏幕高度	屏幕高度，采集的是像素
$screen_width	数值	屏幕宽度	屏幕宽度，采集的是像素
$url_host	字符串	页面地址域名	由服务端进行解析，如果事件中上报了 $url，则会解析出来该属性
$is_first_day	布尔值	是否首日访问	表示是否是首日触发事件，可参考文档新增用户及首日首次标记	1.5 版本支持
$is_login_id	布尔值	是否登录 ID	数据入库时判断添加
$ip	字符串	IP	后端通过解析 HTTP 请求而得到
$timezone_offset	数值	时区偏移量	从浏览器的时间对象上直接获取	1.15.9 版本支持
$country	字符串	国家	由 IP 解析得到
$province	字符串	省份
$city	字符串	城市
$latest_referrer	字符串	最近一次站外地址	只要前向域名不是当前页面的域名，就会重置	1.6 版本支持
$latest_referrer_host	字符串	最近一次站外域名	1.14.8 及以上版本，默认不采集，需要手动设置 preset_properties 详细配置参考	1.6 版本支持
$latest_landing_page	字符串	最近一次落地页	1.14.8 及以上版本，默认不采集，需要手动设置 preset_properties 详细配置参考
$latest_utm_source	字符串	最近一次广告系列来源	使用 Web 渠道追踪后，只要 URL 中包含对应渠道信息（ utm_ 参数）就会重置	1.6 版本支持
$latest_utm_term	字符串	最近一次广告系列字词
$latest_utm_content	字符串	最近一次广告系列内容
$latest_utm_campaign	字符串	最近一次广告系列名称
$latest_utm_medium	字符串	最近一次广告系列媒介
$latest_search_keyword	字符串	搜索引擎关键词	由于各搜索引擎策略不同，可能有获取不到的情况	1.8 版本支持
$latest_traffic_source_type	字符串	最近一次流量来源类型		1.8 版本支持
$url	字符串	页面地址		1.16.5 版本将 $title 和 $url 设置为所有事件都有的属性
$title	字符串	页面标题		1.16.5 版本将 $title 和 $url 设置为所有事件都有的属性
$viewport_width	数值	视区宽度	视区宽度（当前浏览器的可视区域的宽度，单位是 px。）	1.21.5 版本将 $viewport_width 和 $viewport_height 设置为所有事件都有的属性
$viewport_height	数值	视区高度	视区高度（当前浏览器的可视区域的高度，单位是 px。）	1.21.5 版本将 $viewport_width 和 $viewport_height 设置为所有事件都有的属性
$page_height	数值	页面高度		1.21.5 版本集成页面高度插件会采集该属性

注意：
（1）其中 $latest_search_keyword 搜索引擎关键词由于各搜索引擎策略不同，可能有获取不到的情况。
（2）其中 $latest_traffic_source_type 这个的属性值包括：付费广告流量、自然搜索流量、社交网站流量、引荐流量、直接流量。
（3）最近一次付费广告相关参数是一个事件属性，且不需要做任何配置，会在所有事件中都存在。这个属性会保存最近一次有效的 utm_source 。

3. UserAgent 相关的预置属性

这一系列的属性从浏览器的 UserAgent 中进行解析。

字段名称	类型	说明	SDK 版本
$manufacturer	字符串	设备制造商	v1.6 及以上新解析方式支持
$model	字符串	设备型号
$os	字符串	操作系统
$os_version	字符串	操作系统版本
$browser	字符串	浏览器名
$browser_version	字符串	浏览器版本
$bot_name	字符串	爬虫名称

目前是通过 UA 判断并有一个默认的属性 $bot_name （爬虫名称），但是有两种情况无法判断：
第一种：如果 UA 里没有标明、且会触发 JS 脚本的非法爬虫。
第二种：如果爬虫没有触发 JS 脚本，那么也不会触发我们的 SDK ，所以本身就不会被统计到。
对于爬虫种类，目前已经支持了主流爬虫名称的解析，对于新增或其他小众类型的爬虫，会出现无法解析的情况。

4. 预置用户属性

属性名	属性类型	默认显示名	说明	备注
$first_visit_time	时间	首次访问时间	新用户首次访问网页时，会给此属性赋值	因为这些属性的设置时机是新用户首次访问网页时，才会设置这些属性，新用户一般是以匿名 ID 标记用户行为，如果登录 ID 和匿名 ID 关联失败，则登录 ID 不会有这些属性值。
$utm_source	字符串	首次广告系列来源	使用Web渠道追踪，且新用户首次访问时，通过带有 utm 参数的渠道访问时，才会采集这些用户属性。如果是老用户，即使通过渠道访问网页，也不会设置这些用户属性。新老用户的标记可以参考此文档：新增用户及首日首次标记
$utm_medium	字符串	首次广告系列媒介
$utm_term	字符串	首次广告系列字词
$utm_content	字符串	首次广告系列内容
$utm_campaign	字符串	首次广告系列名称
$first_referrer	字符串	首次前向地址	新用户第一次来到有神策 SDK 页面时的前向页面地址
$first_referrer_host	字符串	首次前向域名	新用户第一次来到有神策 SDK 页面时的前向页面域名
$first_browser_language	字符串	首次使用的浏览器语言	新用户第一次来到有神策 SDK 页面时的浏览器语言
$first_browser_charset	字符串	首次浏览器字符类型	SDK 1.8 及以上版本支持，新用户第一次来到有神策 SDK 页面时的浏览器字符类型
$first_search_keyword	字符串	首次搜索引擎关键词	SDK 1.8 及以上版本支持
$first_traffic_source_type	字符串	首次流量来源类型	SDK 1.8 及以上版本支持，这个的属性值包括：付费广告流量、自然搜索流量、社交网站流量、引荐流量、直接流量。

5. 渠道追踪相关的预置事件和预置属性

事件英文名	事件显示名	属性英文名	属性显示名	属性值类型	说明	触发时机
$ChannelLinkReaching	渠道链接触达		$预置属性			用户点击渠道链接到达落地页时，会采集该事件以及事件属性
		$first_channel_keyword_id	首次渠道关键词 ID	字符串	首次渠道关键词 ID
		$channel_keyword_id	渠道关键词 ID	字符串	渠道关键词 ID

6. A / B 测试的预置事件和预置属性

事件英文名	事件显示名	属性英文名	属性显示名	属性值类型	说明	触发时机
$ABTestTrigger	A / B 测试		$预置属性			命中实验，会采集该事件以及事件属性
		$abtest_experiment_id	实验 ID	字符串	实验 ID
		$abtest_experiment_group_id	实验分组 ID	字符串	实验分组 ID

7. 弹窗的预置事件和预置属性

事件英文名	事件显示名	属性英文名	属性显示名	属性值类型	说明	触发时机
$PlanPopupDisplay	弹窗展示		$预置属性			弹窗展示，会采集该事件以及事件属性
		$sf_plan_id	运营计划名称	字符串	实际上报的是 ID，会有一个维度字典映射到计划名称
		$sf_plan_type	计划类型	字符串	运营计划，流程画布，微信运营
		$sf_channel_service_name	消息发送服务商	字符串	SENSORS_FOCUS
		$sf_channel_category	消息通道类型	字符串	POPUP
		$sf_audience_id	运营受众 ID	字符串	受众 ID，仅当有受众规则时存在
		$sf_plan_strategy_id	实验组 ID	字符串	属性值0或-1， 0代表策略组，-1代表对照组
		$sf_succeed	消息发送成功	字符串	属性值 true 或 false ， true 代表成功， false 代表失败
		$sf_fail_reason	消息发送失败原因	字符串	如弹窗成功，显示未知
		$sf_msg_title	推送标题	字符串
		$sf_msg_content	推送内容	字符串
		$sf_platform_tag	端类型标签	字符串	ANDRIOD，IOS，H5，WEB
		$sf_msg_id	推送消息 ID	字符串
		$sf_lib_version	弹窗 SDK 版本	字符串	弹窗的 SDK 的对应版本号
		$sf_msg_image_url	图片链接	字符串	图片链接（图片 CDN 存储地址）
$PlanPopupClick	点击行为		$预置属性			弹窗点击，会采集该事件以及事件属性
		$sf_plan_id	运营计划名称	字符串	实际上报的是 ID，会有一个维度字典映射到计划名称
		$sf_plan_type	计划类型	字符串	运营计划，流程画布，微信运营
		$sf_channel_service_name	消息发送服务商	字符串	SENSORS_FOCUS
		$sf_channel_category	消息通道类型	字符串	POPUP
		$sf_audience_id	运营受众 ID	字符串	受众 ID，仅当有受众规则时存在
		$sf_plan_strategy_id	实验组 ID	字符串	属性值0或-1， 0代表策略组，-1代表对照组
		$sf_msg_title	推送标题	字符串
		$sf_msg_content	推送内容	字符串
		$sf_msg_element_type	弹窗按钮类型	字符串	弹窗元素类型：普通按钮、文字链接、图片链接、关闭 icon、蒙层
		$sf_msg_element_content	弹窗按钮文案	字符串	弹窗按钮文案，按钮独有
		$sf_msg_element_action	弹窗按钮行为	字符串	弹窗点击行为： URL 链接、自定义链接、关闭弹窗
		$sf_msg_image_url	图片链接	字符串	图片链接（图片 CDN 存储地址）
		$sf_msg_action_id	点击行为 ID	字符串
		$sf_platform_tag	端类型标签	字符串	ANDRIOD，IOS，H5，WEB
		$sf_msg_id	推送消息 ID	字符串
		$sf_close_type	关闭按钮类型	字符串	关闭按钮类型，只有关闭行为有：关闭蒙层、弹窗右上关闭 icon 、弹窗下部关闭 icon 、底部按钮（设置为关闭弹窗的按钮）
		$sf_lib_version	弹窗 SDK 版本	字符串