mPaaS Android アプリにイベントトラッキングを追加して、デバイスのインストール数およびユーザー数をトラックし、モバイル分析コンソールでメトリックを確認します。
アクティベーションログは、アプリのエンゲージメントを次の 2 つのディメンションでトラックします。
デバイスアクティベーション:アプリのインストール数をカウントします。
ユーザーアクティベーション:アプリのユーザー数をカウントします。
モバイル分析コンソールの データ概要 ページで、アクティブユーザー、新規ユーザー、アクティブアカウントなどのメトリックを確認できます。
デバイスアクティベーションのイベントトラッキング
mPaaS フレームワークは、デバイスアクティベーションログを自動的にレポートします。コードの変更は不要です。この動作は、ベースライン 10.1.68.30 以降でサポートされています。
自動レポートを無効化するには、AndroidManifest.xml ファイルに以下を追加します。
<meta-data
android:name="report.launch.switch"
android:value="off" />
自動レポートを無効化した後は、アプリのライフサイクル内で適切なタイミングで以下のメソッドを呼び出して、デバイスアクティベーションを手動でレポートします。
MPLogger.reportClientLaunch();
レポート間隔の動作:アプリがバックグラウンドから前景に戻った際、SDK は前回のレポートからの経過時間がレポート間隔を超えた場合にのみ、デバイスアクティベーションログをレポートします。デフォルトの間隔は 30 分です。単一のレポート間隔内での複数回の呼び出しは重複排除され、最初の呼び出しだけが記録されます。
レポート間隔(ミリ秒単位)をカスタマイズするには、以下のメソッドを呼び出します。
MPLogger.setReportClientLaunchInterval(long interval);
ユーザーアクティベーションのイベントトラッキング
ユーザーがアプリへのログインに成功した後、または有効な userId を取得できたタイミングで、以下のメソッドを呼び出します。
MPLogger.reportUserLogin(String userId);
userId は、ご利用のアプリのログインシステムにおけるユーザーの一意な識別子です。ユーザーが正常にログインした後や、その他の userId を正常に取得できたタイミングで、このメソッドを呼び出すことができます。
reportUserLogin() を呼び出すと、SDK 内の userId が自動的に設定されます。また、以下のメソッドを個別に呼び出して userId を設定することも可能です。
MPLogger.setUserId(String userId);
userId を設定すると、mPaaS コンソールの リアルタイムリリース > ホワイトリスト 配信機能で使用できます。
ユーザーがログアウトした際は、MPLogger.setUserId(null) を呼び出して userId をクリアし、その後のイベントが該当ユーザーに属性付けされないようにしてください。