コンソールへ移動

Google アナリティクスを使ってみる

このクイックスタートでは、アプリに Google アナリティクスを追加し、イベントのロギングを始める方法について説明します。

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

  • イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。
  • ユーザー プロパティ: 言語や地域など、ユーザーベースを示す属性。自由に定義できます。

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

始める前に

新しいプロジェクトを作成する場合は、プロジェクトの作成時に Firebase を Android プロジェクトに追加し、手順に沿ってプロジェクトに Google アナリティクスを設定します。

Google アナリティクスを構成していない既存のプロジェクトでは、settings[プロジェクトの設定] の [統合] タブから Google アナリティクスをリンクできます。

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

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

    implementation 'com.google.firebase:firebase-analytics:17.2.1'
    
  2. アクティビティの最上位で com.google.firebase.analytics.FirebaseAnalytics オブジェクトを宣言します。

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. onCreate() メソッドで初期化します。

    Java

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

    Kotlin

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

イベントのロギングを開始する

FirebaseAnalytics インスタンスを作成した後、logEvent() メソッドでイベント ロギングを開始できます。

イベントには、すべてのアプリで推奨されるイベントと、特定のビジネスや業種で推奨されるイベントがあります。推奨イベントとパラメータを一緒に送信することで、レポートに詳しい情報を表示できます。また、リリースされる最新の機能や統合を活用することもできます。このセクションでは、あらかじめ定義されているイベントのロギングについて説明します。イベント ロギングの詳細については、イベントをログに記録するを参照してください。

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

Java

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);

Kotlin

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)

詳細ロギングを有効にして 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 にイベントが表示され、イベントが送信されているかどうかをすぐに確認できます。

次のステップ