1. 集成神策分析 SDK
1.1. 引入 SDK
- 从 GitHub 上获取快手小程序 SDK 源码；
- 将 kuaishou-mp.min.js 文件放入小程序项目中；
- 在 app.js 文件中通过 import 方式引入并初始化 SDK。
import sensors from './utils/kuaishou-mp.min.js';
// 可通过 setPara() 进行 SDK 初始化参数配置：
sensors.setPara({
server_url: '您的数据接收地址',
// 是否允许控制台打印查看埋点数据(建议开启查看)
show_log: true
});
// 初始化 SDK
sensors.init();
App({
onLaunch: function(){
},
onShow: function(){
}
});
JS
- 快手小程序 SDK 压缩文件 kuaishou-mp.min.js 大小约为 17 KB
- 需要在 App 实例化之前调用 setPara() 和 init()，否则可能会造成部分预置事件丢失
- 在调用 init() 接口之前，采集的数据被缓存在内存中；调用 init() 接口后，会将缓存的数据通过网络发送出去。
2. SDK 基本配置
2.1. 配置项目数据接收地址
如下图所示获取数据接收地址：
2.2. 设置事件公共属性
对于所有事件都需要添加的属性，可在初始化 SDK 前，调用 registerApp() 将属性注册为公共属性：
// 在需要使用 SDK 接口的页面逻辑文件中，需要通过 import 将 SDK 引入，再调用相应接口
import sensors from '../../utils/kuaishou-mp.min.js'
sensors.registerApp({
userLever: 'VIP3',
userSex: '男'
});
JS
2.3. 用户登录
当用户注册成功或者登录成功时，需要调用 login() 方法传入登录 ID：
// 在需要使用 SDK 接口的页面逻辑文件中，需要通过 import 将 SDK 引入，再调用相应接口
import sensors from '../../utils/kuaishou-mp.min.js'
sensors.login("登录 ID");
JS
- 对于自动登录的用户，可以在 SDK 初始化前，获取登录 ID 并调用 login() 方法。
2.4. 代码埋点追踪事件
SDK 初始化后，可通过 track() 方法追踪用户行为事件，并为事件添加自定义属性：
sensors.track(event_name [,properties]);
JS
配置参数：
| 参数 | 必填 | 描述 |
|---|
| event_name | 是 | 事件名称 |
| properties | 否 | 为用户行为事件添加自定义属性，类型：Object。 |
示例：
// 为 pageview 事件添加自定义属性 title 值为首页。
// 在需要使用 SDK 接口的页面逻辑文件中，需要通过 import 将 SDK 引入，再调用相应接口
import sensors from '../../utils/kuaishou-mp.min.js'
Page({
onShow: function(){
sensors.track('pageview',{
title: '首页'
});
}
});
JS
3. 调试查看事件信息
3.1. 事件的触发日志
setPara() 配置初始化参数时，通过 show_log: true 打开 Log 功能且 SDK 完成初始化后（即 init() 方法调用后），快手小程序开发者工具 console 会打印采集的数据信息：
3.2. 事件的发送情况
事件数据发送成功时，可以在快手小程序开发者工具的 Network 模块中，可以看到 sa 的请求：
4. SDK 可选配置
4.1. 设置用户属性
setProfile( properties ): 可以设定用户属性，同一个 key 多次设置时，value 值会进行覆盖替换：
// 在需要使用 SDK 接口的页面逻辑文件中，需要通过 import 将 SDK 引入，再调用相应接口
import sensors from '../../utils/kuaishou-mp.min.js'
sensors.setProfile({
email:'xxx@xx',
favoriteFruits: ['苹果', '油桃'],
subscribers: 7277
});
JS
