Android 用 Firebase 向け Google アナリティクスを使ってみる

Firebase 向け Google アナリティクスは、アプリの使用状況や動作に関するデータを収集します。この SDK は主に次の 2 種類の情報をロギングします。

• イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。

• ユーザー プロパティ: 言語や地域など、ユーザー層を示す属性。自由に定義できます。

アナリティクスは、一部のイベントとユーザー プロパティを自動的にログに記録します。ログを有効にするためのコードを追加する必要はありません。

はじめに

まだ追加していない場合は、Firebase を Android プロジェクトに追加します。

アプリにアナリティクスを追加する

1. Firebase 向け Google アナリティクス Android ライブラリの依存関係をモジュール（アプリレベル）の Gradle ファイル（通常は app/build.gradle）に追加します。

   implementation 'com.google.firebase:firebase-core:16.0.8'
   

2. アクティビティの上部にある com.google.firebase.analytics.FirebaseAnalytics オブジェクトを宣言します。

   Java
   Android

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

   Kotlin
   Android

   private lateinit var firebaseAnalytics: FirebaseAnalytics
   MainActivity.kt

3. onCreate() メソッドで初期化します。

   Java
   Android

   // Obtain the FirebaseAnalytics instance.
   mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
   MainActivity.java

   Kotlin
   Android

   // Obtain the FirebaseAnalytics instance.
   firebaseAnalytics = FirebaseAnalytics.getInstance(this)
   MainActivity.kt

イベントをログに記録する

FirebaseAnalytics インスタンスを作成すると、そのインスタンスで logEvent() メソッドを使って、事前定義されたイベントまたはカスタムのイベントをログに記録できるようになります。事前定義されたイベントとパラメータは、FirebaseAnalytics.Event と FirebaseAnalytics.Param のリファレンス ドキュメントで調べることができます。

次のコードは、ユーザーがアプリ内の特定の要素をクリックしたときに SELECT_CONTENT イベントをログに記録します。

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

val bundle = Bundle()
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id)
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name)
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle)
MainActivity.kt

イベントの確認

詳細ログを有効にして SDK によるイベントのログ記録をモニタリングし、イベントが正しく記録されているかどうかを確認することができます。対象となるのは、自動で記録されるイベントと手動で記録されるイベントの両方です。

詳細ログを有効にするには、次の一連の adb コマンドを入力します。

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

このコマンドを入力すると Android Studio の logcat にイベントが表示され、イベントが送信されているかどうかを即座に確認することができます。

次のステップ

• Firebase コンソールで表示されるデータが定期的に更新されることを確認してください。

• イベントをログに記録する方法とユーザー プロパティを設定する方法については、各ガイドをご覧ください。