海纳嗨数-帮助中心
SDK配置
帮助中心 > 技术文档 > 客户端SDK > 小程序 SDK > 微信小程序 SDK >SDK配置
微信小程序SDK接入流程主要分为两个步骤(两个文档):
1、SDK配置:将对应的SDK集成到您的产品项目中,然后进行初始化代码处理;
2、SDK接入:将需要埋点的数据,按照SDK包装不同的方法进行数据上送,其中功能主要包含两大类:全埋点(自动采集数据上送)、自定义埋点(手动设置业务数据上送)。
1. 集成SDK
下载请前往 【飞书小程序 SDK资源下载】
引入hinaSDK.esm.js到项目中
import ha from 'hinaSDK .esm.js'
// 配置初始化参数
hn.init({
name: 'hn',
// 配置采集上报地址URL(在线申请);
serverUrl: '数据接收地址',
// 全埋点控制开关
autoTrack:{
appLaunch: true, // 默认为 true,false 则关闭 H_MPLaunch 事件采集
appShow: true, // 默认为 true,false 则关闭 H_MPShow 事件采集
appHide: true, // 默认为 true,false 则关闭 H_MPHide 事件采集
pageShow: true, // 默认为 true,false 则关闭 H_MPViewScreen 事件采集
mpClick: false, // 默认为 false,true 则开启 H_MPClick 事件采集
pageLeave: false // 默认为 false, true 则开启 H_MPPageLeave事件采集
},
// 自定义渠道追踪参数,如 sourceChannel: ["custom_param"]
sourceChannel: [],
// 是否允许控制台打印查看埋点数据(建议开启查看)
showLog: true,
});
2. SDK 初始化参数说明
参数 | 类型 | 默认值 | 含义 | 备注 |
---|---|---|---|---|
name | String | hn | SDK 使用的一个默认的全局变量,会注册在 App 全局函数内,在 Page 中可以通过 app[name].track 来使用 | |
serverUrl | String | 数据接收地址 | ||
autoTrack | Object | 无 | 是否开启自动采集 | 六个属性参数( appLaunch、 appShow、 appHide、 pageShow、mpClick、pageLeave),其中 mpClick、 pageLeave 默认是 false,其他是 true。即默认采集五个事件 H_MPLaunch、H_MPShow、H_MPHide、H_MPViewScreen、H_MPLeave |
showLog | Boolean | true | 是否打印 log | 设置 true 后会在模拟器控制台打 log,会显示发送的数据,设置 false 表示不显示。 |
sendTimeout | Number | 1000 | 请求发送超时时间(如果一个请求发送后,超过规定时间没响应,则继续发送下一条数据) | 单位为毫秒; |
batchSend | Boolean | true | 小程序中是否使用批量发送数据功能 | |
sourceChannel | Array | 无 | 需要解析的渠道参数 | 默认情况下,只会解析参数 utm_source、 utm_content、 utm_campaign、 utm_medium、 utm_term 设置到预置事件中,可以通过配置该参数来解析其他自定义参数,例如[‘channel_code’],channelcode 属性会作为预置事件的预置属性,latestchannel_code 会作为所有事件的公共属性上报; |
注意
1、“数据接收地址”获取方式,请参考【采集上报地址获取】
2、更多初始化配置,请参考【SDK接入】
作者:张永健 创建时间:2024-03-18 15:19
最后编辑:张永健 更新时间:2024-11-22 16:31
最后编辑:张永健 更新时间:2024-11-22 16:31