開始使用 Google Analytics (分析)

本快速入門向您展示如何將 Google Analytics 新增至您的應用程式並開始記錄事件。

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

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

分析自動記錄一些事件使用者屬性;您不需要添加任何程式碼來啟用它們。

在你開始之前

  1. 如果您尚未將 Firebase 新增至您的 Apple 項目,並確保在您的 Firebase 專案中啟用了 Google Analytics(分析):

    • 如果您要建立新的 Firebase 項目,請在專案建立工作流程期間啟用 Google Analytics。

    • 如果您使用的現有 Firebase 專案未啟用 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.git
  4. 選擇分析庫。
  5. -ObjC標誌新增至目標建置設定的「其他連結器標誌」部分。
  6. 為了獲得 Analytics 的最佳體驗,我們建議在您的 Firebase 專案中啟用 Google Analytics ,並將適用於 Google Analytics 的 Firebase SDK 新增至您的應用程式。您可以選擇沒有 IDFA 收集或有 IDFA 收集的庫。
  7. 完成後,Xcode 將自動開始在背景解析並下載您的依賴項。

在 Apple 的使用者隱私和資料使用以及應用程式追蹤透明度文件中了解有關裝置層級廣告識別碼 IDFA 的更多資訊。

接下來,執行一些設定步驟:

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

    斯威夫特使用者介面

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

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-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()

    Objective-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",
])

Objective-C

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

若要在 Xcode 偵錯控制台中查看此事件,請啟用 Analytics 偵錯:

  1. 在 Xcode 中,選擇“產品”>“方案”>“編輯方案...”
  2. 從左側選單中選擇運行
  3. 選擇參數選項卡。
  4. 「啟動時傳遞的參數」部分中,新增-FIRAnalyticsDebugEnabled

下一步