本頁面由 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。

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

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，可在下一個步驟中取得。
在 iOS 應用程式的 Xcode 專案中，選取專案導覽器中的頂層應用程式，然後選取「General」分頁。
「Bundle Identifier」欄位的值是 iOS 軟體包 ID (類似 com.yourcompany.yourproject)。請複製這個值。
在 Firebase 對話方塊中，將複製的套件 ID 貼到 iOS bundle ID 欄位。
按一下「註冊應用程式」。
繼續在 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」>「Schee」>「Edit scheme...」
選取左選單中的「執行」。
選取「Arguments」分頁標籤。
在「傳遞時傳遞的引數」部分，新增 -FIRAnalyticsDebugEnabled。

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

在資訊主頁中查看事件

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

只要將「標示為轉換」切換按鈕向右滑，即可將「text_search」標示為轉換。

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

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

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