Google Analytics(分析)使用入门

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

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

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

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

准备工作

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

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

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

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

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

将 Analytics SDK 添加到您的应用

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

  1. 在 Xcode 中打开您的应用项目,依次转到 File(文件)> Add Packages(添加软件包)
  2. 出现提示时,添加 Firebase Apple 平台 SDK 代码库:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. 选择 Analytics 库。
  5. 为了获得最佳的 Analytics 使用体验,我们建议您在 Firebase 项目中启用 Google Analytics(分析),并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择不包含 IDFA 集合的库,也可以选择包含 IDFA 集合的库。
  6. 完成之后,Xcode 将会自动开始在后台解析和下载您的依赖项。

如需详细了解 IDFA(设备级广告标识符),请参阅 Apple 的用户隐私和数据使用App Tracking Transparency 文档。

接下来,执行一些配置步骤:

  1. UIApplicationDelegate 中导入 FirebaseCore 模块,以及您的应用委托使用的所有其他 Firebase 模块。 例如,如需使用 Cloud Firestore 和 Authentication,请执行以下操作:

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 配置一个 FirebaseApp 共享实例(通常在 App 的初始化程序或应用委托的 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

注意:此 Firebase 产品不适用于 macOS 目标平台。
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

注意:此 Firebase 产品不适用于 macOS 目标平台。
[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

后续步骤