Google Analytics（分析）使用入门

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

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

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

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

准备工作

  1. 如果您要创建新项目，请将 Firebase 添加到您的 iOS 项目，并按照相应步骤操作，在项目创建期间为您的项目设置 Google Analytics（分析）。

    如果您已有项目，但未配置 Google Analytics（分析），则可以从 settings > 项目设置的集成标签页中将 Google Analytics（分析）与您的项目关联。

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

将 Analytics SDK 添加到您的应用

  1. 将 Firebase 的依赖项添加到您的 Podfile 中：
    pod 'Firebase/Analytics'
  2. 运行 pod install 并打开创建的 .xcworkspace 文件。
  3. 在 UIApplicationDelegate 中导入 Firebase 模块：

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  4. 配置一个 FirebaseApp 共享实例（通常在应用的 application:didFinishLaunchingWithOptions: 方法中配置）：

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];


开始记录事件

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

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

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

Swift

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

Objective-C

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

后续步骤