開始使用 Google Analytics


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

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

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

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

事前準備

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

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

    • 如果您使用的是現有的 Firebase 專案，但未啟用 Google Analytics，請前往 >「專案設定」 的「整合」分頁標籤 啟用。

    在專案中啟用 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. 將 -ObjC 標記新增至目標的建構設定「Other Linker Flags」部分。
  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」>「Scheme」>「Edit scheme...」
  2. 在左選單中選取「Run」。
  3. 選取「Arguments」分頁標籤。
  4. 在「Arguments Passed On Launch」部分中，新增 -FIRAnalyticsDebugEnabled。

後續步驟