获取我们在 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 报告中。通过以下方式执行此操作:分析 > 事件 > 管理自定义定义 > 创建自定义维度

    自定义参数可用于可应用于每个报告的受众定义。如果您的应用与 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 控制台的事件信息中心访问这些数据。此仪表板显示为您的应用记录的每种不同类型的事件自动创建的事件报告。