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。

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

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

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

3. 建立及設定 Firebase 專案

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

建立 Firebase 專案

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

  1. 登入 Firebase

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

9b0ae97cc3c6f1d0.png

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

e58151a081f0628.png

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

4. Firebase 設定

  1. 在 Firebase 控制台中,依序選取左側導覽面板中的「專案總覽」>「專案設定」,然後點選「一般」>「您的應用程式」下方的 iOS 按鈕

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

425bb1c07921e71d.png

  1. 您必須提供的必要值是 iOS 套件 ID,可在下一個步驟中取得。
  2. 在 iOS 應用程式的 Xcode 專案中,選取專案導覽器中的頂層應用程式,然後選取「General」分頁。
  3. 「Bundle Identifier」欄位的值是 iOS 軟體包 ID (類似 com.yourcompany.yourproject)。請複製這個值。
  4. 在 Firebase 對話方塊中,將複製的套件 ID 貼到 iOS bundle ID 欄位。
  5. 按一下「註冊應用程式」
  6. 繼續在 Firebase 中操作,請按照操作說明下載設定檔 GoogleService-Info.plist

26e5b98711c2787a.png

  1. 前往您的 Xcode 專案,將 GoogleService-Info.plist 檔案 (剛下載) 移至 Xcode 專案的根目錄。
  2. 跳過剩餘步驟,返回 Firebase 主控台的主頁面。

5. 在 Xcode 中設定 Firebase Analytics

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

  1. 開啟終端機視窗,然後前往應用程式的 Xcode 專案位置。
  2. 如果您沒有 Podfile,請建立這個檔案:

$ pod init

  1. 開啟 Podfile 並新增:

$ vi Podfile

$ pod 'Firebase/Analytics' 54204c9ce2a49666.png

  1. 儲存檔案並執行 :

$ pod install

  1. 新增初始化程式碼:

如要在應用程式啟動時連接 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
  }
}
  1. 太好了!前往控制台。

您現在可以觸發一些自訂事件記錄檔了!

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 記錄的事件,以便確認事件是否已正確記錄。這包括自動和手動記錄的事件。

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

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

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

在資訊主頁中查看事件

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

286b640ed4646163.png

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

a933a338990cba3a.png

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

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

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

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

b711bf2e94fa0895.png

  1. 選擇 Google Ads 帳戶。

Firebase 就完成了。

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

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

73cec8d2e80eab03.png

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

4b1d8f6a712b2ac6.png

  1. 您可以查看所有標示為轉換的數據分析事件。找出先前導入的 clicked_counter 事件。

ba1bbe6b2924fac8.png 2b9abde9fb95d188.png

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

ab35e341dff32e48.png

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

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

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

af98c44d1476558.png

  1. 提供應用程式名稱、套件名稱或發布商,即可找到應用程式。
  2. 在「出價」部分中,選取「應用程式內動作」下拉式選單中的「廣告」以著重於動作。
  3. 您可以在提供的清單中查看自訂事件設定單次動作出價,然後填入其他選項。

a1f145794f949109.png 3dc838d7f4eeeba5.png

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

9. 恭喜

恭喜,您已成功整合 Firebase 和 Google Ads!有助於提升廣告活動成效。

您已安裝指令碼、建立並暫存新的程式碼研究室變更清單、更新及暫存待處理的程式碼研究室變更清單、審查並核准程式碼研究室變更清單,以及提交和發布程式碼研究室變更清單。

您已學習

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