记录事件

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

Analytics 会自动为您记录一些事件;您无需添加任何代码即可接收这些事件。如果您的应用需要收集其他数据,您可以在其中记录最多 500 种不同的 Analytics 事件类型。应用日志可记录的事件总量没有任何限制。请注意,事件名称区分大小写。若两个事件的名称只有大小写不同,系统会将其视作两个不同的事件。

开始之前

如果您尚未将 Analytics 添加到您的应用中,请在您的 Activity 中初始化 com.google.firebase.analytics.FirebaseAnalytics 对象:

private FirebaseAnalytics mFirebaseAnalytics;

// ...

// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

记录事件

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

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

您可在以下位置找到推荐事件类型的实现详情:

以下示例演示了如何记录推荐的 SELECT_CONTENT 事件:

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 报告中报告的自定义参数。这些自定义参数也可以在受众群体定义中用作过滤条件(可应用于每份报告)。如果应用已关联至一个 BigQuery 项目,则自定义参数也包含在导出至 BigQuery 的数据中。

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

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

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

在 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 控制台中访问此数据:

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

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

发送以下问题的反馈:

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