帮助中心 > 技术文档 > 客户端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,         // 默认为 truefalse 则关闭 H_MPLaunch 事件采集
        appShow: true,           // 默认为 truefalse 则关闭 H_MPShow 事件采集
        appHide: true,           // 默认为 truefalse 则关闭 H_MPHide 事件采集
        pageShow: true,         // 默认为 truefalse 则关闭 H_MPViewScreen 事件采集
        mpClick: false,         // 默认为 falsetrue 则开启 H_MPClick 事件采集
        pageLeave: false         // 默认为 falsetrue 则开启 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