Firebase カスタム イベント向け Google アナリティクスを使用した Google 広告 - Android

1. はじめに

最終更新日: 2020-12-14

何を構築するか

このコードラボでは、Firebase 向け Google アナリティクス(GA4F)を使用してイベントを実装し、Google 広告を通じてアクション キャンペーンを開始する方法を学びます。

このコードラボは、GA4F を使用したイベントの実装と、Google 広告へのイベントのインポートに焦点を当てています。 Firebase を使用して Android アプリを構築する方法について知りたい場合は、 「Firebase Android Codelab - Build Friendly Chat」を参照してください。

学べること

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

必要なもの

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

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

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

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

  1. Firebaseにサインインします。

Firebase コンソールで、「プロジェクトを追加」(または「プロジェクトを作成」) をクリックし、Firebase プロジェクトに任意の名前を付けます。

8525e77df3536fbb.png

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

e58151a081f0628.png

Firebase プロジェクトの詳細については、 「Firebase プロジェクトを理解する」を参照してください。

  1. Google アナリティクス アカウントを選択します。ある場合はそれを選択するか、新しいものを作成します。 「プロジェクトの作成」ボタンをクリックします。

ac928e5947ba7cbf.png

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

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

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

アプリを登録する

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

6cbb33ad3e7c9132.png

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

3b7d3b33d81fe8ea.png

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

Google サインインまたはFirebase Dynamic Linksを使用する予定がない限り、ここでは SHA-1 キーは必要ありません (これらはこのコードラボの一部ではないことに注意してください。SHA-1 キーの詳細については、このドキュメントを参照してください)。 。

  1. 「アプリの登録」ボタンをクリックします。

設定ファイルをダウンロードする

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

52f08aa18c8d59d0.png

  1. Android Studio で、 appディレクトリに移動し、 google-services.jsonファイル (上記でダウンロードしたばかり) をappディレクトリに移動します。 Firebase コンソールに戻り、「次へ」ボタンをクリックします。

アプリで Firebase を有効にする

  1. Firebase によって生成されたgoogle-services.jsonファイルを読み取るには、 Google Services Gradle プラグインが必要です。
  2. 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
      ...
      }
   }
}
  1. <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 Analytics 用の Firebase SDK を追加します。

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

  1. <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 Analytics ライブラリのバージョンを指定する必要はありません。ただし、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'
  1. [今Sync Nowボタンをクリックしてアプリを同期します。 937206076c88ae5c.png

これで、Android アプリへの Google アナリティクス用 Firebase SDK の追加が完了しました。

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

5. Firebase Analytics を使用してイベントをログに記録する

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

イベントのログ記録には 2 つの方法があります。提案されたイベントを使用する方法とカスタム イベントを使用する方法です。

提案されたイベントの使用

Firebase Analytics SDK は、ゲーム、小売、旅行、e コマースなどのさまざまなタイプのアプリで使用できる多数の推奨イベントを定義します。また、所定のパラメータを必要とする推奨イベントがいくつかあり、それらのパラメータを使用すると、Firebase レポートで利用可能な詳細を最大限に活用できます。 (おすすめイベント参照)

  1. アクティビティの先頭で FirebaseAnalytics オブジェクトを宣言します。
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. onCreate()メソッドでオブジェクトを初期化します。
firebaseAnalytics = Firebase.analytics
  1. 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 広告にリンクすると、アプリ キャンペーンはオーディエンスについてさらに学習できるようになり、アプリ キャンペーンの学習が促進され、通常はパフォーマンスとコンバージョンの向上につながります。

  1. 「プロジェクト概要」のすぐ横にあるボタンをクリックして、「Firebase 設定」に移動します。

412830708c61fdc0.png

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

796c921fb2b873ae.png

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

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

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

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

a5f302ba01a1863c.png

  1. 次に、Google 広告に移動し、Firebase にリンクしたアカウントにログインします。
  2. Google 広告で、[ツール] → [測定] → [コンバージョン] に移動します。 7acf268d7e799a7e.png
  3. +ボタンをクリックd0eed72946d038d8.png
  4. 「アプリ」→「Google アナリティクス 4 プロパティ (Firebase)」を選択し、「続行」をクリックします。 983f06edb15724de.png
  5. コンバージョンとしてマークされたすべての分析イベントを確認できます。インポートするイベントを見つけます。この場合は、以前に実装したdelete_itemイベントを選択します。 「インポートして続行」ボタンをクリックします。 f9bdee80c0d40999.png
  6. Firebase からコンバージョン イベントが正常にインポートされました。 be75f6a11913236.png

これで、Firebase イベントの Google 広告へのインポートが完了しました。

次のステップでは、インポートしたイベントを使用してアクション キャンペーンを開始する方法を学習します。

7. インポートされたイベントを使用したアプリ アクション キャンペーンの開始

  1. 現在の Google 広告アカウントの [アプリ キャンペーン] タブに移動し、[+] ボタンをクリックして新しいキャンペーンを開始します。

19856a65ab999ad7.png

  1. アプリのインストール オプションを備えたアプリ プロモーション キャンペーンを開始します。下部で、宣伝したいアプリを選択し、「続行」をクリックします。 8146b5a7a4f961bd.png
  2. [入札] セクションで、ドロップダウン メニューからアプリ内アクションを選択すると、イベントを表示できます。注目したいイベントを選択してください。

b75e410c7dbdfec8.png

  1. 残りのキャンペーン設定を設定して完了です。

8. おめでとうございます

おめでとうございます。Firebase と Google 広告が正常に統合されました。これはキャンペーンのパフォーマンスを向上させるのに役立ちます。

学びましたね

  • Android 向け Firebase Analytics を構成する方法
  • Android アプリで Firebase Analytics を使用してイベントを記録する方法。
  • イベントをインポートしてアクション キャンペーンに使用する方法。