要为微信小程序接入统计分析服务,您需要先在控制台创建应用,然后在小程序项目中安装统计分析服务SDK。
背景信息
要接入微信小程序进行用户使用数据统计分析,您需要完成以下操作:
步骤一:创建统计分析应用
- 登录小程序云管理控制台。
- 在左侧导航栏,单击统计分析,然后单击创建应用。
- 根据提示配置应用信息,然后单击确定。
- 记录生成的AppKey。
步骤二:安装SDK
- 在小程序项目的根目录执行以下命令安装统计分析SDK。
npm i @alicloud/mpserverless-analyse-wxsdk -- save
- 执行以下命令安装小程序Serverless 客户端SDK。
npm install @alicloud/mpserverless-sdk --save
- 在微信小程序项目的app.js文件中添加如下代码:
在使用该代码时请注意:
说明
- 示例中的三个方法是SDK最基本的统计方法,请务必都引入。
- 请在小程序最初初始化时调用
MPAnalyse.init()
方法,请勿出现任何异步方法阻塞int方法的调用。
- 请在init方法中填入在统计分析页面中生成的AppKey,否则无法在统计分析页面中看到正确数据。
- 慎重调用
clearStorage()
以及clearStorageSync()
接口。SDK会将用户相关操作数据缓存在客户端数据存储模块,在特定时间启动发送策略。若调用该接口可导致数据统计不准确的问题。
- 若用户在使用小程序过程强制关闭微信有可能会造成统计数据丢失的情况。
const MPAnalyse = require('@alicloud/mpserverless-analyse-wxSdk');
const MPServerless = require('@alicloud/mpserverless-sdk'); //客户端SDK版本必须为2.2.0及以上
const serverless = new MPServerless({
uploadFile: wx.uploadFile,
request: wx.request,
getAuthCode: wx.login,
getFileInfo: wx.getFileInfo,
getImageInfo: wx.getImageInfo
}, {
appId: '1234456789', // 小程序应用标识
spaceId: 'db4dd657-7041-470a-90xxxxx', // 服务空间标识
clientSecret: '6c3c86xxxx6', // 服务空间 secret key
endpoint: 'https://endpoint', // 服务空间地址,从小程序Serverless控制台处获得
});
App({
onLaunch: function (options) {
MPAnalyse.init('YOUR_APP_KEY', { // 务必填入已注册的统计分析appKey,不然将无法统计
mpServerless: serverless, // 务必传入实例化MPServerless后的serverless
platformParam: options // 若不需要渠道分析功能,可以暂不传入
});
},
onShow (options) {
MPAnalyse.resume(); // 请务必引入
},
onHide () {
MPAnalyse.pause(); // 请务必引入
}
});
其中:
- appId:小程序的ID。您可以在微信小程序开放平台获取小程序的App ID。
- spaceIdclientSecret和endpoint:在小程序Serverless控制台创建服务空间后可以获得。详情参见创建服务空间。
- MPAnalyse.init :YOUR_APP_KEY是步骤一中创建统计分析应用生成的AppKey。

- platformParam: options:如果需要进行渠道分析功能,必须引入参数。
注意 渠道分析将会统计用户首次进入小程序页面时带的渠道参数,请保证首次进入的URL参数中带有sdk_channel字段。例如首次进入的URL为:pages/index/index?sdk_channel=test,test将会作为此次渠道的值。
- 打开调试工具中的console选项,若看到有
[SDK] -- 集成SDK成功
提示。即表示SDK集成成功。
说明 该方案仅提供验证是否集成成功的方法,由于在开发环境下可能会存在数据不完整的情况,请您正式发布小程序后在验证数据正确性。
步骤三:查看统计数据
- 登录小程序云控制台。
- 在左侧导航栏,单击统计分析。
- 单击目标统计分析应用的查看数据链接进入统计分析页面。