Catch up on highlights from Firebase at Google I/O 2023. Learn more

開始使用 Google Analytics (分析)

本快速入門向您展示如何將 Google Analytics 添加到您的應用程序並開始記錄事件。

Google Analytics 收集您應用程序的使用情況和行為數據。 SDK 記錄兩種主要類型的信息:

  • 事件:您的應用程序中發生的事情,例如用戶操作、系統事件或錯誤。
  • 用戶屬性:您定義的用於描述用戶群細分的屬性,例如語言偏好或地理位置。

Analytics 自動記錄一些事件用戶屬性;您無需添加任何代碼即可啟用它們。

在你開始之前

  1. 如果您還沒有,請將 Firebase 添加到您的 Apple 項目並確保在您的 Firebase 項目中啟用了 Google Analytics:

    • 如果您要創建新的 Firebase 項目,請在項目創建工作流程中啟用 Google Analytics。

    • 如果您使用的是未啟用 Google Analytics 的現有 Firebase 項目,請轉到“集成”選項卡 >項目設置以啟用它。

    當您在項目中啟用 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
  4. 選擇分析庫。
  5. 為了獲得最佳的 Analytics 體驗,我們建議在您的 Firebase 項目中啟用 Google Analytics ,並將適用於 Google Analytics 的 Firebase SDK 添加到您的應用中。您可以選擇沒有 IDFA 集合或有 IDFA 集合的庫。
  6. 完成後,Xcode 將自動開始在後台解析和下載您的依賴項。

在 Apple 的用戶隱私和數據使用以及App Tracking Transparency文檔中了解有關設備級廣告標識符 IDFA 的更多信息。

接下來,執行一些配置步驟:

  1. 在您的UIApplicationDelegate中導入FirebaseCore模塊,以及您的應用委託使用的任何其他Firebase 模塊。例如,要使用 Cloud Firestore 和身份驗證:

    斯威夫特用戶界面

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    目標-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 在您的應用委託的application(_:didFinishLaunchingWithOptions:)方法中配置一個FirebaseApp共享實例:

    斯威夫特用戶界面

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    迅速

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    目標-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 如果您使用的是 SwiftUI,則必須創建一個應用程序委託並通過UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor將其附加到您的App結構。您還必須禁用應用委託調配。有關詳細信息,請參閱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()方法記錄事件。

某些事件被推薦用於所有應用程序;其他建議用於特定的業務類型或垂直行業。您應該發送建議的事件及其規定的參數,以確保報告中提供盡可能多的可用詳細信息,並在未來可用的功能和集成中受益。本節演示記錄預定義事件,有關記錄事件的更多信息,請參閱記錄事件

以下示例演示瞭如何記錄推薦事件以指示用戶單擊了您應用中的特定元素:

迅速

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

目標-C

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

要在 Xcode 調試控制台中查看此事件,請啟用 Analytics 調試:

  1. 在 Xcode 中,選擇Product > Scheme > Edit scheme...
  2. 從左側菜單中選擇運行
  3. 選擇參數選項卡。
  4. 啟動時傳遞的參數部分中,添加-FIRAnalyticsDebugEnabled

下一步