获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

开始使用 Google 分析

本快速入门向您展示了如何将 Google Analytics 添加到您的应用程序并开始记录事件。

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

  • 事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
  • 用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。

Analytics 会自动记录一些事件用户属性;您无需添加任何代码即可启用它们。

在你开始之前

  1. 如果您还没有,请将 Firebase 添加到您的 Apple 项目中,并确保在您的 Firebase 项目中启用了 Google Analytics:

    • 如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。

    • 如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到 >项目设置集成选项卡以启用它。

    当您在项目中启用 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. 选择分析库。
  5. 为了获得最佳的 Analytics 体验,我们建议在您的 Firebase 项目中启用 Google Analytics ,并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择没有 IDFA 集合或有 IDFA 集合的库。
  6. 完成后,Xcode 将在后台自动开始解析和下载您的依赖项。

在 Apple 的用户隐私和数据使用以及App Tracking Transparency文档中了解有关 IDFA(设备级广告标识符)的更多信息。

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

  1. 在您的UIApplicationDelegate中导入FirebaseCore模块,以及您的应用委托使用的任何其他Firebase 模块。例如,要使用 Cloud Firestore 和身份验证:

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 在您的应用委托的application(_:didFinishLaunchingWithOptions:)方法中配置FirebaseApp共享实例:

    迅速

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];


(可选)禁用 Apple 广告网络归属注册

为方便起见,SDK 会自动向 Apple注册您的应用,以便使用SKAdNetwork进行广告网络归因。如果您希望禁用此功能,请在应用程序的 info.plist 文件中将GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED的值设置为NO (布尔值)。

开始记录事件

配置FirebaseApp实例后,您可以开始使用logEvent()方法记录事件。

建议所有应用程序使用某些事件;其他推荐用于特定的业务类型或垂直行业。您应该发送建议的事件及其规定的参数,以确保在您的报告中提供最大的可用详细信息,并从未来可用的功能和集成中受益。本节演示记录预定义事件,有关记录事件的更多信息,请参阅记录事件

以下示例演示了如何记录推荐事件以指示用户单击了应用程序中的特定元素:

迅速

注意:此 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. 从左侧菜单中选择运行
  3. 选择参数选项卡。
  4. 启动时传递的参数部分中,添加-FIRAnalyticsDebugEnabled

下一步