1. はじめに
最終更新日: 2021 年 2 月 19 日
作成するアプリの概要
この Codelab では、Unity 環境で GA4F iOS を使用してカスタム イベントを実装し、Google 広告でアクション キャンペーンを開始する方法を学びます。
この Codelab を通じて、お客様が直面しているアプリビジネスのプロセス全体を体験できます。iOS での Firebase と AdMob のよりわかりやすい概要を学ぶには、AdMob + Firebase 101 Unity: 設定とアナリティクスの基本をご覧ください。
学習内容
- Unity と iOS で GA4F（Firebase 向け Google アナリティクス）を初期化する方法
- カスタムのイベントとパラメータの作成方法
- Firebase から Google 広告にイベントをインポートする方法。
- カスタム イベントを使用したアクション キャンペーンの開始
必要なもの
- Xcode
- Unity
- Firebase アカウント
- Google 広告アカウント
2. 新しい Unity プロジェクトを開始する
テンプレート化された簡単な Unity アプリを作成します。この簡単なアプリを変更して、最終的なアプリを作成します。
Unity を起動する
- 開いているプロジェクトがない場合は、新しいプロジェクトの作成を選択します。
- ダイアログから 3D テンプレートを選択します。
- プロジェクト名を入力します（例: Unity Firebase カスタム イベント）。
- プロジェクトを保存するロケーションを選択し、[作成] をクリックします。
- 新しいプロジェクトがワークスペース ウィンドウで開きます。
3. Firebase プロジェクトを作成して設定する
Firebase の利用を開始するには、Firebase プロジェクトを作成して設定する必要があります。
既存の Firebase プロジェクトで Google アナリティクスが有効になっていない場合は、[設定] > [プロジェクト設定] の [統合] タブで Google アナリティクスを有効にできます。Firebase の構成ステップに進みます。
- Firebase にログインします。
Firebase コンソールで [プロジェクトを追加]（または [プロジェクトを作成]）をクリックし、Firebase プロジェクトに Firebase-iOS-Ads という名前を付けます。
- プロジェクト作成オプションをクリックします。プロンプトが表示されたら、Firebase の利用規約に同意します。アクション イベントとコンバージョンをトラッキングするには Google アナリティクス イベントが必要であるため、このプロジェクトでは Google アナリティクスを有効にする必要があります。
Firebase プロジェクトの詳細については、Firebase プロジェクトについて理解するをご覧ください。
4. Unity 構成
- [Unity] > [File] > [Build Settings] に移動します。重要な値は iOS バンドル ID の設定です。これは次の手順で取得します。
次のダイアログが表示されます。
- iOS アプリの Unity プロジェクトで、[File] > [Build Settings] をクリックして Build Settings ダイアログを開きます（プラットフォームが iOS に設定されていない場合は、iOS プラットフォームを選択し、[Switch Platform] ボタンをクリックします）。
- プラットフォームを変更したら、[Player Settings] ボタンをクリックしてバンドル ID を設定します。[身分証明書] の周囲にテキスト フィールドが表示されます。
- [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] > [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 向け Google アナリティクスを使用してカスタム イベントをロギングする方法を学習します。
Firebase 向け Google アナリティクスでは、一部のイベントが自動的にロギングされるので、それらのイベントを受信するコードを追加する必要はありません。アプリでそれ以外のデータを収集する必要がある場合は、最大 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. インポートされたイベントを使ってアプリ アクション キャンペーンを開始する
- 現在のアカウントの [キャンペーン] タブに移動し、[+] ボタンをクリックして新しいキャンペーンを作成します。新しいキャンペーンをクリックして続行します。
- 今回は、[アプリ インストール] オプションでアプリ インストール広告キャンペーンを起動します。
- アプリ名、パッケージ名、またはパブリッシャーを指定してアプリを検索します。
- [単価設定] で、広告のアクションを重視するには、Google 広告のドロップボックスで [アプリ内コンバージョン] を選択します。
- 表示されるリストにカスタム イベントが表示されます。目標コンバージョン単価を設定し、その他のオプションを入力します。
- キャンペーンの設定を構成します。これは Codelab の対象外です。設定の最適化については、これらのドキュメントを参照するか、他のチャネルを通じてお問い合わせください。
9. 完了
これで Firebase を Unity と Google 広告に正常に統合できました。これにより、キャンペーンのパフォーマンスを向上させることができます。
学習した内容
- Firebase for Unity の iOS プラットフォームを構成する方法
- Unity と Firebase 向け Google アナリティクスを使用してカスタム イベントを記録する方法
- イベントをインポートしてアクション キャンペーンで使用する方法