Google Analytics（分析）使用入门

iOS+ Android Web Flutter

本快速入门介绍如何将 Google Analytics（分析）添加到您的应用并开始记录事件。

Google Analytics（分析）会收集您的应用的使用情况和行为数据。SDK 会记录两种主要类型的信息：

• 事件：您的应用中发生了什么，例如用户操作、系统事件或错误。
• 用户属性：您为描述自己的各个细分用户群而定义的特性，例如语言首选项或地理位置。

Analytics 会自动记录某些事件和用户属性；您无需为此添加任何代码。

准备工作

1. 将 Firebase 添加到您的 Apple 项目（如果尚未添加），并确保在 Firebase 项目中启用了 Google Analytics（分析）：

   • 如果您要创建新的 Firebase 项目，请在项目创建过程中启用 Google Analytics（分析）。

   • 如果您使用的是现有 Firebase 项目，而该项目未启用 Google Analytics（分析），请前往 settings >“项目设置”，然后在集成标签页中启用该服务。

   在项目中启用 Google Analytics（分析）后，您的 Firebase 应用将关联到 Google Analytics（分析）数据流。

2. （推荐）将 AdSupport 框架添加到您的项目，以启用受众群体和广告系列归因等其他功能。

将 Analytics SDK 添加到您的应用

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

1. 在 Xcode 中打开您的应用项目，依次点击 File（文件）> Add Packages（添加软件包）。
2. 出现提示时，添加 Firebase Apple 平台 SDK 代码库：

  https://github.com/firebase/firebase-ios-sdk

3. 选择 Analytics 库。
4. 为了获得最佳的 Analytics 使用体验，我们建议您在 Firebase 项目中启用 Google Analytics（分析），并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择收集或者不收集 IDFA 的库。
5. 完成之后，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 注册您的应用，以进行广告网络归因。如果您想停用此功能，请在应用的 info.plist 文件中将 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED 的值设为 NO（布尔值）。

开始记录事件

配置 FirebaseApp 实例后，您可以开始使用 logEvent() 方法记录事件。

某些事件推荐用于所有应用；其他事件则推荐用于特定业务类型或行业。您应该同时发送推荐事件及预设参数，以确保报告能够提供最详细的信息，并让您在未来功能和集成方案推出时马上就能受益。本部分展示了如何记录预定义的事件；如需详细了解如何记录事件，请参阅记录事件。

下面的示例展示了如何记录推荐的事件，以表明用户已点击应用中的某个特定元素：

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

[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。

后续步骤

• 使用 DebugView 验证事件。
• 在 Firebase 控制台中浏览数据。
• 浏览事件和用户属性的相关指南。
• 了解如何将数据导出到 BigQuery。