记录事件

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

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 事件自动创建的。详细了解信息中心