快速集成

支付宝小程序移动统计 SDK 快速集成共有 6 个步骤。1234.png

注册友盟+账号

注意：建议开发者在注册账号时使用企业邮箱，避免使用个人邮箱注册，避免由于个人离职带来的使用不便。

推荐使用的账号形式 ：umeng@企业域名、apps@企业域名、dev@企业域名

使用友盟+ 账号登录 友盟+ 官网，按照引导注册友盟+账号。

2.png

申请 Appkey

使用友盟+ 账号 登录，并在 U-APP AI 版本中的 管理 页面的左侧导航中添加新应用，然后获取到Appkey，为下一步集成做准备。12345.png

4.png

申请“友盟+数据服务”功能包

为保证友盟+ 数据统计的准确性、即时性，需要提供支付宝小程序唯一标识 AppID、友盟+ 唯一标识 AppKey，请在友盟+ 个人中心进入“我的反馈”创建新反馈，提交申请。预计 1-3 工作日内便可申请开通完成，请留意。5.png

接入 SDK

  • 获取SDK文件：
  1. npm i umtrack-alipay --save
  • 在支付宝小程序的 app.js 文件中添加如下代码：
  1. import uma from './uma.min.js';
  2. App({
  3.   onLaunch() {
  4.    uma.init('YOUR_APP_KEY', my);      // 务必填入已注册的appKey，不然将无法统计
  5.   },
  6.   onShow() {
  7.      uma.resume();                    // 请务必引入
  8.   },
  9.     onHide() {
  10.         uma.pause();                  // 请务必引入
  11.     },
  12.       globalData: {
  13.         uma                           // 请将uma模块绑定在gloabalData下，以便后续使
  14.       }
  15.  });

注意：

  • uma.init() 、uma.resume() 、uma.pause() 、globalData 是移动统计 SDK 的基本方法，请务必全部引入。
  • 请在小程序初始化的起步阶段，调用 uma.init() 方法，并填入已注册的 appKey ，否则无法使用统计功能。
  • 请将 my 传入 uma.init() ，以保证统计功能的稳定运行。
  • 请将 uma 绑定在 globalData 下，以保证各个页面可以正确使用 SDK 接口。

添加域名白名单

在支付宝小程序中添加友盟+ 数据服务域名（ulogs.umeng.com）至白名单。6.png

验证 SDK 正确集成方法

此方法仅在小程序开发者工具（IDE）验证 SDK 是否集成成功。由于在开发环境下可能会存在数据不完整的情况，请在正式发布小程序后再验证数据正确性。

  • 请保证已经下载安装完成小程序开发者工具（IDE），并在 IDE 中打开您的小程序。
  • 按照上述步骤引入SDK。
  • 进入 IDE，打开调试工具中的 console 选项：
  • 若提示 [umeng] — 集成SDK成功 ，即表示 SDK 集成成功；
  • 若提示 [umeng] — 请确保已经勾选支付宝功能包中的“友盟+数据服务”功能包！ ，则请务必确认已在支付宝开发者中心已经勾选“友盟+数据服务”；
  • 若提示 api:getOpenUserData 暂不支持，请在真机调试 ，则请在手机上验证是否存在该提示，若不存在即可忽略此提示。