このページは Cloud Translation API によって翻訳されました。

Google 広告と Firebase 向け Google アナリティクスのカスタムイベント - Android

1. はじめに

最終更新日: 2020 年 12 月 14 日

作成するアプリの概要

この Codelab では、Firebase 向け Google アナリティクス（GA4F）でイベントを実装し、Google 広告でアクションキャンペーンを開始する方法を学びます。

この Codelab では、GA4F でイベントを実装する方法と、そのイベントを Google 広告にインポートする方法について説明します。Firebase を使用して Android アプリを作成する方法については、Firebase Android Codelab - ビルドに適したチャットをご覧ください。

ラボの内容

Firebase プロジェクトを作成する方法
Android アプリに Firebase SDK を実装する方法
イベントとパラメータの作成方法
Firebase から Google 広告にイベントをインポートする方法
カスタムイベントを使用して Google 広告アクションキャンペーンを開始します。

必要なもの

Android Studio 3.6 以降
Firebase アカウント
Google 広告アカウント

2. Firebase プロジェクトを作成して設定する

Firebase の使用を開始するには、Firebase プロジェクトを作成して設定する必要があります。

Firebase プロジェクトを作成する

Firebase にログインします。

Firebase コンソールで [プロジェクトを追加]（または [プロジェクトを作成]）をクリックし、Firebase プロジェクトに必要な名前を付けます。

プロジェクト作成オプションをクリックします。Firebase の利用規約が表示されたら同意します。アクションイベントとコンバージョンをトラッキングするには Google アナリティクスイベントが必要であるため、このプロジェクトでは Google アナリティクスを有効にする必要があります。

Firebase プロジェクトの詳細については、Firebase プロジェクトについて理解するをご覧ください。

Google アナリティクスアカウントを選択します。すでに存在する場合は、これを選択するか、新規に作成します。[プロジェクトを作成] ボタンをクリックします。

これで Firebase プロジェクトのビルドが完了しました。

次のステップでは、Firebase を Android アプリに追加する方法を学びます。

3. Firebase を Android アプリに追加する

アプリを登録する

Firebase コンソールの左側のナビゲーションで [プロジェクトの概要] を選択し、[アプリに Firebase を追加して利用を始めましょう] の下にある [Android] ボタンをクリックします。

必要な情報を入力します。

Android パッケージ名の場合は、Android Studio でアプリディレクトリに移動し、build.gradle という名前のファイルを開きます。ファイル内で applicationId を検索します。この値は Android パッケージ名です。この値をコピーして貼り付けてください。

Google ログインまたは Firebase Dynamic Links を使用する予定がない場合は、SHA-1 鍵は必要ありません（SHA-1 鍵について詳しくは、こちらのドキュメントをご覧ください）。これらはこの Codelab の一部ではありません。

[アプリの登録] ボタンをクリックします。

構成ファイルをダウンロードする

[google-services.json をダウンロード] ボタンをクリックして、構成ファイル google-services.json をダウンロードします。

Android Studio で app ディレクトリに移動し、先ほどダウンロードした google-services.json ファイルを app ディレクトリに移動します。Firebase コンソールに戻り、[次へ] ボタンをクリックします。

アプリで Firebase を有効にする

Firebase によって生成された google-services.json ファイルを読み取るには、Google サービスの Gradle プラグインが必要です。
Android Studio で <project>/build.gradle を開き、ファイルに次の行を追加します。

buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}

<project>/<app-module>/build.gradle を開き、次の行をファイルに追加します。

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

これで Android アプリに Firebase を追加できました。

次のステップでは、Firebase SDK をアプリに追加する方法を学びます。

4. アプリに Firebase SDK を追加する

このステップでは、Firebase SDK（具体的には Google アナリティクス用の Firebase SDK）を追加します。

ここでは Firebase Android BoM を使用します。BoM のバージョンを指定して、アプリで使用している Firebase ライブラリのバージョンを管理できます。特定の BoM バージョンにマッピングされている Firebase ライブラリのバージョンについては、その BoM バージョンのリリースノートをご覧ください。

<project>/<app-module>/build.gradle を開き、次の行をファイルに追加します。

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

