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

Firebase 向け Google アナリティクスのカスタムイベントを使用した 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 プロジェクトのビルドが完了しました。

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

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

アプリを登録する

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

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

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

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

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

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

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

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

アプリで Firebase を有効にする

Firebase によって生成された google-services.json ファイルを読み取るための Google Services 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 アナリティクスライブラリのバージョンを指定する必要がなくなります。ただし、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] ボタンをクリックしてアプリを同期します。

これで、Android アプリに Google アナリティクス用の Firebase SDK を追加できました。

次のステップでは、Android アプリで Firebase イベントを記録する方法について説明します。

5. Firebase 向け Google アナリティクスでイベントを記録する

このステップでは、Android アプリで Firebase アナリティクスを使用してイベントを記録する方法について説明します。

イベントを記録するには、推奨イベントまたはカスタムイベントの 2 つの方法があります。

推奨イベントを使用する

Firebase アナリティクス 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 イベントを選択します。[インポートして続行] ボタンをクリックします。
Firebase からコンバージョンイベントをインポートしました。