监测追踪集成（微信小程序）

监测追踪（微信小程序）集成步骤

前提条件

版本要求

微信小程序SDK：v1.21.5 及以上版本

集成 SDK 并初始化

集成微信小程序 SDK 并完成初始化，需要完成

代码集成示例

下载完成后，使用目录中如下文件

// 先 import 微信小程序的代码
import sensors from '/dist/wechat/sensorsdata.esm.js';
// 再引入 SAT 渠道插件的代码
import channel from '/dist/wechat/plugin/ad-channel/index.esm'; 
//  使用 SAT 渠道插件的代码
sensors.use(channel); 
// 初始化微信小程序 SDK
sensors.init({ //.... })

小程序内嵌网页场景（按需）

推广小程序内嵌网页时使用，请确保您的小程序已开发内嵌网页功能，同时小程序与网页SDK更新至指定版本，并集成新功能插件。

微信小程序SDK版本：v1.21.5+
微信小程序SDK adChannelHLinker插件：https://github.com/sensorsdata/sa-sdk-miniprogram/tree/master/dist/wechat/plugin/ad-channel-h5-linker/
Web JS SDK版本：v1.27.4+
Web JS SDK wechatWebviewChannel插件：https://github.com/sensorsdata/sa-sdk-javascript/tree/master/dist/web/plugin/wechat-webview-channel

需注意，adChannelHLinker不能与ad-channel、h5-linker插件共同使用（已包含后边两个插件功能，需删除原插件）

特殊场景：

字节-巨量广告升级版推广微信小程序

字节巨量广告升级版在推广微信小程序场景，会在微信小程序链接上拼接项目id、广告id、素材ID、请求ID等信息，未避免因拼接参数过长，导致归因相关的事件上报数据被截断，请调整微信小程序SDK初始化参数max_string_length的长度，max_string_length长度超过1024，服务端亦需要同步调整，请联系神策值班人员。

同时应字节要求，回传用户行为时需要回传用户的微信小程序openId。故在集成微信小程序SDK后，需要进行如下开发：

在小程序中获取openId，并赋值到指定的属性中：

1、获取微信小程序openId，参考微信开放平台文档：https://developers.weixin.qq.com/community/develop/article/doc/00082a04b94c00a9f3eb879ba5ac13

2、将获取到的openid, 使用神策「静态公共属性」赋值到 sat_sc_wechat_openid 。参考文档：https://manual.sensorsdata.cn/sa/docs/tech_sdk_client_mp_wechat_api/v0300

如果开启了强校验，需要通过元数据管理->事件属性预先创建 sat_sc_wechat_openid 属性：

如未开启强校验，则不需要上述处理。