快应用 SDK

• 在使用前，请先阅读 数据模型
• 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]);

配置参数：

示例：

// 为 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
});

• 关于事件属性和用户属性的区别，请参考数据模型
• 用户属性的命名约束，请参考数据格式