ご覧のように、BoM のバージョンのみを指定することで、Firebase 向け Google アナリティクスライブラリのバージョンを指定する必要はありません。ただし、BoM で指定されたバージョンに関係なく Firebase ライブラリに必要なバージョンを使用する場合は、次のように目的のバージョンを指定するだけで済みます。

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'

次に、[Sync Now] ボタンをクリックしてアプリを同期します。

これで、Google アナリティクス向け Firebase SDK を Android アプリに追加する作業が完了しました。

次のステップでは、Android アプリで Firebase イベントをロギングする方法を学習します。

5. Firebase 向け Google アナリティクスを使用してイベントをロギングする

このステップでは、Android アプリの Firebase Analytics を使用してイベントをロギングする方法を学習します。

イベントをロギングする方法には、推奨イベントを使用する方法とカスタムイベントを使用する方法の 2 つがあります。

推奨イベントを使用する

Firebase Analytics SDK には、ゲーム、小売、旅行、e コマースなど、さまざまな種類のアプリで使用できる推奨イベントが多数定義されています。また、既定のパラメータを必要とする推奨イベントもあります。これらのパラメータを使用すると、Firebase レポートで最大限に詳しい情報を入手できます。（推奨イベントのリファレンス）。

アクティビティの最上位で FirebaseAnalytics オブジェクトを宣言します。

private lateinit var firebaseAnalytics: FirebaseAnalytics

onCreate() メソッドでオブジェクトを初期化します。

firebaseAnalytics = Firebase.analytics

logEvent() メソッドを使用して、イベントのロギングを開始します。次のコードは、ユーザーがアプリ内でアイテムを購入すると PURCHASE イベントをログに記録します。

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

カスタムイベントの使用

推奨イベントに含まれていないイベントが必要な場合は、カスタムパラメータを使用して独自のカスタムイベントをロギングできます。

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

デバッグイベント

Firebase コンソールでは、イベントに関する集計データやレポートを表示できます。ただし、更新は 1 日を通じて定期的に行われるため、アプリにログインした直後にイベントを表示することはできません。

Firebase Debugview を使用すると、すぐにテストとデバッグを行うことができます。DebugView を使用すると、開発デバイス上のアプリによって記録されたイベントデータをほぼリアルタイムで参照できます。DebugView については、デバッグイベントのセクションをご覧ください。

これで、Android アプリへのイベントのロギングは完了です。

次のステップでは、これらのイベントを Google 広告にインポートする方法について説明します。

6. Firebase イベントを Google 広告にインポートする

Firebase と Android の設定が完了し、ログに記録されたアクションイベントを使用してアプリキャンペーンを開始できるようになりました。まず Firebase を Google 広告にリンクします。Firebase を Google 広告にリンクすると、アプリキャンペーンでオーディエンスについて理解を深め、アプリキャンペーンの学習効果を高めることができるため、パフォーマンスとコンバージョンの向上につながります。

Firebase と Google 広告をリンクする

[プロジェクトの概要] の隣にあるボタンをクリックして、[Firebase 設定] に移動します。

[統合] タブに、Google 広告と [リンク] ボタンが表示されます。[リンクして続行] をクリックします。

リンクする Google 広告アカウントを選択します。

これで Firebase と Google 広告のリンクが完了しました。Firebase イベントを Google 広告にインポートしましょう。

Firebase イベントをインポートする

Firebase コンソールで [イベント] メニューに移動し、コンバージョンとしてインポートするイベントにマークを付けます。

Google 広告に移動して、Firebase とリンクしたアカウントにログインします。
Google 広告で、[ツール] → [測定] → [コンバージョン] に移動します。
+ ボタンをクリックします
[アプリ] → [Google アナリティクス 4 プロパティ（Firebase）] を選択し、[続行] をクリックします。
コンバージョンとしてマークされたすべてのアナリティクスイベントを確認できます。インポートするイベントを見つけます。ここでは、以前に実装した delete_item イベントを選択します。[Import and Continue] ボタンをクリックします。
これで、コンバージョンイベントが Firebase からインポートされました。