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

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

1. はじめに

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

作成するアプリの概要

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

この Codelab を通じて、お客様が直面しているアプリビジネスのプロセス全体を体験できます。Firebase と iOS の AdMob についてよりわかりやすい概要を学習したい場合は、まず AdMob+Firebase 101 Unity: 設定とアナリティクスの基本をご覧ください。

学習内容

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

必要なもの

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

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

テンプレート化されたシンプルな Unity アプリを作成します。このシンプルなアプリを変更して、完成したアプリを作成します。

Unity を起動

開いているプロジェクトがない場合は、[新しいプロジェクトを作成] を選択します。
ダイアログで 3D テンプレートを選択します。
[Project Name] に入力します（例:Unity Firebase カスタムイベント。
プロジェクトを保存するロケーションを選択し、[作成] をクリックします。
Unity のワークスペースウィンドウで新しいプロジェクトが開きます。

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

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

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

Firebase にログインします。

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

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

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

4. Unity 構成

Unity の場合 >[ファイル] >ビルド設定。重要な値は iOS バンドル ID の設定です。これは次の手順で取得します。

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

iOS アプリの Unity プロジェクトで、[Build Settings] ダイアログを開きます。[File] >Build Settings（プラットフォームが iOS に設定されていない場合は、[iOS Platform] を選択して [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 アナリティクスを設定する

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

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

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

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

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

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

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

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

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

開いている Unity プロジェクトで、[Assets] >パッケージのインポート >カスタムパッケージ。
解凍した 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 向け Google アナリティクスを使用してカスタムイベントをロギングする方法を学習します。

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

イベントをロギングする

FirebaseApp インスタンスを構成すると、logEvent() メソッドでイベントのロギングを開始できます。

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

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

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

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

Xcode で、[Product] >スキーム >スキームを編集...
左側のメニューから [Run] を選択します。
[Arguments] タブを選択します。
[Arguments Passed On Launch] セクションで -FIRAnalyticsDebugEnabled を追加します。

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

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

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

[テキスト検索]を[コンバージョンとしてマークを付ける] をスイッチを右に切り替えてください。

イベントが正常にコンバージョンとしてマークされているかどうかは、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. イベントをインポートしてアプリアクションキャンペーンを開始する

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

アプリ名、パッケージ名、パブリッシャーを指定してアプリを検索します。
[単価設定] で、広告のアクションを重視するには、Google 広告のドロップボックスで [アプリ内コンバージョン] を選択します。
表示されるリストにカスタムイベントが表示されます。目標コンバージョン単価を設定し、その他のオプションを入力します。

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

9. 完了

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

学習した内容

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