開始使用 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 中保持開啟應用程式專案，然後前往「檔案」檔案 >新增套件。
  2. 在系統提示時，新增 Firebase Apple 平台 SDK 存放區：
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. 選擇 Analytics 資料庫。
  4. 在目標建構設定的「Other Linker Flags」部分中新增 -ObjC 標記。
  5. 為了獲得最佳的 Analytics 使用體驗，建議您 啟用 Google Analytics ，然後將 Google Analytics 專用 Firebase SDK 加進應用程式。你可以 選取沒有收集廣告識別碼 (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. 設定 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];
  3. 如果您使用 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

注意：這項 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] (產品) > 配置 >編輯配置...
  2. 選取左選單中的「執行」。
  3. 選取「Arguments」分頁標籤。
  4. 在「傳遞時通過的引數」部分，新增 -FIRAnalyticsDebugEnabled。

後續步驟