移動分析依賴用戶端 SDK 來進行埋點,收集使用者行為以及 App 效能等相關資料組建記錄檔並上報到服務端。根據 mPaaS 用戶端與服務端協定的埋點資料格式,服務端從用戶端上傳的埋點日誌中提取有效資料,從而實現對用戶端各項指標的監控分析。
本文介紹如何快速將 MAS 組件接入到 Android 用戶端。目前,MAS 組件支援 原生 AAR 接入和 組件化接入 兩種接入方式。
完整的接入過程分為以下六步:
前置條件
若採用原生 AAR 方式接入,需要先 將 mPaaS 添加到專案。
若採用組件化方式接入,需要先完成 組件化接入流程。
添加 SDK
原生 AAR 方式
參考 管理組件依賴(原生 AAR)AAR 組件管理,通過 組件管理(AAR) 在工程中安裝 日誌(LOGGING)組件。
組件化方式
在 Portal 和 Bundle 工程中通過 組件管理 安裝 日誌(LOGGING) 組件。更多資訊,參考 接入流程添加組件依賴。
初始化 mPaaS
原生 AAR 接入
如果您使用原生 AAR 接入方式,則需要初始化 mPaaS。
在 Application
對象中添加以下代碼:
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// mPaaS 初始化
MP.init(this);
}
}
詳情請參考:初始化 mPaaS。
組件化接入
使用組件化接入方式,mPaaS 架構會自動初始化,您無需操作。
添加配置
上傳日誌
上傳日誌需要訪問網路,請在 AndroidManifest
中聲明以下許可權。
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
日誌診斷
如果您需要使用 日誌診斷 功能,請在 AndroidManifest
中聲明以下許可權,並在 Android 6.0+ 裝置上運行時動態申請該許可權。
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
診斷記錄會儲存到裝置的 SD 記憶卡上,如果未申請該許可權,可能無法擷取診斷記錄。
設定渠道號
如果您需要在控制台中區分不同渠道的 apk 的資料,您可以為 apk 設定渠道號。
在工程的 assets
目錄下建立 channel.config
檔案,修改 channel_id
的值即可。
# 標識當前的發布渠道
channel_id=alipay
如果未建立 channel.config
檔案,渠道號預設為 mpaas_default
。
擷取 IMEI / IMSI
在低於 Android 10 的系統上,已獲得相關許可權的情況下預設會擷取裝置的 IMEI 和 IMSI,如果您需要完全禁止擷取這類資訊的行為,請在AndroidManifest
中添加以下配置:
<meta-data
android:name="imei.switch"
android:value="off" />
僅在 10.2.3.6 及以上基準生效,添加配置後,移動分析、訊息推送、資料同步都將不再擷取裝置的 IMEI 和 IMSI。
添加日誌
SDK 接入完畢後,添加以下日誌:
查看本地日誌
查看本地日誌 瞭解本地日誌資訊。
上報日誌
將用戶端本地檔案中的日誌同步到Log Service器。參見 上報日誌 說明文檔瞭解相關操作。