开始使用 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
  4. 选择 Analytics 库。
  5. 为了获得最佳的 Analytics 使用体验,我们建议您在 Firebase 项目中启用 Google Analytics(分析),并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择不收集 IDFA 的库,也可以选择收集 IDFA 的库。
  6. 完成之后,Xcode 将会自动开始在后台解析和下载您的依赖项。

如需详细了解 IDFA(设备级广告标识符),请参阅 Apple 的用户隐私和数据使用以及应用跟踪透明度文档。

接下来,执行一些配置步骤:

  1. UIApplicationDelegate 中导入 FirebaseCore 模块,以及您的应用委托 (app delegate) 使用的所有其他 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,则必须创建应用委托并通过 UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor 将其附加到 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 会使用 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",
])

Objective-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. 从左侧菜单中选择 Run
  3. 选择 Arguments 标签页。
  4. Arguments Passed On Launch 部分,添加 -FIRAnalyticsDebugEnabled

后续步骤