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

1. 簡介

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

建構項目

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

在這個程式碼研究室中，您可以體驗客戶使用的完整應用程式業務流程。如果您想概略瞭解 Firebase 和 iOS 適用的 AdMob 和 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 中 >檔案 >。設定 iOS 軟體包 ID 非常重要，您會透過下列步驟取得這個 ID。

下一個畫面會顯示對話方塊。

2. 在 iOS 應用程式的 Unity 專案中，開啟「Build Settings」對話方塊，然後開啟「File」版本設定 (若「平台」未設定為 iOS，您可以選取 iOS 平台，並按一下切換平台按鈕)

3. 平台變更後，按一下「播放器設定」按鈕即可設定軟體包 ID。「識別」區域周圍會顯示文字欄位。
4. 「軟體包 ID」欄位的值是 iOS 軟體包 ID (格式為 com.yourcompany.yourproject)。複製或設定這個值，然後加以複製。
5. 在 Firebase 對話方塊中，將複製的軟體包 ID 貼到 iOS bundle ID 欄位中。
6. 按一下「Register App」。
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。這個值有大小寫之分，而且向 Firebase 專案註冊這些 Firebase 應用程式後，就無法變更 ID 值。

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」>自訂套件。
3. 在已解壓縮的 SDK 中，選取要在應用程式中使用支援的 Firebase 產品。

• 加入 Google Analytics：FirebaseAnalytics.unitypackage 的 Firebase 套件
• 針對您要在應用程式中使用的所有其他 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 必須使用 Swizz；否則重要 Firebase 功能 (例如 FCM 權杖處理) 將無法正常運作。

6. 使用 Firebase Analytics 記錄自訂事件

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

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

記錄事件

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

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

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

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

您可以按照下列方式啟用詳細記錄功能：

1. 在 Xcode 中，選取 [Product] (產品) > 配置 >編輯配置...
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. 您可以查看所有標示為轉換的 Analytics 事件。找出先前導入的 clicked_counter 事件。

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

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

8. 推出包含匯入事件的影片行動廣告活動

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

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

8. 提供應用程式名稱、套件名稱或發布商來找出應用程式。
9. 在「出價」部分的 Dropbox 中，選取「應用程式內動作」，讓「廣告」優先顯示動作。
10. 您可以在提供的清單中查看自訂事件設定單次動作出價，然後填入其他選項。

11. 調整廣告活動設定。其內容不在程式碼研究室的介紹範圍內，請參考這些文件，或透過任何其他管道洽詢最佳化設定。

9. 恭喜

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

您已瞭解

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

參考文件

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