開始使用 Google Analytics


本快速入門導覽課程說明如何在應用程式中加入 Google Analytics，並開始記錄事件。

Google Analytics 會收集應用程式的使用和行為資料。SDK 會記錄兩種主要類型的資訊：

  • 事件：應用程式中的活動，例如使用者動作、系統事件或錯誤。
  • 使用者屬性：您定義的屬性，用來描述使用者族群區隔，例如語言偏好或地理位置。

Analytics 會自動記錄部分事件和使用者屬性，您不需要新增任何程式碼即可啟用這些屬性。

事前準備

  1. 如果您尚未將 Firebase 新增至 Apple 專案，請確認已在 Firebase 專案中啟用 Google Analytics：

    • 如果您要建立新的 Firebase 專案，請在專案建立工作流程中啟用 Google Analytics。

    • 如果您使用的是未啟用 Google Analytics 的現有 Firebase 專案，請依序前往 >「Project settings」的「Integrations」(整合) 分頁來啟用專案。

    在專案中啟用 Google Analytics 後，您的 Firebase 應用程式就會連結至 Google Analytics 資料串流。

  2. (建議選項)。將 AdSupport 架構加入專案，即可啟用目標對象和廣告活動歸因等其他功能。

在應用程式中加入 Analytics SDK

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

  1. 在 Xcode 中保持開啟應用程式專案，然後依序點選「File」>「Add Packages」。
  2. 系統顯示提示訊息時，請新增 Firebase Apple 平台 SDK 存放區：
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. 選擇 Analytics 程式庫。
  4. 在目標建構設定的「Other Linker Flags」部分中新增 -ObjC 標記。
  5. 為提供最佳的 Analytics 體驗，建議您在 Firebase 專案中啟用 Google Analytics，並將 Google Analytics 專用 Firebase SDK 新增至應用程式。您可以選擇不收集 IDFA 的程式庫，也可以選擇收集 IDFA 的程式庫。
  6. 完成後，Xcode 會自動開始在背景解析並下載依附元件。

如要進一步瞭解裝置層級廣告識別碼 (IDFA)，請參閱 Apple 的使用者隱私權和資料使用和應用程式追蹤資訊公開說明文件。

接下來，請執行一些設定步驟：

  1. 在 UIApplicationDelegate 中匯入 FirebaseCore 模組，以及應用程式委派程式使用的任何其他 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;
// ...
  2. 在應用程式委派作業的 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];
  3. 如果您使用 SwiftUI，則必須建立應用程式委派，並透過 UIApplicationDelegateAdaptor 或 NSApplicationDelegateAdaptor 將其附加至 App 結構體。您也必須停用應用程式委派程式 swizzling。詳情請參閱 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 會自動註冊您的應用程式，以便透過 SKAdNetwork 向 Apple 註冊廣告聯播網歸因資料。如要停用這項功能，請在應用程式的 info.plist 檔案中，將 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED 的值設為 NO (布林值)。

開始記錄事件

設定 FirebaseApp 例項後，您就可以開始使用 logEvent() 方法記錄事件。

有些事件適用於所有應用程式，有些則適用於特定業務類型或產業。建議您傳送包含規定參數的建議事件，這樣報表就能呈現最詳盡的資料，也方便您日後使用新推出的功能和整合服務。本節將示範如何記錄預先定義的事件。如要進一步瞭解記錄事件，請參閱「記錄事件」。

以下範例說明如何記錄建議的事件，指出使用者已點選應用程式中的特定元素：

Swift

注意：這項 Firebase 產品不適用於 macOS 目標。
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

注意：這項 Firebase 產品不適用於 macOS 目標。
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

如要在 Xcode 偵錯主控台中查看這項事件，請啟用 Analytics 偵錯功能：

  1. 在 Xcode 中，選取「Product」>「Schee」>「Edit scheme...」
  2. 在左選單中選取「執行」。
  3. 選取「Arguments」分頁標籤。
  4. 在「Arguments Passed On Launch」部分中，新增 -FIRAnalyticsDebugEnabled。

後續步驟