帮助中心 > 技术文档 > 客户端SDK > 小程序 SDK > 微信小程序 SDK >SDK配置

微信小程序SDK接入流程主要分为两个步骤（两个文档）：

1、SDK配置：将对应的SDK集成到您的产品项目中，然后进行初始化代码处理；
2、SDK接入：将需要埋点的数据，按照SDK包装不同的方法进行数据上送，其中功能主要包含两大类：全埋点（自动采集数据上送）、自定义埋点（手动设置业务数据上送）。


1. 集成SDK

下载请前往 【Web 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-07 16:15
最后编辑：王建华  更新时间：2024-09-05 21:06