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

小編:啊南 205閱讀 2020.12.28

適用角色

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

適用范圍

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

小程序模板集成SDKwww.umeng.com),按照引導注冊友盟+賬號


AB35B58C-AAE7-4968-BFAB-D69A33CBE887.png

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

2. 安裝SDK

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

2.1 在IDE內安裝
  1. 切換到 NPM 依賴管理;

  2. 輸入 umtrack-alipay;

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

2.2 在命令行內使用 npm 安裝
npm install umtrack-alipay --save
3. 集成SDK

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

import 'umtrack-alipay';App({  umengConfig: {    appKey: 'YOUR_UMENG_APPKEY', //由友盟分配的APP_KEY    debug: true //是否打開調試模式  }});
4. 增加友盟+數據服務域名白名單

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

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

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

6. 申請Appkey

服務商在獲取小程序 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,請聯系在線客服。

高級功能1. 自定義事件
trackEvent(eventId, params)

參數:

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

  • params(object|string):

    • object 不能為數組

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

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

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

返回值:

* 無

1.1 僅統計事件,無屬性時,使用如下方法:
my.uma.trackEvent('事件ID');
1.2 統計帶屬性的事件時,使用如下方法:
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.3 自定義事件添加流程
  1. 進入U-MiniProgram后臺“自定義事件”頁面,點擊“事件管理”;

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

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

2. 設置應用用戶ID

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

代碼:

setUserid(userId, provider)

參數:

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

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

my.uma.setUserid('custom_userid');
3. 上傳用戶信息

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

代碼:

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

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

  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. 若用戶在使用小程序過程強制關閉支付寶有可能會造成統計數據丟失的情況。

關聯標簽:
一款棋牌app多少钱 优博北京快乐8 勾特单双中特期期公开 bg真人资源都是怎么找的 江西多乐彩彩彩乐乐 如何购买福彩3d 江西快三到 澳洲幸运5是什么时候结束 北京11选5走势图技巧 p3开机号试机号近10期体彩 pt电子娱乐|Welcome 广东时时彩官网预测app下载 王八报 dafa线上娱乐百家乐 体彩河南11选5开奖结果 特码直通车金牛在线 泛亚电竞是哪个平台下的