转到控制台

记录事件

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

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

准备工作

使用 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[] {
      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 帮助中心。