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

记录事件

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

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

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

在你开始之前

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

记录事件

创建FirebaseAnalytics实例后,您可以使用它通过logEvent()方法记录事件。

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

您可以在以下位置找到推荐事件类型的实施详细信息:

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

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

Kotlin+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

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

  • 自定义参数:自定义参数可用作Analytics 报告中的维度或指标。您可以将自定义维度用于非数字事件参数数据,并将自定义指标用于任何以数字方式更好地表示的参数数据。使用 SDK 记录自定义参数后,注册维度或指标以确保这些自定义参数出现在 Analytics 报告中。通过以下方式执行此操作:分析 > 事件 > 管理自定义定义 > 创建自定义维度

    自定义参数可用于可应用于每个报告的受众定义。如果您的应用与 BigQuery 项目相关联,则自定义参数也会包含在导出到 BigQuery的数据中。在Google Analytics 4 BigQuery Export中查找示例查询等。

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

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

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

设置默认事件参数

您可以使用setDefaultEventParameters跨事件记录参数。默认参数与记录的所有未来事件相关联。

与自定义参数一样,注册默认事件参数以确保它们出现在 Analytics 报告中。

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

如果在logEvent()方法中指定了参数,则使用该值而不是默认值。

要清除默认参数,请调用setDefaultEventParameters方法并将参数设置为null

在 Android Studio 调试日志中查看事件

您可以启用详细日志记录以监控 SDK 的事件日志记录,以帮助验证事件是否被正确记录。这包括自动和手动记录的事件。

您可以使用一系列 adb 命令启用详细日志记录:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

此命令在 Android Studio logcat 中显示您的事件,帮助您立即验证是否正在发送事件。

在仪表板中查看事件

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

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