全部產品
Search
文件中心

Mobile Platform as a Service:Android 用戶端開發

更新時間:Jul 13, 2024

本文將引導您完成 Android 用戶端開發,包括:

  1. 接入移動分析組件

  2. 記錄事件記錄

  3. 上報日誌

1. 接入移動分析組件

參見 Android 接入文檔 接入移動分析組件。

2. 記錄事件記錄

下面通過程式碼範例指導如何記錄事件記錄,並對涉及的相關參數進行說明。

範例程式碼

在下面的程式碼範例中,用戶端將記錄事件對應的業務 ID、事件 ID、支付時間、使用者識別碼 以及支付方式。

import com.mpaas.mas.adapter.api.MPLogger;

import java.util.HashMap;
import java.util.Map;

// 業務 ID
String bizType = "Pay";
// 事件 ID
String logId = "PayResults";
// 添加屬性
Map<String, String> params = new HashMap<>(4);
// 屬性:支付時間。Key 對應屬性 ID;Value 對應屬性值
params.put("pay_time", String.valueOf(System.currentTimeMillis()));
// 屬性:使用者識別碼
params.put("user_id", "the-userId");
// 屬性:支付方式
params.put("payment_method", "alipay");
// 列印日誌
MPLogger.event(logId, bizType, params);

參數說明

  • bizType(業務 ID)

    • bizType 用於設定 業務 ID(也稱為 業務碼業務類型),是業務的唯一標識。範例程式碼中設定為 Pay,意為支付業務。

    • bizType 影響用戶端日誌的檔案名稱;記錄檔名規則為 時間戳記_包名-進程_bizType

  • logId(事件 ID)logId 用於設定 事件 ID,是事件的唯一標識。更多資訊,參見 教程情境說明

  • params(事件屬性)params 用於儲存事件關聯的屬性。其中,params.put("param-key", "param-value")

    • param-key:對應屬性 ID。更多資訊,參見 教程情境說明

    • param-value:對應屬性的值。在用戶端以字串形式儲存;在實際分析中,服務端支援自動轉化為字元型、整型、浮點型。

3. 上報日誌

預設情況下,當用戶端本地日誌緩衝到一定條數或程式壓後台超過一定時間後,本地日誌會自動上報給移動分析伺服器。在開發測試時,您可以調用以下介面,強制將本地日誌立刻上報給伺服器:

import com.mpaas.mas.adapter.api.MPLogger;
MPLogger.uploadAll();

相關連結