记录事件

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

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

准备工作

使用 Google Analytics（分析）之前，您需要：

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

    • 如果您的 Unity 项目已在使用 Firebase，那么该项目已经注册并已配置为使用 Firebase。

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

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

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

记录事件

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

为帮助您着手使用，Analytics SDK 定义了许多常见于各类型应用（零售、电子商务、旅行以及游戏应用等）的推荐事件。如需详细了解这些事件及其适用情形，请参阅 Google Analytics（分析）帮助中心内的推荐事件文章。

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

  • 推荐事件：请查阅 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 事件自动创建的。详细了解信息中心。