1. 集成神策分析 SDK

1.1. 引入 SDK

  • GitHub 上获取京东小程序 SDK 源码
  • jd-mp.min.js 文件放入小程序项目中
  • app.js 文件中通过 import 方式引入 SDK
import sensors from './utils/jd-mp.min.js';

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

// 初始化 SDK
sensors.init();

App({
	sensors : sensors , // 配置全局变量
	onLaunch: function(){},
	onShow: function(){}
});
JS
  • 京东小程序 SDK 压缩文件 jdmp.min.js 大小约为 16 KB
  • 需要在 App 实例化之前调用 setPara() init(),否则可能会造成部分预置事件丢失
  • 在调用 init() 接口之前,采集的数据被缓存在内存中;调用 init() 接口后,会将缓存的数据通过网络发送出去。

2. SDK 基本配置

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

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

2.2. 设置事件公共属性

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

// 在需要使用 SDK 接口的页面逻辑文件中,需要通过 import 将 SDK 引入,再调用相应接口
import sensors from '../../utils/jd-mp.min.js';

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

2.3. 用户登录

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

// 在需要使用 SDK 接口的页面逻辑文件中,需要通过 import 将 SDK 引入,再调用相应接口
import sensors from '../../utils/jd-mp.min.js';

sensors.login("登录 ID");
JS
  • 对于自动登录的用户,可以在 SDK 初始化前,获取登录 ID 并调用 login() 方法。

2.4. 代码埋点追踪事件

可通过 track() 方法追踪用户行为事件,并为事件添加自定义属性:

// 在需要使用 SDK 接口的页面逻辑文件中,需要通过 import 将 SDK 引入,再调用相应接口
import sensors from '../../utils/jd-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/jd-mp.min.js';

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