本指南向您展示如何在您的应用程序中记录事件。
事件可以让您深入了解您的应用中正在发生的事情,例如用户操作、系统事件或错误。
Analytics 会自动为您记录一些事件;您无需添加任何代码即可接收它们。如果您的应用需要收集额外数据,您可以在您的应用中记录多达 500 种不同的分析事件类型。您的应用记录的事件总量没有限制。请注意,事件名称区分大小写,记录两个名称仅大小写不同的事件将导致两个不同的事件。
在你开始之前
确保您已设置项目并且可以访问 Analytics,如开始使用 Analytics中所述。
记录事件
创建FirebaseAnalytics
实例后,您可以使用它通过logEvent()
方法记录事件。
为帮助您入门,Analytics SDK 定义了一些推荐事件,这些事件在不同类型的应用程序中很常见,包括零售和电子商务、旅游和游戏应用程序。要了解有关这些事件以及何时使用它们的更多信息,请参阅推荐事件。
您可以在以下位置找到推荐事件类型的实施细节:
- 推荐事件:请参阅
com.google.firebase.analytics.FirebaseAnalytics.Event
类参考。 - 规定参数:参见
com.google.firebase.analytics.FirebaseAnalytics.Param
参考。
以下示例演示如何记录SELECT_CONTENT
事件:
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") }
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);
除了规定的参数外,您还可以将以下参数添加到任何事件中:
自定义参数:自定义参数可用作Analytics 报告中的维度或指标。您可以为非数字事件参数数据使用自定义维度,为更好地以数字表示的任何参数数据使用自定义指标。使用 SDK 记录自定义参数后,注册维度或指标以确保这些自定义参数显示在 Analytics 报告中。通过以下方式执行此操作: Analytics > Events > Manage Custom Definitions > Create Custom Dimensions
自定义参数可用于可应用于每个报告的受众定义。如果您的应用链接到 BigQuery 项目,则自定义参数也包含在导出到 BigQuery的数据中。在Google Analytics 4 BigQuery Export中查找示例查询和更多内容。
VALUE
参数:VALUE
是一个通用参数,可用于累积与事件相关的关键指标。示例包括收入、距离、时间和积分。
如果您的应用程序具有推荐事件类型未涵盖的特定需求,您可以记录自己的自定义事件,如本例所示:
Kotlin+KTX
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
设置默认事件参数
您可以使用setDefaultEventParameters
跨事件记录参数。默认参数与记录的所有未来事件相关联。
与自定义参数一样,注册默认事件参数以确保它们出现在 Analytics 报告中。
Kotlin+KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.putInt("level_difficulty", 4); mFirebaseAnalytics.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 控制台的事件仪表板访问此数据。此仪表板显示为您的应用程序记录的每种不同类型的事件自动创建的事件报告。