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

记录事件

本指南向您展示如何在您的应用程序中记录事件。

事件可以让您深入了解您的应用中正在发生的事情,例如用户操作、系统事件或错误。

Analytics 会自动为您记录一些事件;您无需添加任何代码即可接收它们。如果您的应用需要收集额外数据,您可以在您的应用中记录多达 500 种不同的分析事件类型。您的应用记录的事件总量没有限制。请注意,事件名称区分大小写,记录两个名称仅大小写不同的事件将导致两个不同的事件。

在你开始之前

确保您已设置项目并且可以访问 Analytics,如开始使用 Analytics中所述。

记录事件

配置firebase.analytics()实例后,您可以开始使用logEvent()方法记录事件。如果您已经熟悉 Google Analytics,则此方法相当于使用gtag.js中的event命令。

为帮助您入门,Analytics SDK 定义了一些推荐事件,这些事件在不同类型的应用程序中很常见,包括零售和电子商务、旅游和游戏应用程序。要了解有关这些事件以及何时使用它们的更多信息,请参阅推荐事件

注意:要在报告中获得最详细的信息,请记录对您的应用及其规定参数有意义的推荐事件。这也可确保您在最新的 Google Analytics(分析)功能可用时受益。

您可以在gtag.js 事件参考中找到多个事件及其参数的实现细节。

以下示例演示了如何记录select_content事件:

Web version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});

Web version 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

除了规定的参数外,您还可以将以下参数添加到任何事件中:

  • 自定义参数:自定义参数可用作Analytics 报告中的维度或指标。您可以为非数字事件参数数据使用自定义维度,为更好地以数字表示的任何参数数据使用自定义指标。使用 SDK 记录自定义参数后,注册维度或指标以确保这些自定义参数显示在 Analytics 报告中。通过以下方式执行此操作: Analytics > Events > Manage Custom Definitions > Create Custom Dimensions

    自定义参数可用于可应用于每个报告的受众定义。如果您的应用链接到 BigQuery 项目,则自定义参数也包含在导出到 BigQuery 的数据中。在Google Analytics 4 BigQuery Export中查找示例查询和更多内容。

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

如果您的应用程序具有推荐事件类型未涵盖的特定需求,您可以记录自己的自定义事件。例如,如果您正在开发游戏并希望跟踪玩家何时完成特定目标,您可以记录类似于以下示例的事件:

Web version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web version 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

在仪表板中查看事件

您可以在 Firebase 控制台仪表板中查看有关事件的汇总统计信息。这些仪表板全天定期更新。对于即时测试,请使用上一节中所述的 logcat 输出。

您可以从 Firebase 控制台的事件仪表板访问此数据。此仪表板显示为您的应用程序记录的每种不同类型的事件自动创建的事件报告。