Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Google Analytics(分析)使用入门

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

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

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

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

准备工作

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

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

    • 如果您使用的是现有 Firebase 项目,而该项目未启用 Google Analytics(分析),请转到 >“项目设置”,然后访问集成标签页启用该服务。

    在项目中启用 Google Analytics(分析)后,您的 Firebase 应用将关联到 Google Analytics(分析)数据流。

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

将 Analytics SDK 添加到您的应用

  1. 将 Firebase 的依赖项添加到您的 Podfile 中:
    pod 'Firebase/Analytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
    
    如需详细了解 IDFA(设备级广告标识符),请参阅 Apple 的用户隐私和数据使用App Tracking Transparency 文档。
  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

后续步骤