Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

记录事件

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

Google Analytics(分析)会自动为您记录一些事件,您无需为了接收这些事件而添加任何代码。如果您的应用需要收集其他数据,您可以在应用中记录各种不同 Analytics 事件类型,最多可达 500 种。应用可记录的事件总量不受限制。请注意,事件名称区分大小写。即便两个事件的名称只是大小写不同,系统也会将其视作两个不同的事件。

准备工作

使用 Google Analytics(分析)之前,您需要:

  • 注册 Unity 项目并将其配置为使用 Firebase。

    • 如果您的 Unity 项目已在使用 Firebase,那么您就已注册该 Unity 项目并已将其配置为使用 Firebase。

    • 如果您没有 Unity 项目,则可以下载示例应用

  • Firebase Unity SDK(具体而言是 FirebaseAnalytics.unitypackage)添加到您的 Unity 项目中。

请注意,将 Firebase 添加到 Unity 项目需要在 Firebase 控制台中和打开的 Unity 项目中执行若干任务(例如,从控制台下载 Firebase 配置文件,然后将配置文件移动到 Unity 项目中)。

记录事件

初始化 Firebase.Analytics.FirebaseAnalytics 模块后,您可以使用该模块通过 LogEvent() 方法记录事件。

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

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

  • 推荐事件:请查阅 Event 常量列表。
  • 预设参数:请参阅 Parameters 常量列表。

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

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

除了预设参数外,您还可以将以下参数添加到任意事件中:

  • 自定义参数:自定义参数不会直接显示在您的 Analytics 报告中,但它们在可应用于每份报告的受众群体定义中可用作过滤条件。如果应用已与一个 BigQuery 项目相关联,则自定义参数也包含在导出至 BigQuery 的数据中。

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

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

在记录输出中查看事件

Android

您可以在 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 中显示您的事件,帮助您立即验证所发送的事件。

iOS

事件都记录在控制台中,并能在通过 XCode 运行应用期间查看。

在信息中心内查看 Analytics 事件

您可以在 Firebase 信息中心内查看有关您的 Analytics 事件的汇总统计信息。信息中心会每日定期更新。如需立即测试,请按照上一部分中述使用 logcat 输出进行。

要在 Firebase 控制台中访问此数据,请执行以下操作:

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

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