モバイル分析サービス(略称 MAS)は、クライアント SDK を使用してイベントトラッキングを実装し、ユーザーの行動、アプリのパフォーマンス、その他の関連データを収集してログを生成し、サーバーにログをレポートします。サーバーは、クライアントからアップロードされたトラッキングログから、ネゴシエートされたトラッキングログフォーマットに基づいて有効なデータを抽出し、クライアントメトリックを監視および分析します。
このトピックでは、MAS を Android クライアントに迅速に統合する方法について簡単に説明します。 [Native AAR] または [Portal & Bundle] を使用して MAS を統合できます。
完全な統合プロセスには、主に次の 6 つのステップが含まれます。
前提条件
[ネイティブ AAR] を介して MAS を統合する場合は、プロジェクトに mPaaS を追加する を完了していることを確認してください。
[ポータル & バンドル] を介して MAS を統合する場合は、一般的な手順を完了していることを確認してください。
SDK を追加する
[ネイティブ AAR] モード
コンポーネントの依存関係を管理する の手順に従って、ログ記録コンポーネント管理 (AAR) を使用してプロジェクトに コンポーネントをインストールします。
AAR コンポーネント管理 の手順に従って、ログ記録コンポーネント管理 (AAR) を使用してプロジェクトに コンポーネントをインストールします。
[ポータル & バンドル] モード
[コンポーネント管理] を使用して、[ポータル] プロジェクトと ログ記録コンポーネント管理一般的な手順 プロジェクトに コンポーネントをインストールします。詳細については、「」をご参照ください。
[コンポーネント管理] を使用して、[ポータル] プロジェクトと ログ記録コンポーネント管理一般的な手順 プロジェクトに コンポーネントをインストールします。詳細については、「」をご参照ください。
mPaaS を初期化する
[ネイティブ AAR]
[ネイティブ AAR] を介して MAS を統合する場合は、mPaaS を初期化する必要があります。
オブジェクト Application に次のコードを追加します。
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// mPaaS initialization
MP.init(this);
}
}詳細については、「mPaaS を初期化する」をご参照ください。
[ポータル & バンドル] モード
[ポータル & バンドル] を介して MAS を統合する場合、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 カードに保存されます。上記の権限がないと、診断ログを取得できません。
チャネル番号の設定
mPaaS コンソールで異なるチャネルの apk データを区別するために、apk のチャネル番号を設定できます。
アプリプロジェクトで、ディレクトリ assets の下に channel.config ファイルを作成し、channel_id の値を変更します。
# Identify the current release channel
channel_id=alipayIMEI / IMSI を取得する
Android 10 より低いシステムでは、関連する権限が取得されている場合、デバイスの IMEI と IMSI がデフォルトで取得されます。このような情報の取得を完全に禁止する必要がある場合は、AndroidManifest に次の構成を追加してください。
<meta-data
android:name="imei.switch"
android:value="off" />10.2.3.6 以降のベースラインでのみ有効です。構成が追加されると、モバイル分析、メッセージプッシュ、およびデータ同期はデバイスの IMEI と IMSI を取得しなくなります。
ログを追加する
SDK を統合した後、次のログを追加できます。
ローカルログを表示する
ローカルログを表示する でローカルログ情報を確認します。
ログをアップロードする
クライアントのローカルファイルをログサーバーに同期します。具体的な操作については、「ログをアップロードする」をご参照ください。