支付寶小程序：小程序模板快速集成

本文檔適用于 模板開發模式 接入的服務商（ISV）在自身小程序內快速集成友盟+ SDK，獲取數據服務能力。

本文檔適用于友盟+支付寶小程序統計 SDK 2.3.2 及以上版本，并且支付寶版本需大于 10.1.52 版本。

特別提醒：我們建議開發者在注冊賬號時使用企業郵箱，避免使用個人郵箱注冊，防止由于個人離職帶來的問題，建議使用的賬號形式 ：umeng@企業域名、apps@企業域名、dev@企業域名

安裝SDK有兩種方式，一種是在 IDE 內安裝，另一種是在命令行內使用 npm 安裝。

1. 切換到 NPM 依賴管理；

2. 輸入 umtrack-alipay；

3. 從搜索結果列表中選中 umtrack-alipay, 并檢查版本是否正確。

npm install umtrack-alipay --save

在 app.js 文件內，添加如下代碼，即可進行基礎指標的統計：

import 'umtrack-alipay';App({  umengConfig: {    appKey: 'YOUR_UMENG_APPKEY', //由友盟分配的APP_KEY    debug: true //是否打開調試模式  }});

登錄支付寶小程序后臺，進入小程序的 設置->開發設置->服務器域名白名單，把 umini.shujupie.com 添加至白名單，如圖：

1. 請務必在支付寶平臺勾選 友盟+數據服務 功能包，否則將導致無法統計數據；

2. 添加流程：進入小程序后臺開發管理菜單，能力列表 部分可以點擊 添加功能 來給創建的小程序添加功能，如下圖所示；開發者勾選 小程序-友盟+小程序統計 功能后，點擊右下角 確定 即完成添加功能。

服務商在獲取小程序 APPID、訂單號、授權碼后，服務商可通過 OpenAPI 的方式，申請友盟+APPkey，并返還到 SDK 中。

API測試工具，請點擊下載：UMiniOpenApi-1.0.10-java.zip

UmengUminiCreateMiniAppParam param = new UmengUminiCreateMiniAppParam(); param.setName("應用名稱"); param.setType("mini"); param.setPlatform("平臺"); param.setLanguage("CN"); param.setFirstLevel("一級分類"); param.setSecondLevel("二級分類"); param.setDescription("描述……"); param.setMiniAppId(""); param.setMiniAppSecret(""); param.setMiniPublicKey(""); param.setMiniPrivateKey(""); try { UmengUminiCreateMiniAppResult result = apiExecutor.execute(param); System.out.println("1、" + JSONObject.toJSONString(result)); } catch (OceanException e) { System.out.println("1、errorCode=" + e.getErrorCode() + ", errorMessage=" + e.getErrorMessage()); }

特別說明：

1. OpenAPI 具體說明請參考：

? ? ?https://developer.umeng.com/open-api/docs/com.umeng.umini/umeng.umini.createMiniApp/1

1. 行業分類請參考：https://developer.umeng.com/docs/147615/detail/169442

2. 若創建應用數超過300，請聯系在線客服。

trackEvent(eventId, params)

參數：

• id(string): 事件 ID 需在官網申請，長度在128個字符內

• params(object|string):

  • object 不能為數組

  • 當 params 為 object 類型時，每個 key 長度不能超過256個字符

  • 當 params 為 object 類型時，其攜帶 key 的個數不能超過100個

  • 存在規則不合法情況時，丟棄整條事件

返回值：

* 無

my.uma.trackEvent('事件ID');

my.uma.trackEvent('事件ID', { '屬性1':'屬性值1','屬性2':'屬性值2' });// 字符型屬性值my.uma.trackEvent('ViewProductDetails', { 'Category':'家電','ItemName':'西門子冰箱' });// 數值型屬性值my.uma.trackEvent('Pay', { 'PayAmount':6999 });

埋點注意事項：

1. params 為 object 類型時，屬性值僅支持字符串和數值兩種類型;

2. 請在 App.onLaunch 之后調用事件。

1. 進入U-MiniProgram后臺“自定義事件”頁面，點擊“事件管理”；

2. 點擊“添加事件”，輸入小程序埋點的事件ID和名稱；

3. 返回小程序自定義事件頁面查看該事件數據。

當用戶在您的小程序上注冊以后，您的應用服務端會在用戶數據庫里添加一條記錄并且分配一個用戶ID，可以通過setUserid接口設置該用戶ID，以便后續做數據打通或基于應用用戶ID做計算時使用。

代碼:

setUserid(userId, provider)

參數：

• userId(string): 您的應用為用戶生成的唯一 ID。

• provider(string): ID提供方，兼容老接口使用，無特殊需要應忽略該參數返回值：無示例：

my.uma.setUserid('custom_userid');

開發者可通過在配置中添加 uploadUserInfo: true 選項來使友盟自動上報用戶信息。將 uploadUserInfo 設置為 false 取消上報用戶信息。上傳的用戶信息為小程序平臺公開可獲取的用戶基礎信息，例如昵稱、頭像、性別、地區、語言等，這些信息將用于 U-MiniProgram 產品中與用戶相關的功能統計中。示例：

代碼:

import 'umtrack-alipay';App({  umengConfig: {    appKey: 'YOUR_UMENG_APPKEY', //由友盟分配的APP_KEY    debug: true, //是否打開調試模式    uploadUserInfo: true // 自動上傳用戶信息，設為false取消上傳，默認為false  }});

該方案僅提供驗證是否集成成功的方法，由于在開發環境下可能會存在數據不完整的情況，請您正式發布小程序后在驗證數據正確性。

1. 按照上述描述方法引入 SDK；

2. 進入IDE打開調試工具中的 console。

若提示“[umeng] — 集成SDK成功”提示，即表示 SDK 集成成功。

若提示“[umeng] ，請確保已經勾選"友盟+數據服務功能！”，請您務必確認已在支付寶開發者中心已經勾選添加“友盟+數據服務”;

注意：

若提示“api: getOpenUserData 暫不支持，請在真機調試”，請在手機上驗證是否存在該提示，若不存在即可忽略此提示；

請您將支付寶 IED 升級至更新至 1.0 版本或以上，否則會出現預覽失敗的情況。

說明事項：

1. SDK 統計僅僅會在支付寶版本大于等于 10.1.52 才能生效，低版本將獲取不到統計信息；

2. 慎重調用my.clearStorage()以及my.clearStorageSync(接口！SDK會將用戶相關操作數據緩存在客戶端數據存儲模塊，在特定時間啟動發送策略。若調用該接口可導致數據統計不準確的問題；

3. 若用戶在使用小程序過程強制關閉支付寶有可能會造成統計數據丟失的情況。