- 在使用前，请先阅读数据模型
- SDK 更新日志，可参考 Release Notes
集成神策分析 SDK
- 从 GitHub 上获取快应用 SDK 源码；
- 将 sensorsdata.min.js 文件放入项目相应目录下；
- 在 app.ux 文件中通过 import 引入 SDK。
import sensors from './sensorsdata.min.js';
sensors.setPara({
name: 'sensors',
show_log: true,
server_url: '数据接收地址'
});
export default {
onCreate() {
// 必须传入this，不然在Page中无法引用sensors
sensors.init(this);
}
}
SDK 基本配置
配置项目数据接收地址
如下图所示获取数据接收地址：
获取到数据接收地址之后在 setPara 接口中设置 server_url。
开启全埋点
export default {
onCreate () {
sensors.init(this);
// 开启 $AppStart（App 启动）事件采集
sensors.appLaunch();
}
}// src 目录下的页面
export default {
onShow() {
// 开启 $AppViewScreen（App 浏览页面）事件
sensors.pageShow();
}
}设置事件公共属性
对于所有事件都需要添加的属性，可在初始化 SDK 前，调用 registerApp() 将属性注册为公共属性：
sensors.registerApp({
userLever: 'VIP3',
userSex: '男'
});用户登录
当用户注册成功或者登录成功时，需要调用 login() 方法传入登录 ID：
sensors.login("登录 ID");对于自动登录的用户，可以在 SDK 初始化前，获取登录 ID 并调用 login() 方法。
代码埋点追踪事件
SDK 初始化后，可通过 track() 方法追踪用户行为事件，并为事件添加自定义属性：
sensors.track(event_name [,properties]);配置参数：
| 参数 | 必填 | 描述 |
|---|---|---|
| event_name | 是 | 事件名称 |
| properties | 否 | 为用户行为事件添加自定义属性，类型：Object。 |
示例：
// 为 click 事件添加自定义属性 name 值为点击。
sensors.track('click',{
name: '点击'
});
事件名和事件属性的格式规范，请参考数据格式。
调试查看事件信息
事件的触发日志
setPara() 配置初始化参数时，通过 show_log: true 打开 Log 功能后（默认开启），快应用开发工具 console 会打印采集的数据信息：
事件的发送情况
事件数据发送成功时，可以在快应用开发工具的 Network 模块中，可以看到 sa 的请求：
SDK 可选配置
设置用户属性
setProfile( properties ): 可以设定用户属性，同一个 key 多次设置时，value 值会进行覆盖替换：
sensors.setProfile({
email:'xxx@xx',
favoriteFruits: ['苹果', '油桃'],
subscribers: 7277
});