1. 监测追踪集成步骤

1.1. 前提条件

版本要求

  • Web JS SDK:v1.16.8 及以上版本

1.2. 集成 SDK 

集成 Web JS SDK ,可以采用如下不同的集成方式进行集成,需要完成

1.3. 引入渠道插件

渠道插件引入(仅广告渠道需要,通用渠道不需要,如需配置 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>
JS


! 注意:如果是 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>
JS

2. 常见问题

2.1. 网页监测链接中是否可以添加自定义属性?

可以的,需要按如下步骤操作:

第一步:在投放链接中添加自定义属性,比如 hmrs:

https://sdkdebugtest.cloud.sensorsdata.cn/?hmsr=shence&utm_source=baidu

第二步:在JS SDK 的初始化代码中配置 source_channel:['hmsr']

$pageview  事件会采集到 $utm_source:"baidu" 和 hmsr:"shence" 属性。如果是新用户第一次访问,也会设置用户属性 hmsr:"shence" 。

2.2. 如果服务端有埋点的事件,是否可以获取网页端的渠道信息,传给服务端的事件?

可以通过 Web 提供的获取公共预置属性属性的接口 sensors.getPresetProperties();,获取 $latest_utm_source 等相关的最近一次广告系列来源,然后让客户自己实现将获取的属性传给服务端的事件,作为事件属性。

具体可以参考此文档: