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

1. はじめに

最終更新日: 2021 年 2 月 19 日

作成するアプリの概要

この Codelab では、Unity 環境で GA4F iOS を使用してカスタムイベントを実装し、Google 広告でアクションキャンペーンを開始する方法を学びます。

この Codelab では、クライアントが直面しているアプリビジネスの全プロセスを体験できます。iOS で Firebase と AdMob を簡単に紹介するチュートリアルについては、AdMob+Firebase 101 Unity: Setup & Analytics Basics をご覧ください。

学習内容

Unity + iOS で GA4F（Firebase 向け Google アナリティクス）を初期化する方法。
カスタムのイベントとパラメータの作成方法
Firebase から Google 広告にイベントをインポートする方法。
カスタムイベントを使用したアクションキャンペーンの開始

必要なもの

Xcode
Unity
Firebase アカウント
Google 広告アカウント

2. 新しい Unity プロジェクトを開始する

テンプレート化された簡単な Unity アプリを作成し、この簡単なアプリを修正して最終的なアプリを完成させます。

Unity を起動する

開いているプロジェクトがない場合は、[新しいプロジェクトを作成] を選択します。
ダイアログで 3D テンプレートを選択します。
[Project Name]（プロジェクト名）に「Unity Firebase Custom Event」などの名前を入力します。
プロジェクトの保存場所を選択して、[作成] をクリックします。
Unity で新しいプロジェクトがワークスペースウィンドウで開きます。

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

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

Google アナリティクスが有効になっていない既存の Firebase プロジェクトがある場合は、[設定] > [プロジェクトの設定] の [統合] タブで Google アナリティクスを有効にできます。Firebase の設定手順に進みます。

Firebase にログインします。

Firebase コンソールで、[プロジェクトを追加]（または [プロジェクトを作成]）をクリックし、Firebase プロジェクトに「Firebase-iOS-Ads」という名前を付けます。

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

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

4. Unity の構成

Unity の [File] > [Build Settings] で、重要な値は iOS バンドル ID を設定することです。次の手順で取得します。

次のダイアログが表示されます。

iOS アプリの Unity プロジェクトで、[Build Settings] ダイアログ（[File] > [Build Settings]）を開きます（プラットフォームが iOS に設定されていない場合は、iOS プラットフォームを選択して [Switch Platform] ボタンをクリックします）。

プラットフォームを変更したら、[Player Settings] ボタンをクリックしてバンドル ID を設定します。[Identification] 領域の周囲にテキストフィールドが表示されます。
[Bundle Identifier] フィールドの値が iOS バンドル ID です（例: com.yourcompany.yourproject）。この値をコピーするか、値を設定してコピーします。
Firebase のダイアログで、コピーしたバンドル ID を iOS bundle ID フィールドに貼り付けます。
[アプリを登録] をクリックします。
引き続き Firebase 内で、指示に沿って構成ファイル GoogleService-Info.plist をダウンロードします。
Unity プロジェクトの [Project] ウィンドウを開き、構成ファイルを Assets フォルダに移動します。
残りの手順をスキップして、Firebase コンソールのメインページに戻ります。

5. Unity で Firebase 向け Google アナリティクスを構成する

このステップでは、Unity プロジェクトに Firebase SDK を追加します。

Firebase コンソールに移動します。
プロジェクトの概要ページの中央にある Unity アイコン（）をクリックして、設定ワークフローを起動します。すでに Firebase プロジェクトにアプリを追加している場合は、[アプリを追加] をクリックするとプラットフォームのオプションが表示されます。
登録する Unity プロジェクトのビルドターゲットを選択するか、両方のターゲットを同時に登録することもできます。

Unity プロジェクトのプラットフォーム固有の ID を入力します。

iOS の場合 - Unity プロジェクトの iOS ID を [iOS バンドル ID] に入力します。
Android の場合 - Unity プロジェクトの Android ID を [Android パッケージ名] に入力します。「パッケージ名」と「アプリケーション ID」は、しばしば同じ意味で使用されます。

Unity プロジェクトの ID はどこで確認できますか？

（省略可）Unity プロジェクトのプラットフォーム固有のニックネームを入力します。これらのニックネームは内部用の簡便な ID であり、Firebase コンソールにのみ表示されます。
[アプリの登録] をクリックします。

Firebase アナリティクス Unity SDK を追加する

Firebase コンソールで [Firebase Unity SDK をダウンロード] をクリックし、適切な場所で SDK を解凍します。

Firebase Unity SDK はいつでも再ダウンロードできます。
Firebase Unity SDK はプラットフォーム固有ではありません。

開いている Unity プロジェクトで、[Assets] > [Import Package] > [Custom Package] を選択します。
解凍した SDK から、アプリで使用するサポートされている Firebase プロダクトを選択します。

