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

1. 簡介

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

建構項目

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

透過本程式碼研究室，您可以體驗客戶面臨的整個應用程式業務流程。如要輕鬆入門 Firebase iOS，請先參閱 Firebase iOS 程式碼實驗室 (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」。
在對話方塊頂端選取「iOS」。
在「應用程式」部分選取「應用程式」，然後按一下「下一步」。
在隨即顯示的對話方塊中，使用下列值為應用程式命名，並為專案選擇其他選項，然後按一下「下一步」：
產品名稱：例如 ios-app

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

團隊：如果系統未自動填入這項資訊，請將團隊設為「無」。
機構名稱：貴機構的名稱或您的姓名。
套件組合 ID：系統會根據產品名稱和機構 ID 自動產生這個值。
語言：Swift
選取專案儲存位置，然後按一下「建立」。
Xcode 會在工作區視窗中開啟新專案。

3. 建立及設定 Firebase 專案

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

建立 Firebase 專案

如果您現有的 Firebase 專案未啟用 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」分頁。
「軟體包 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

在這個步驟中，您將開始在 Xcode 專案中新增 Firebase SDK。

開啟終端機視窗，然後前往應用程式的 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」>「Scheme」>「Edit scheme...」
在左選單中選取「Run」。
選取「Arguments」分頁標籤。
在「Arguments Passed On Launch」部分中，加入 -FIRAnalyticsDebugEnabled。

下次執行應用程式時，Xcode 偵錯控制台會顯示事件，方便您立即確認事件是否已傳送。

在資訊主頁中查看活動

您會在數小時後在 Firebase 控制台中看到記錄的事件。位置在「Analytics」→「事件」。您也可以點選事件，查看參數值。

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

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

7. 在 Google Ads 中匯入 Analytics 事件

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