1. はじめに
最終更新日: 2021-02-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 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 Platform] を選択して [Switch Platform] ボタンをクリックします。
- プラットフォームを変更したら、[Player Settings] ボタンをクリックしてバンドル ID を設定します。[Identification] 領域の近くにテキスト フィールドが表示されます。
- [Bundle Identifier] フィールドの値が iOS バンドル ID です（
com.yourcompany.yourprojectなど）。この値をコピーするか、値を設定してコピーします。 - Firebase のダイアログで、コピーしたバンドル ID を
iOS bundle IDフィールドに貼り付けます。 - [Register App] をクリックします。
- 引き続き 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 向け 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 アナリティクスの [Conversions] タブで確認できます。イベントをコンバージョンとしてマークすると、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 アナリティクスを使用してカスタム イベントを記録する方法
- イベントをインポートして、アクション キャンペーンで使用する方法