Google アナリティクスの Firebase パッケージ FirebaseAnalytics.unitypackage を追加します。
アプリで使用する Firebase プロダクトのパッケージを追加します。たとえば、Firebase Authentication と Firebase Realtime Database を使用する場合: FirebaseAuth.unitypackage と FirebaseDatabase.unitypackage

[Import Unity Package] ウィンドウで [Import] をクリックします。
Firebase コンソールの設定ワークフローに戻り、[次へ] をクリックします。

6. Firebase 向け Google アナリティクスを使用してカスタムイベントを記録する

このステップでは、Unity iOS アプリで Firebase Analytics を使用してカスタムイベントを記録する方法を学びます。

Firebase Analytics では、一部のイベントが自動的にロギングされるので、それらのイベントを受信するコードを追加する必要はありません。それ以外のデータをアプリで収集する場合は、最大 500 種類までのアナリティクスカスタムイベントをロギングできます。

イベントをロギングする

FirebaseApp インスタンスを構成すると、logEvent() メソッドを使ってイベントをログに記録できるようになります。

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Xcode デバッグコンソールでイベントを表示する

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

詳細ログを有効にする方法は、次のとおりです。

Xcode で [Product] > [Scheme] > [Edit scheme] の順に選択します。
左側のメニューから [Run] を選択します。
[Arguments] タブを選択します。
[Arguments Passed On Launch] セクションで -FIRAnalyticsDebugEnabled を追加します。

以後、アプリを実行すると Xcode のデバッグコンソールにイベントが表示され、イベントが送信されているかどうかをすぐに確認できます。

ダッシュボードでイベントを表示する

数時間後には、ログに記録されたイベントを Firebase コンソールで確認できるようになります。[アナリティクス] → [イベント] にあります。イベントをクリックしてパラメータ値を確認することもできます。

[コンバージョンとしてマークを付ける] スイッチを右にスライドして、「text_search」をコンバージョンとしてマークします。

イベントがコンバージョンとして正常にマークされているかどうかは、Firebase アナリティクスの [コンバージョン] タブで確認できます。イベントをコンバージョンとしてマークすることで、Google 広告にイベントをコンバージョンとしてインポートすることもできます。

7. Google 広告にアナリティクスイベントをインポートする

Firebase-iOS の設定が完了したら、アクションイベントが記録されたアプリキャンペーンを立ち上げることができます。まず、Firebase を Google 広告にリンクします。Firebase を Google 広告にリンクすると、アプリキャンペーンでオーディエンスに関する詳細な情報を取得し、アプリキャンペーンの学習を促進できます。これにより、通常はパフォーマンスとコンバージョンが向上します。

[プロジェクトの概要] の隣のボタンをクリックして、Firebase 設定に移動します。
[統合] タブで、Google 広告とリンクボタンが表示されます。[リンクして続行] をクリックします。

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

これで Firebase の部分は完了です。

Google 広告に移動してログインします。

Google 広告にアクセスしてログインし、[ツールと設定] → [測定] → [コンバージョン] に移動して、カスタムイベントをコンバージョンとしてインポートします。
[+] ボタンをクリックすると、新しいコンバージョンアクションが追加されます。

Google アナリティクス 4 プロパティ（Firebase）を選択し、[続行] をクリックします。

コンバージョンとしてマークされたすべてのアナリティクスイベントが表示されます。以前に実装した clicked_counter イベントを探します。

チェックボックスをオンにして、[インポートして続行] ボタンをクリックします。

コンバージョンアクションとして text_search を設定したら、text_search イベントを起動する可能性の高いユーザーをターゲットとするキャンペーンを開始します。

8. インポートされたイベントを使ってアプリアクションキャンペーンを開始する

現在のアカウントの [キャンペーン] タブに移動し、[+] ボタンをクリックして新しいキャンペーンを作成します。新しいキャンペーンをクリックして続行します。
今回は、[アプリインストール] オプションでアプリインストール広告キャンペーンを起動します。

アプリ名、パッケージ名、またはパブリッシャーを入力してアプリを検索します。
[単価設定] セクションで、[重視している要素は何ですか？] のプルダウンから [アプリ内ユーザー行動] を選択します。
一覧にカスタムイベントが表示されます。目標コンバージョン単価を設定し、その他のオプションを入力します。

キャンペーンの設定を行います。これは Codelab の範囲外です。設定の最適化については、これらのドキュメントを参照するか、他のチャネルからお問い合わせください。

9. 完了

これで Firebase と Unity、Google 広告の統合が完了しました。これにより、キャンペーンのパフォーマンスを向上させることができます。

学習した内容

Unity iOS プラットフォーム用に Firebase を構成する方法
Unity と Firebase 向け Google アナリティクスを使用してカスタムイベントを記録する方法
イベントをインポートして、アクションキャンペーンで使用する方法