Google Ads 搭配 Google Analytics for Firebase 自訂事件 - Unity

1. 簡介

上次更新時間：2021 年 2 月 19 日

建構項目

在本程式碼研究室中，您將瞭解如何在 Unity 環境中使用 GA4F iOS 實作自訂事件，並透過 Google Ads 推出行動號召廣告活動。

在這個程式碼研究室中，您可以體驗客戶使用的完整應用程式業務流程。如要進一步瞭解 iOS 版 Firebase 和 AdMob，請先參閱「AdMob 和 Firebase 101 入門：Unity 的設定與 Analytics 基本概念」。

課程內容

• 如何在 Unity + iOS 中初始化 GA4F (Google Analytics for Firebase)。
• 如何建立自訂事件和參數。
• 如何將事件從 Firebase 匯入 Google Ads。
• 使用自訂事件推出行動廣告活動。

軟硬體需求

• Xcode
• Unity
• Firebase 帳戶
• Google Ads 帳戶

2. 啟動新的 Unity 專案

建立簡易的 Unity 應用程式範本。您可以修改這個簡易應用程式，建立完成的應用程式。

啟動 Unity

1. 如果您沒有任何開放專案，請選取「建立新專案」。
2. 在對話方塊中選取 3D 範本。
3. 填寫專案名稱，例如「Unity Firebase 自訂事件」。
4. 選取位置來儲存專案，然後按一下「建立」。
5. Unity 會在工作區視窗中開啟您的新專案。

3. 建立及設定 Firebase 專案

如要開始使用 Firebase，您必須建立及設定 Firebase 專案。

如果您現有的 Firebase 專案未啟用 Google Analytics，可以前往「設定」>「專案設定」的「整合」分頁標籤啟用 Google Analytics。請繼續進行 Firebase 設定步驟。

1. 登入 Firebase。

在 Firebase 控制台中，按一下「新增專案」(或「建立專案」)，然後將 Firebase 專案命名為 Firebase-iOS-Ads

2. 點選專案建立選項。當系統顯示提示時，請接受 Firebase 條款。您需要為這項專案啟用 Google Analytics，因為您需要使用 Google Analytics 事件來追蹤動作事件和轉換。

如要進一步瞭解 Firebase 專案，請參閱「瞭解 Firebase 專案」一文。

4. Unity 設定

1. 在 Unity 中 > File > Build Settings。設定 iOS 軟體包 ID 非常重要，您會透過下列步驟取得這個 ID。

您會看到下圖所示的對話方塊。

2. 在 iOS 應用程式的 Unity 專案中，開啟「Build Settings」對話方塊，然後依序點選「File」>「Build Settings」 (如果平台未設定為 iOS，您可以選取 iOS 平台，然後按一下「Switch Platform」按鈕)

3. 平台變更後，請按一下「Player Settings」按鈕，設定 bundle ID。「識別」區域周圍會顯示文字欄位。
4. 「軟體包 ID」欄位的值是 iOS 軟體包 ID (如 com.yourcompany.yourproject)。請複製或設定這個值，然後加以複製。
5. 在 Firebase 對話方塊中，將複製的套件 ID 貼到 iOS bundle ID 欄位。
6. 按一下「註冊應用程式」。
7. 繼續在 Firebase 中按照操作說明下載設定檔 GoogleService-Info.plist
8. 開啟 Unity 專案的「Project」視窗，然後將設定檔移至「Assets」資料夾。
9. 請略過其餘步驟，返回 Firebase 控制台主頁面。

5. 在 Unity 中設定 Firebase Analytics

在此步驟中，您要開始將 Firebase SDK 新增至您的 Unity 專案。

1. 前往 Firebase 控制台。
2. 在專案總覽頁面的中間，按一下 Unity 圖示 () 啟動設定工作流程。如果您已將應用程式新增至 Firebase 專案，請按一下「Add app」，顯示平台選項。
3. 選取您要註冊的 Unity 專案的建構目標，或選擇立即註冊兩個目標。

注意：如果您現在只註冊 Unity 專案的一個版本目標，日後隨時都可以返回設定工作流程，註冊其他版本目標。

4. 輸入 Unity 專案的平台專屬 ID。

• iOS：在「iOS 軟體包 ID」欄位中輸入 Unity 專案的 iOS 編號。
• Android：在「Android package name」(Android 套件名稱) 欄位中輸入 Unity 專案的 Android ID。「套件名稱」和「應用程式 ID」經常交替使用。

5. 如何找到 Unity 專案的 ID？

注意：請務必輸入專案實際使用的 ID。ID 值有大小寫之分，且在 Firebase 專案註冊這些 Firebase 應用程式後，就無法變更。

6. (選用) 輸入 Unity 專案的平台專屬暱稱。這些暱稱是內部便利 ID，只有您在 Firebase 控制台中看得到。
7. 按一下 [Register app] (註冊應用程式)。

新增 Firebase Analytics Unity SDK

1. 在 Firebase 控制台中，按一下「Download Firebase Unity SDK」，然後將 SDK 解壓縮。

• 您隨時可以重新下載 Firebase Unity SDK。
• Firebase Unity SDK 並非平台專用。

2. 在您開啟的 Unity 專案中，依序前往「Assets」>「Import Package」>「Custom Package」。
3. 在已解壓縮的 SDK 中，選取要在應用程式中使用的支援的 Firebase 產品。

