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.git
  3. 选择 Analytics 库。
  4. 将 -ObjC 标志添加到目标 build 设置的“其他链接器标志”部分。
  5. 为了获得最佳的 Analytics 使用体验，我们建议您在 Firebase 项目中启用 Google Analytics，并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择收集或者不收集 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，则必须创建应用委托并通过 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 会使用 SKAdNetwork 自动向 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（产品）> Scheme（方案）> Edit scheme…（修改方案…）。
  2. 从左侧菜单中选择 Run。
  3. 选择 Arguments 标签页。
  4. 在 Arguments Passed On Launch 部分，添加 -FIRAnalyticsDebugEnabled。

后续步骤