开始使用 Google Analytics(分析)

本文介绍如何将应用配置为使用 Google Analytics(分析)。要将网站配置为使用 Google Analytics(分析),请参阅为网站和/或应用设置 Google Analytics(分析)

准备工作

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

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

  • 如果您使用的是未启用 Analytics(分析)的现有 Firebase 项目,请转到设置的"集成"标签页 >"项目设置"即可启用。

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

(推荐)将 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 将会自动开始在后台解析和下载您的依赖项。
  7. 完成之后,Xcode 将会自动开始在后台解析和下载您的依赖项。

如需详细了解 IDFA(设备级广告标识符),请参阅 Apple 的用户隐私和数据使用以及应用跟踪透明度文档。

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

  1. UIApplicationDelegate 中导入 Firebase 模块:

    Swift

    import FirebaseCore
    import FirebaseAnalytics
            

    Objective-C

    @import FirebaseCore;
    @import FirebaseAnalytics;
            
  2. 配置一个 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(布尔值)。

后续步骤