Google Analytics(分析)使用入门

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

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

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

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

准备工作

  1. 将 Firebase 添加到您的 iOS 项目(如果尚未添加),并确保在 Firebase 项目中启用了 Google Analytics(分析)。

    • 如果您要创建新的 Firebase 项目,请在项目创建工作流期间启用 Google Analytics(分析)。

    • 如果您已有 Firebase 项目,但未启用 Google Analytics(分析),则可以从 >“项目设置”集成标签页中启用 Google Analytics(分析)。

    在项目中启用 Google Analytics(分析)后,您的 Firebase 应用将关联到 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];


(可选)停用 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 调试功能:

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

后续步骤