Google Analytics（分析）使用入门

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

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

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

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

准备工作

将 Firebase 添加到您的 iOS 项目（如果尚未添加），并确保在 Firebase 项目中启用了 Google Analytics（分析）。
- 如果您要创建新的 Firebase 项目，请在项目创建工作流内启用 Google Analytics（分析）。
- 如果您使用的是现有 Firebase 项目，而该项目未启用 Google Analytics（分析），请转到 >“项目设置”，然后访问集成标签页启用该服务。
注意：您可以依次点击 >“项目设置”并访问集成标签页，将 2019 年 7 月 31 日之前创建的 Firebase 项目免费升级，以享受完整的 Google Analytics（分析）体验。此升级不是强制要求的，但建议执行。

在项目中启用 Google Analytics（分析）后，您的 Firebase 应用将关联到 Google Analytics（分析）数据流。
（推荐）将 AdSupport 框架添加到您的项目，以启用受众群体和广告系列归因等其他功能。

将 Analytics SDK 添加到您的应用

将 Firebase 的依赖项添加到您的 Podfile 中：
```
pod 'Firebase/Analytics'
```
运行 pod install 并打开创建的 .xcworkspace 文件。
在 UIApplicationDelegate 中导入 Firebase 模块：
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
配置一个 FirebaseApp 共享实例（通常在应用的 application:didFinishLaunchingWithOptions: 方法中配置）：
Swift
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```

（可选）停用 Apple 广告联盟归因注册

为方便起见，该 SDK 会使用 SKAdNetwork 自动向 Apple 注册您的应用，以进行广告联盟归因。如果您想停用此功能，请在应用的 info.plist 文件中将 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED 的值设为 NO（布尔值）。

开始记录事件

配置 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 调试功能：

在 Xcode 中，依次选择 Product > Scheme > Edit scheme...。
从左侧菜单中选择 Run。
选择 Arguments 标签页。
在 Arguments Passed On Launch 部分中，添加 -FIRAnalyticsDebugEnabled。

后续步骤

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