监测追踪集成步骤
前提条件
版本要求
- Web JS SDK:v1.16.8 及以上版本
集成 SDK
集成 Web JS SDK ,可以采用如下不同的集成方式进行集成,需要完成
- 集成神策分析 SDK
- 配置项目数据接收地址
- 开启全埋点 (按需,配置后可查看全埋点上报事件归因结果)
引入渠道插件
渠道插件引入(仅广告渠道需要,通用渠道不需要,如需配置 Web 深度回传事件,也需要引入此插件),详细参照:
如需使用微信广告 Web 端监测追踪,需要开启微信广告渠道采集功能,更多配置请参照:SDK API(Web)
<script charset='UTF-8' src="在 github 下载新版本的 sensorsdata.min.js"></script>
<script>
var sensors = window['sensorsDataAnalytic201505'];
sensors.init({
server_url: '数据接收地址',
heatmap:{scroll_notice_map:'not_collect'},
is_track_single_page:true,
use_client_time:true,
send_type:'beacon',
// 配置 preset_properties 开启微信广告渠道采集
preset_properties:{
latest_wx_ad_click_id:true
}
});
// 使用 use 初始化渠道插件
sensors.use('SensorsChannel');
sensors.quick('autoTrack');
</script>
! 注意:如果是 SA 云版用户 ,集成渠道插件后必须再集成 sat-props-patch 插件。集成示例参考如下代码:
<script charset='UTF-8' src="在 github 下载新版本的 sensorsdata.min.js"></script>
<!-- SA 云版用户新增引入 sat-props-patch 插件,该插件在 SDK 目录中 dist/web/plugin/sat-props-patch/index.js -->
<script charset='UTF-8' src="在 github 下载新版本的 sat-props-patch 插件"></script>
<script>
var sensors = window['sensorsDataAnalytic201505'];
sensors.init({
server_url: '数据接收地址',
heatmap:{scroll_notice_map:'not_collect'},
is_track_single_page:true,
use_client_time:true,
send_type:'beacon',
// 配置 preset_properties 开启微信广告渠道采集
preset_properties:{
latest_wx_ad_click_id:true
}
});
// 使用 use 初始化渠道插件
sensors.use('SensorsChannel');
// SA 云版用户需要增加如下代码
sensors.use('SatPropsPatch');
sensors.quick('autoTrack');
</script>
常见问题
网页监测链接中是否可以添加自定义属性?
可以的,需要按如下步骤操作:
第一步:在投放链接中添加自定义属性,比如 hmrs:
https://sdkdebugtest.cloud.sensorsdata.cn/?hmsr=shence&utm_source=baidu
第二步:在JS SDK 的初始化代码中配置 source_channel:['hmsr']
$pageview 事件会采集到 $utm_source:"baidu" 和 hmsr:"shence" 属性。如果是新用户第一次访问,也会设置用户属性 hmsr:"shence" 。
如果服务端有埋点的事件,是否可以获取网页端的渠道信息,传给服务端的事件?
可以通过 Web 提供的获取公共预置属性属性的接口 sensors.getPresetProperties();
,获取 $latest_utm_source 等相关的最近一次广告系列来源,然后让客户自己实现将获取的属性传给服务端的事件,作为事件属性。
具体可以参考此文档: