记录事件

事件可让您了解您的应用中发生了什么,例如用户操作、系统事件或错误。

Analytics 会自动为您记录一些事件,您无需为此添加任何代码。如果您的应用需要收集其他数据,您可以在其中记录最多 500 种不同的 Analytics 事件类型。应用可记录的事件总量不受限制。

开始之前

如果这是您首次向应用添加 Analytics,请完成以下步骤:

在 Firebase 控制台中关联您的应用

  1. 安装 Firebase SDK
  2. Firebase 控制台中,将您的应用添加到您的 Firebase 项目。

将 Analytics 添加到您的应用

  1. 将 Firebase 的依赖项添加到您的 Podfile 中:
    pod 'Firebase/Core'
  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];
    

记录事件

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

为帮助您着手,Analytics SDK 定义了许多推荐的事件,这些事件可通用于各种应用类型,包括零售和电子商务、旅行以及游戏应用。如需详细了解这些事件及其适用情形,请在 Firebase 帮助中心浏览事件和属性相关文章。

您可在以下位置找到详细的实现信息:

  • 推荐事件:请参阅 FIREventNames.h 标头文件。
  • 预设参数:请参阅 FIRParameterNames.h 标头文件。

下面的示例展示了如何记录推荐的 kFIRSelectContent 事件:

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"
                                 }];

除了预设参数外,您还可以将以下参数添加到任意事件中:

  • 自定义参数:您可以注册要在 Analytics 报告中报告的自定义参数。在可应用于每份报告的受众群体定义中,也可以使用这些自定义参数作为过滤条件。如果应用已关联至一个 BigQuery 项目,则自定义参数也包含在导出至 BigQuery 的数据中。

  • kFIRParameterValue 参数:kFIRParameterValue 是一个通用参数,可用于累积统计与事件相关的关键指标。关键指标的示例包括收入、距离、时间和分数。

如果您的应用具有推荐事件类型未涵盖的特定需求,则您可以按以下示例所示方式记录您自己的自定义事件:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Objective-C

 [FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

在 Xcode 调试控制台中查看事件

您可以启用详细的日志记录功能以监控 SDK 的事件记录情况,从而帮助验证是否已正确记录事件,包括自动和手动记录的事件。

您可以按如下方式启用详细的日志记录功能:

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

下次您运行应用时,就可以在 Xcode 调试控制台中看到事件信息,方便地即时验证是否正在发送事件。

在信息中心内查看事件

您可以在 Firebase 控制台信息中心内查看有关您的 Analytics 事件的汇总统计信息。这些信息中心会全天定期更新。要立即展开测试,可以按照上一部分的说明使用调试控制台输出来进行。

您可以按如下方式在 Firebase 控制台中访问这些数据:

  1. Firebase 控制台中,打开您的项目。
  2. 从菜单中选择 Analytics 以查看 Analytics 报告信息中心。

事件标签会显示事件报告,这些报告是针对应用所记录的每种独特的 Analytics 事件自动生成的。要详细了解 Analytics 报告信息中心,请访问 Firebase 帮助中心。

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面