本快速入門導覽課程說明如何將 Google Analytics (分析) 新增至您的應用程式,並開始記錄事件。
Google Analytics (分析) 會收集應用程式的使用情況和行為資料。SDK 會記錄兩種主要類型的資訊:
- 事件:應用程式的實際情況,例如使用者動作、系統事件或錯誤。
- 使用者屬性:您定義用來描述使用者區隔的屬性,例如語言偏好設定或地理位置。
Analytics (分析) 會自動記錄部分事件和使用者屬性,您不需要新增任何程式碼即可啟用這些事件。
事前準備
如果您尚未將 Firebase 新增至 Apple 專案,請確認已在 Firebase 專案啟用 Google Analytics (分析):
如要建立新的 Firebase 專案,請在專案建立工作流程中啟用 Google Analytics (分析)。
如果您使用的是現有的 Firebase 專案,但尚未啟用 Google Analytics (分析),請依序前往
的「 >「Project settings」(專案設定)Integrations」(整合) 分頁來啟用專案。
啟用專案中的 Google Analytics (分析) 後,您的 Firebase 應用程式會連結至 Google Analytics (分析) 資料串流。
(建議選項)。將 AdSupport 架構新增至專案,啟用目標對象和廣告活動歸因等其他功能。
在應用程式中加入 Analytics (分析) SDK
使用 Swift Package Manager 安裝及管理 Firebase 依附元件。
- 在 Xcode 中保持開啟應用程式專案,然後依序點選「File」>「Add Packages」。
- 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:
- 選擇 Analytics (分析) 資料庫。
- 在目標建構設定的「Other Linker Flags」部分中新增
-ObjC
標記。 - 為了獲得最佳 Analytics (分析) 體驗,建議您在 Firebase 專案中啟用 Google Analytics (分析),並將 Google Analytics (分析) 專用 Firebase SDK 新增至應用程式。您可以選取不使用 IDFA 收集功能的程式庫,或利用 IDFA 收集功能。
- 完成後,Xcode 會自動開始在背景解析並下載依附元件。
https://github.com/firebase/firebase-ios-sdk.git
如要進一步瞭解 IDFA (裝置層級廣告 ID),請參閱 Apple 的「使用者隱私權和資料使用方式」和「應用程式追蹤透明度」說明文件。
接下來,請執行一些設定步驟:
- 將
FirebaseCore
模組匯入UIApplicationDelegate
,以及應用程式委派使用的任何其他 Firebase 模組。例如,如要使用 Cloud Firestore 和驗證:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 在應用程式委派的
application(_:didFinishLaunchingWithOptions:)
方法中設定FirebaseApp
共用例項:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- 如果您使用 SwiftUI,則必須建立應用程式委派,並透過
UIApplicationDelegateAdaptor
或NSApplicationDelegateAdaptor
將其附加至App
結構體。您也必須停用應用程式委派功能切換功能。詳情請參閱 SwiftUI 操作說明。SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(選用) 停用 Apple 廣告聯播網歸因註冊功能
為了方便起見,SDK 會自動向 Apple 註冊您的應用程式,以便使用 SKAdNetwork 進行廣告聯播網歸因。如要停用這項功能,請在應用程式 info.plist 檔案中將 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
的值設為 NO
(布林值)。
開始記錄事件
設定 FirebaseApp
執行個體後,即可開始使用 logEvent()
方法記錄事件。
有些事件建議所有應用程式使用,有些則建議用於特定業務類型或產業。您應傳送建議事件及其相關的規定參數,以確保報表可提供最多的資料,以及使用日後推出的功能和整合服務。本節示範記錄預先定義的事件,如要進一步瞭解記錄事件,請參閱記錄事件一文。
以下範例說明如何記錄建議的事件,指出使用者已點選應用程式中的特定元素:
Swift
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
如要在 Xcode 偵錯主控台中查看這個事件,請啟用 Analytics (分析) 偵錯功能:
- 在 Xcode 中,選取「Product」>「Schee」>「Edit scheme...」
- 選取左選單中的「執行」。
- 選取「Arguments」分頁標籤。
- 在「Passed on Launch」區段中,新增
-FIRAnalyticsDebugEnabled
。
後續步驟
- 解讀每份 Analytics (分析) 報表。
- 使用 DebugView 驗證事件。
- 在 Firebase 控制台探索您的資料。
- 探索事件和使用者屬性的相關指南。
- 瞭解如何將資料匯出至 BigQuery。