本文將引導您完成 Android 用戶端開發,包括:
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();