1. 集成神策分析 SDK

1.1. 引入 SDK

  • 从 GitHub 上获取快手小程序 SDK 源码；
  • 将 /dist/mp-kuaishou/index.esm.js   文件放入小程序项目中；
  • 在 app.js 文件中通过 import 方式引入并初始化 SDK。
import sensors from './dist/mp-kuaishou/index.esm.js';

// 初始化 SDK
sensors.init({
	server_url: '您的数据接收地址',
	// 是否允许控制台打印查看埋点数据(建议开启查看)
	show_log: true
});

App({
	onLaunch: function(){
	
	},
	onShow: function(){

	}
});
JS
  • 如上所示，需要引入 SDK 后立即调用 init，也就是需要在 App 实例化之前调用  init()，否则可能会造成部分预置事件丢失

2. SDK 基本配置

2.1. 配置项目数据接收地址

如下图所示获取数据接收地址：

2.2. 设置事件公共属性

对于所有事件都需要添加的属性，可在初始化 SDK 前，调用 registerApp() 将属性注册为公共属性：

// 在需要使用 SDK 接口的页面逻辑文件中，需要通过 import 将 SDK 引入，再调用相应接口

sensors.registerApp({
	userLever: 'VIP3',
	userSex: '男'
});
JS

2.3. 用户登录

当用户注册成功或者登录成功时，需要调用 login() 方法传入登录 ID：

// 在需要使用 SDK 接口的页面逻辑文件中，需要通过 import 将 SDK 引入，再调用相应接口

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 引入，再调用相应接口

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 引入，再调用相应接口

sensors.setProfile({
	email:'xxx@xx',
	favoriteFruits: ['苹果', '油桃'],
	subscribers: 7277
});
JS