• 新增 Google Analytics 專用 Firebase 套件：FirebaseAnalytics.unitypackage
• 如要在應用程式中使用任何其他 Firebase 產品，請新增套件。舉例來說，如果想使用 Firebase 驗證和 Firebase 即時資料庫，則可使用 FirebaseAuth.unitypackage 和 FirebaseDatabase.unitypackage

Unity 5.x 以下版本使用 .NET 3.x 架構，因此請匯入 dotnet3/ 套件。Unity 2017.x 以上版本允許使用 .NET 4.x 架構。如果 Unity 專案使用 .NET 4.x，請匯入 dotnet4/ 套件。Unity 2019 以上版本不再支援 .NET 3.x 架構，因此請匯入 dotnet4/ 套件。

4. 在「Import Unity Package」視窗中，按一下「Import」。
5. 返回 Firebase 控制台，在設定工作流程中點選「下一步」。

重要事項：使用 iOS 版 Firebase Unity SDK 時，請不要停用方法滑動功能。SDK 需要進行 swizzling，否則主要 Firebase 功能 (例如 FCM 權杖處理) 無法正常運作。

6. 使用 Firebase 數據分析記錄自訂事件

在這個步驟中，您將瞭解如何在 Unity iOS 應用程式中，使用 Firebase Analytics 記錄自訂事件。

Firebase Analytics 會自動記錄部分事件，您不必加入任何程式碼即可接收這些事件。如果應用程式需要收集其他資料，您最多可以在應用程式中記錄 500 種 Analytics 自訂事件類型。

記錄事件

設定 FirebaseApp 執行個體後，開始使用 logEvent() 方法記錄事件。

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

在 Xcode 偵錯主控台中查看事件

您可以啟用詳細記錄功能，監控 SDK 記錄的事件，以便確認事件是否已正確記錄。這包括自動和手動記錄的事件。

您可以使用以下指令啟用詳細記錄功能：

1. 在 Xcode 中，選取「Product」>「Schee」>「Edit scheme...」
2. 在左選單中選取「執行」。
3. 選取「Arguments」分頁標籤。
4. 在「傳遞時傳遞的引數」部分，新增 -FIRAnalyticsDebugEnabled。

下次執行應用程式時，事件會顯示在 Xcode 偵錯控制台中，讓您立即驗證事件是否正在傳送。

在資訊主頁中查看事件

記錄事件會在幾小時後顯示於 Firebase 控制台。位於 Analytics →「事件」中。您也可以點選事件來查看參數值。

將「標示為轉換」切換鈕滑動至右側，即可將「text_search」標示為轉換。

您可以透過 Firebase 數據分析的「轉換」分頁，再次確認事件是否已成功標示為轉換。將事件標示為轉換後，Google Ads 也能將該事件匯入為轉換。

7. 在 Google Ads 中匯入數據分析事件

Firebase iOS 設定已完成，您可以開始放送記錄動作事件的應用程式廣告活動。請先將 Firebase 連結至 Google Ads，將 Firebase 連結至 Google Ads 後，應用程式廣告活動就能進一步瞭解目標對象，並提升應用程式廣告活動的學習效果，進而提升成效和轉換。

1. 點選「專案總覽」旁邊的按鈕，前往 Firebase 設定。
2. 「整合」分頁會顯示 Google Ads 和「連結」按鈕。按一下「連結並繼續」。

3. 選擇 Google Ads 帳戶。

注意：如果目標事件未標示為轉換，Google Ads 就無法匯入該事件。確認事件已正確標示為轉換。

Firebase 部分的設定已完成。

現在，請前往 Google Ads 並登入。

1. 前往 Google Ads 並登入，然後依序前往「工具與設定」→「評估」→「轉換」，即可匯入自訂事件做為轉換。
2. 按一下「+」按鈕，新增轉換動作。

3. 選擇「Google Analytics 4 資源 (Firebase)」，然後點選「繼續」。

4. 您可以查看所有標示為轉換的數據分析事件。找出我們先前實作的 clicked_counter 事件。

5. 勾選並按一下「匯入並繼續」按鈕。

將 text_search 設為轉換動作後，接下來就是推出廣告活動，並指定可能會觸發 text_search 事件的使用者。

8. 使用匯入的事件推出應用程式行動廣告活動

重要事項：如要推出應用程式廣告活動，您必須在 Google Play 中發布正式版應用程式。如果您尚未準備好發布應用程式，請暫時略過這個步驟。

6. 前往目前帳戶的 [廣告活動] 分頁，然後按一下「+」按鈕開始放送新的廣告活動。按一下新廣告活動並繼續操作。
7. 目前，我們將推出應用程式宣傳廣告活動，提供「應用程式安裝」選項。

8. 提供應用程式名稱、套件名稱或發布商，即可找到應用程式。
9. 在「出價」部分中，選取「應用程式內動作」下拉式選單中的「廣告」以著重於動作。
10. 您可以在提供的清單中找到自訂事件。設定目標單次動作出價，並填寫其他選項。

11. 設定廣告活動。這不在程式碼研究室的範圍內，因此請參閱這些文件，或透過其他管道聯絡我們，以便我們協助您調整設定。

9. 恭喜

恭喜，您已成功將 Firebase 整合至 Unity 和 Google Ads！這有助於提升廣告活動成效。

您已學習

• 如何為 Unity iOS 平台設定 Firebase
• 如何使用 Unity 和 Firebase Analytics 記錄自訂事件
• 如何匯入事件，並用於行動廣告活動。

參考文件

• 將 Firebase 新增至您的 Unity 專案
• GitHub：firebase/quickstart-unity