- 在使用前，请先阅读 数据模型
- SDK 更新日志，可参考 Release Notes
注意：
- 如果您已经是在 2016 年 5 月 15 日之前使用的 0.6.1 版本的微信小游戏 SDK，请不要对微信小游戏 SDK 进行升级。如果有升级需求请咨询技术顾问。
集成神策分析 SDK
导入 SDK
- 从 GitHub 上获取
/dist/源码； - 将
/dist/game-xx/index.esm文件放入小游戏项目中； - 在 game.js 文件中通过 import 引入 SDK。
import sensors from 'sensorsdata.es6.min.js'下载下来的文件夹参考：
| /dist/ 下的文件目录 | 含义 |
|---|---|
| game-bytedance | 字节小游戏 |
| game-wechat | 微信小游戏 |
| game-qq | QQ 小游戏 |
| game-h5 | H5 小游戏 |
开启全埋点
如果需要自动采集启动（小程序显示）、退出（小程序隐藏）这些事件，可以使用全埋点插件。
import sa from '/dist/game-xx/index.esm'
import autotrack from '/dist/game-xx/plugin/autotrack/index.esm'
sa.use(autotrack,{
app_show: true,
app_hide: true
});初始化 SDK
引入 SDK 后，可通过 init 进行 SDK 初始化参数配置：
import sensors from '/dist/game-xx/index.esm'
import autotrack from '/dist/game-xx/plugin/autotrack/index.esm'
sensors.use(autotrack,{
app_show: true,
app_hide: true
});
sensors.init({
server_url: '数据接收地址'
});初始化可选参数
sensors.init 中可选的参数如下：
| 配置名 | 默认值 | 含义 |
|---|---|---|
| server_url | 空字符串 | 数据接收地址 |
| show_log | false | 是否显示日志 |
| batch_send.send_timeout | 6000 | 6000 毫秒发送一次数据 |
| batch_send.max_length | 6 | 存储满 6 条后发送一次数据 |
| max_string_length | 500 | 上报的字符串属性值最多 500 长度，多余的会被截取 |
SDK 基本配置
配置项目数据接收地址
如下图所示获取数据接收地址：
- 打包发布为微信 / QQ / 字节跳动等小游戏时，需要在相应的开发者平台配置数据接收地址的域名，详情参考：https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html
设置事件公共属性
对于所有事件都需要添加的属性，可在初始化 SDK 前，调用 registerApp() 将属性注册为公共属性：
sensors.registerApp({
userLever: 'VIP3',
userSex: '男'
});用户登录
当用户注册成功或者登录成功时，需要调用 login() 方法传入登录 ID：
sensors.login("登录 ID");对于自动登录的用户，可以在 SDK 初始化前，获取登录 ID 并调用 login() 方法。
代码埋点追踪事件
可通过 track() 方法追踪用户行为事件，并为事件添加自定义属性：
sensors.track('click',{
name: '点击'
});