Mobile Analysis Service (MAS) は、クライアント SDK を使用してインストルメンテーションを行います。SDK は、ユーザーの行動やアプリのパフォーマンスなどのデータを収集し、ログを生成してサーバーに報告します。サーバーは、アップロードされたログから、事前定義されたデータ形式に基づいて有効なデータを抽出します。このプロセスにより、さまざまなクライアントメトリックを監視、分析できます。
このトピックでは、MAS コンポーネントを Android クライアントに素早く統合する方法について説明します。MAS コンポーネントは、ネイティブ AAR 統合とコンポーネントベースの統合の 2 種類の統合タイプをサポートしています。
完全な統合プロセスは、次の 6 つのステップで構成されます。
前提条件
ネイティブ AAR 統合タイプを使用する場合、まずプロジェクトに mPaaS を追加する必要があります。
コンポーネントベースの統合タイプを使用する場合は、まずコンポーネントベースの統合プロセスを完了する必要があります。
SDK の追加
ネイティブ AAR 統合
コンポーネント管理 (AAR) を使用して、プロジェクトにロギング (LOGGING) コンポーネントをインストールします。詳細については、「コンポーネント依存関係の管理 (ネイティブ AAR)」および「AAR コンポーネント管理」をご参照ください。
コンポーネントベースの統合
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 カードに保存されます。この権限を要求しない場合、診断ログを取得できないことがあります。
チャネル ID の設定
コンソールで異なるチャネルの APK からのデータを区別するには、各 APK にチャネル ID を設定します。
プロジェクトの assets フォルダーに channel.config ファイルを作成し、channel_id の値を変更します。
# 現在の配布チャネルを識別します
channel_id=alipaychannel.config ファイルを作成しない場合、チャネル ID はデフォルトで mpaas_default になります。
IMEI/IMSI の取得
Android 10 より前のシステムでは、必要な権限が付与されていれば、デバイスの IMEI と IMSI がデフォルトで取得されます。この動作を完全に無効にするには、次の設定を AndroidManifest ファイルに追加します。
<meta-data
android:name="imei.switch"
android:value="off" />この設定は、ベースライン 10.2.3.6 以降にのみ適用されます。この設定を追加すると、Mobile Analysis Service、Message Push Service、Mobile Sync Service はデバイスの IMEI と IMSI を取得しなくなります。
サービスの自動起動検出の有効化
一部のデバイスで、アプリが手動で強制停止された後でも TianyanLoggingService が自動的に再起動する問題に対処するには、AndroidManifest.xml に次の設定を追加して自動起動を無効にします。
<meta-data
android:name="open_service_self_start_detection"
android:value="true" />この設定は、ベースライン 10.2.3.77 以降にのみ適用されます。
ログの追加
SDK を統合した後、必要なコードを追加して、次の種類のログを生成します。
ローカルログの表示
ローカルのログ情報を表示する方法については、「ローカルログの表示」をご参照ください。
ログの報告
クライアントのローカルファイルからログサーバーにログを同期するには、「ログの報告」をご参照ください。