開始使用 Google Analytics (分析)

本快速入門導覽課程說明如何將 Google Analytics (分析) 新增至您的應用程式，並開始記錄事件。

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

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

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

事前準備

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

    • 如要建立新的 Firebase 專案，請在專案建立工作流程中啟用 Google Analytics (分析)。

    • 如果您使用的是現有的 Firebase 專案，但尚未啟用 Google Analytics (分析)，請依序前往 >「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 (裝置層級廣告 ID)，請參閱 Apple 的「使用者隱私權和資料使用方式」和「應用程式追蹤透明度」說明文件。

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

  1. 將 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;
// ...
  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 結構體。您也必須停用應用程式委派功能切換功能。詳情請參閱 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

注意：這項 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. 在「Passed on Launch」區段中，新增 -FIRAnalyticsDebugEnabled。

後續步驟