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 後,應用程式廣告活動就能進一步瞭解目標對象,並提升應用程式廣告活動學習成效,通常有助於提升成效和轉換率。
- 點選「專案總覽」旁邊的按鈕,前往 Firebase 設定。
- 「整合」分頁中會顯示「Google Ads」和「連結」按鈕。按一下「連結並繼續」。
- 選擇 Google Ads 帳戶。
Firebase 就完成了。
現在,請前往 Google Ads 並登入。
- 前往 Google Ads 並登入,然後依序前往「工具與設定」→「評估」→「轉換」,即可匯入自訂事件做為轉換。
- 按一下「+」按鈕,新增轉換動作。
- 選擇「Google Analytics 4 資源 (Firebase)」,然後點選「繼續」。
- 您可以查看所有標示為轉換的數據分析事件。找出先前導入的
clicked_counter
事件。
- 勾選並按一下「匯入並繼續」按鈕。
將「text_search
」設為轉換動作後,接下來就是推出廣告活動,並指定可能會觸發 text_search
事件的使用者。
8. 使用匯入的事件推出應用程式行動廣告活動
- 前往目前帳戶的 [廣告活動] 分頁,然後按一下「+」按鈕開始放送新的廣告活動。按一下新廣告活動並繼續操作。
- 目前,我們將推出應用程式宣傳廣告活動,提供「應用程式安裝」選項。
- 提供應用程式名稱、套件名稱或發布商,即可找到應用程式。
- 在「出價」部分中,選取「應用程式內動作」下拉式選單中的「廣告」以著重於動作。
- 您可以在提供的清單中查看自訂事件設定單次動作出價,然後填入其他選項。
- 調整廣告活動設定。其內容不在程式碼研究室的介紹範圍內,請參考這些文件,或透過任何其他管道洽詢最佳化設定。
9. 恭喜
恭喜,您已成功整合 Firebase 和 Google Ads!有助於提升廣告活動成效。
您已安裝指令碼、建立並暫存新的程式碼研究室變更清單、更新及暫存待處理的程式碼研究室變更清單、審查並核准程式碼研究室變更清單,以及提交和發布程式碼研究室變更清單。
您已學習
- 如何設定 iOS 版 Firebase
- 如何使用 iOS 和 Firebase Analytics 記錄自訂事件
- 如何匯入事件並用於動作廣告活動。