本快速入門導覽課程說明如何將 Google Analytics 新增至應用程式, 開始記錄事件。
「Google Analytics」會收集應用程式的使用情況和行為資料。SDK 會記錄兩種主要類型的資訊:
- 事件:應用程式運作情況,例如使用者動作、系統 事件或錯誤
- 使用者屬性:您定義的屬性,用來描述區隔 例如語言偏好設定或地理位置
Analytics 會自動記錄部分活動記錄 事件和 使用者屬性; 不需要新增任何程式碼
事前準備
如果您尚未將 Firebase 新增至 Apple 專案,請先完成這項操作。 並確認 Firebase 已啟用 Google Analytics 專案:
如要建立新的 Firebase 專案,請啟用「Google Analytics」 專案建立流程
如果您使用的現有 Firebase 專案沒有 Google Analytics已啟用,請前往 整合項目 (
即可啟用)。 > 的分頁) (前往專案設定
在專案中啟用 Google Analytics 後,Firebase 應用程式 已連結至 Google Analytics 個資料串流。
(建議選項)。在 AdSupport 架構中加入 專案來啟用其他功能 例如目標對象和廣告活動歸因
在應用程式中新增 Analytics SDK
使用 Swift Package Manager 安裝及管理 Firebase 依附元件。
- 在 Xcode 中保持開啟應用程式專案,然後前往「檔案」檔案 >新增套件。
- 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:
- 選擇 Analytics 程式庫。
- 在目標建構設定的「Other Linker Flags」部分中新增
-ObjC
標記。 - 為透過 Analytics 獲得最佳體驗,建議你 正在啟用 Google Analytics ,然後將 Google Analytics 專用 Firebase SDK 加進應用程式。你可以 選取沒有收集廣告識別碼 (IDFA) 或收集廣告識別碼的程式庫。
- 完成後,Xcode 會自動開始解析並下載 複製到背景依附元件
https://github.com/firebase/firebase-ios-sdk.git
進一步瞭解 IDFA (裝置層級廣告 ID)。請前往 Apple 的 使用者隱私權和資料使用方式 和 應用程式追蹤資訊公開 說明文件。
接下來,請執行一些設定步驟:
- 將
FirebaseCore
模組匯入至UIApplicationDelegate
和任何其他 應用程式委派所用的 Firebase 模組。 例如,如要使用 Cloud Firestore 和 Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 設定
FirebaseApp
敬上 共用執行個體application(_:didFinishLaunchingWithOptions:)
方法: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
或App
NSApplicationDelegateAdaptor
。您也必須停用應用程式委派功能切換功能。適用對象 詳情請參閱 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。
如要停用這項功能,請將
將 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
到 NO
(布林值) 英寸
應用程式的 info.plist 檔案。
開始記錄事件
設定 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] (產品) > 配置 >編輯配置...
- 選取左選單中的「執行」。
- 選取「Arguments」分頁標籤。
- 在「傳遞時通過的引數」部分,新增
-FIRAnalyticsDebugEnabled
。
後續步驟
- 解讀每份 Analytics 報表。
- 使用 DebugView 驗證事件。
- 在 Firebase 控制台探索您的資料。
- 瀏覽活動指南,和 使用者屬性。
- 瞭解如何將資料匯出至 BigQuery。