本頁面由 Cloud Translation API 翻譯而成。

Google Ads 與 Google Analytics for Firebase 自訂事件 - iOS

1. 簡介

上次更新時間：2020 年 12 月 14 日

建構項目

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

透過這個程式碼研究室，您可以體驗我們的客戶所面對的應用程式業務整個流程。如想概略瞭解 Firebase iOS，請先選擇「Firebase iOS Codelab Swift」。

課程內容

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

軟硬體需求

Xcode
Firebase 帳戶
Google Ads 帳戶

2. 建立新的 iOS Swift 專案

建立簡易的 iOS Swift 應用程式範本。您將修改這個範例應用程式，以便建立完成的應用程式。

首先，啟動 Xcode

如果您尚未建立專案，請在歡迎頁面中選取「建立新的 Xcode 專案」。
在對話方塊頂端選取「iOS」。
在「應用程式」部分選取「應用程式」，然後點選「下一步」。
在隨即顯示的對話方塊中，使用以下的值為應用程式命名，並為專案選擇其他選項，然後按一下「下一步」：
產品名稱：例如iOS 應用程式

Xcode 會使用您輸入的產品名稱來為專案和應用程式命名。

小組：如果系統未自動填入這個欄位，請將小組設為「無」。
機構名稱：貴機構的名稱或您自己的名稱。
軟體包 ID：系統會根據產品名稱和機構 ID 自動產生這個值。
語言：Swift
選取儲存專案的位置，然後點選「建立」。
Xcode 會在工作區視窗中開啟您的新專案。

3. 建立及設定 Firebase 專案

如要開始使用 Firebase，請建立並設定 Firebase 專案。

建立 Firebase 專案

如果現有的 Firebase 專案尚未啟用 Google Analytics，您可以在「設定」的「整合」分頁中啟用 Google Analytics >專案設定。請前往 Firebase 設定步驟。

登入 Firebase。

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

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

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

4. Firebase 設定

在 Firebase 控制台中，依序選取「專案總覽」>「專案總覽」>「然後點選左側導覽列中的「專案設定」，然後點選「一般」>「設定」中的 iOS 按鈕你的應用程式

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

提供的重要值是 iOS 軟體包 ID，後續步驟將有這個 ID。
在 iOS 應用程式的 Xcode 專案中，從專案導覽器中選取頂層應用程式，然後選取 [General] (一般) 分頁。
「軟體包 ID」欄位的值是 iOS 軟體包 ID (格式為 com.yourcompany.yourproject)。複製這個值。
在 Firebase 對話方塊中，將複製的軟體包 ID 貼到 iOS bundle ID 欄位中。
按一下「Register App」。
繼續在 Firebase 中操作，請按照操作說明下載設定檔 GoogleService-Info.plist

前往您的 Xcode 專案，將 GoogleService-Info.plist 檔案 (剛下載) 移至 Xcode 專案的根目錄。
請略過其餘步驟，返回 Firebase 控制台主頁面。

5. 在 Xcode 中設定 Firebase Analytics

在這個步驟中，您要開始將 Firebase SDK 加進 Xcode 專案。

開啟終端機視窗，然後瀏覽到應用程式的 Xcode 專案位置。
如果您沒有 Podfile，請建立這個檔案：

$ pod init

開啟 Podfile 並新增：

$ vi Podfile

$ pod 'Firebase/Analytics'

儲存檔案並執行：

$ pod install

新增初始化程式碼：

如要在應用程式啟動時連接 Firebase，請將下方的初始化程式碼加入主要的 AppDelegate 類別。

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

這樣就完成了！前往控制台。

您現在可以開始啟用一些自訂事件記錄了！

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

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

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

記錄事件

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

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

設定預設事件參數

您可以使用 setDefaultEventParameters 記錄跨事件的參數。預設參數會與記錄的所有未來事件建立關聯。

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

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

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

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

在 Xcode 中，選取 [Product] (產品) > 配置 >編輯配置...
選取左選單中的「執行」。
選取「Arguments」分頁標籤。
在「傳遞時傳遞的引數」部分，新增 -FIRAnalyticsDebugEnabled。

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

在資訊主頁中查看事件

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

您將標記「text_search」將「標示為轉換」就會切換至右側。

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

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

Firebase-iOS 設定已完成，你可以開始推出含有所記錄動作事件的應用程式廣告活動。請先將 Firebase 連結至 Google Ads，將 Firebase 連結至 Google Ads 後，應用程式廣告活動就能進一步瞭解目標對象，並提升應用程式廣告活動學習成效，通常有助於提升成效與轉換率。