1. 插件版微信小程序 SDK  说明

  • 经过测试发现,如果小程序中使用了第三方插件且调试基础库版本在 2.6.4 以下时,App 和 Page 这两个全局变量是不可读的,这会导致全埋点版微信小程序 SDK 不可用;基础库版本在 2.6.4 及以上这个问题就不存在了,全埋点版微信小程序 SDK 可以使用;针对使用了第三方插件且调试基础库版本在 2.6.4 以下的这种情况,可以使用插件版小程序 SDK 。这个版本相比全埋点版微信小程序 SDK ,复杂处在于每个 Page 里的 JS 顶部都要引入一段代码,才可以自动采集 Page 里的预置事件。

2. 快速使用

2.1. 集成与使用

2.1.1. 下载文件

2.1.2. 引入 SDK 、配置参数并完成初始化

  • 把文件放在小程序项目中,然后在 app.js 中通过 require() 引入文件 ;
  • app.js 文件顶部声明 App 变量并赋值,其他 js 文件中声明 Page 变量并赋值用来采集预置事件;
  • 调用 setPara() 方法设置初始化参数;
  • 调用 init() 方法标志已完成初始化;

注意:App 和 Page 变量名不能修改;

app.js

var sa = require('./utils/sensorsdata.plugin.min.js');
var App = sa.App;
sa.setPara({
	name: 'sensors',
	server_url: '数据接收地址'
});
sa.init();
JS
  • 在全部(注意是全部!)的 pages 目录里的 js 顶部引入如下代码

index.js

var Page = getApp().sensors.Page;
JS

2.1.3. 自定义事件采集

  • 在其他页面逻辑 js 文件中通过调用 track() 接口来采集自定义事件;

index.js

var app = getApp();
var Page = app.sensors.Page;
app.sensors.track('addToCart',{
	productName:'华为畅享 9S'
});
Page({});
JS

2.2. 确认数据发送成功

注意:客户有测试项目的情况下,优先建议客户使用测试项目的数据接收地址向测试项目发数据。

  • 集成 SDK 初始化代码且使用 track() 方法进行埋点,微信开发者工具 console 会打印采集的数据,json 格式;

  • 微信开发者工具 network 中有 sa 的图片请求,且状态码为 200,验证数据接收地址;

  • 神策分析界面中,打开导入中的数据,点击开始刷新按钮。在微信开发者工具触发一些事件,分析后台的导入中数据可以看到数据进入;

  • 神策分析界面中,打开埋点管理查看,已入库 1 条,证明数据采集成功;
  • 神策分析界面中,事件分析查看数据;