要为支付宝小程序接入统计分析服务,您需要先在控制台创建应用,然后在小程序项目中安装统计分析服务SDK。

前提条件

  • 确保支付宝小程序版本不低于10.1.52,低版本将获取不到统计信息。
  • 创建服务空间

背景信息

要接入支付宝小程序进行用户使用数据统计分析,您需要完成以下操作:

步骤一:创建统计分析应用

  1. 登录小程序云管理控制台。
  2. 选择服务空间。
  3. 在左侧导航栏,单击统计分析,然后单击创建应用
  4. 根据提示配置应用信息,然后单击确定
  5. 记录生成的AppKey。

步骤二:安装SDK

  1. 在小程序项目的根目录执行以下命令安装统计分析SDK。
    npm i @alicloud/mpserverless-analyse-alipaySdk -- save
  2. 执行以下命令安装小程序Serverless 客户端SDK。
    npm install @alicloud/mpserverless-sdk@2.2.0 --save
    说明 客户端SDK版本不能低于2.2.0。
  3. 在支付宝小程序项目的app.js文件中添加如下代码:
    在使用该代码时请注意:
    说明
    • 示例中的3个方法是SDK最基本的统计方法,请务必都引入。
    • 请在小程序最初初始化时调用MPAnalyse.init()方法,请勿出现任何异步方法阻塞int方法的调用。
    • 请在init方法中填入在统计分析页面中生成的AppKey,否则无法在统计分析页面中看到正确数据。
    • 慎重调用clearStorage()以及clearStorageSync()接口。SDK会将用户相关操作数据缓存在客户端数据存储模块,在特定时间启动发送策略。若调用该接口可导致数据统计不准确的问题。
    • 若用户在使用小程序过程强制关闭支付宝有可能会造成统计数据丢失的情况。
    import MPAnalyse from '@alicloud/mpserverless-analyse-alipaySdk';
    import MPServerless from '@alicloud/mpserverless-sdk'; ///SDK版本必须为2.2.0及以上
    
    const serverless = new MPServerless({
      uploadFile: my.uploadFile,
      request: my.request, 
      getAuthCode: my.getAuthCode 
      }, {
      appId: '1234456789', // 小程序应用标识
      spaceId: 'db4dd657-7041-470a-90xxxxx', // 服务空间标识
      clientSecret: '6c3c86xxxx6', // 服务空间 secret key
      endpoint: 'https://endpoint' // 服务空间地址,从小程序Serverless控制台处获得
    });
    
    App({
      onLaunch(options) {
        MPAnalyse.init('YOUR_APP_KEY', my, {     // 务必填入已注册的统计分析appKey,不然将无法统计
          mpServerless: serverless,             // 务必传入实例化MPServerless后的serverless
          platformParam: options               // 若不需要渠道分析功能,可以暂不传入
        });      
      },
      onShow() {
        MPAnalyse.resume();                      // 请务必引入
      },
      onHide() {
        MPAnalyse.pause();                       // 请务必引入
      }
    });

    其中:

    • appId:小程序的ID。您可以在支付宝小程序开放平台获取小程序的App ID。
    • spaceIdclientSecretendpoint:在小程序Serverless控制台创建服务空间后可以获得。详情参见创建服务空间
    • MPAnalyse.init YOUR_APP_KEY步骤一:创建统计分析应用中创建应用生成的AppKey。
    • platformParam: options:如果需要进行渠道分析功能,必须引入该参数。
      注意 渠道分析将会统计用户首次进入小程序页面时带的渠道参数,请保证首次进入的url参数中带有sdk_channel字段。例如首次进入的URL为:pages/index/index?sdk_channel=test,test将会作为此次渠道的值。
  4. 打开调试工具中的console选项,若看到有 [SDK] -- 集成SDK成功提示。即表示SDK集成成功。
    说明 该方案仅提供验证是否集成成功的方法,由于在开发环境下可能会存在数据不完整的情况,请您正式发布小程序后在验证数据正确性。

步骤三:查看统计数据

  1. 登录小程序云控制台。
  2. 在左侧导航栏,单击统计分析
  3. 单击目标统计分析应用的查看数据链接进入统计分析页面。