记录事件

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

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

开始之前

您必须先创建一个 Firebase 项目,并将 Firebase Unity SDK 软件包添加到您的 Unity 项目中,然后才能使用 Google Analytics for Firebase

设置:

前提条件

Android

  • Unity 5.0 或更高版本
  • Android NDK 版本 10d 或更高版本

iOS

  • Unity 5.0 或更高版本
  • Xcode 7.0 或更高版本

如果您还没有 Unity 项目,可以下载我们的某个快速入门示例,试用一下特定的 Firebase 功能。如果使用快速入门示例,请不要忘记从项目设置中获取软件包标识符,下一步中会用到该标识符。

在 Firebase 控制台中设置您的应用

要将 Firebase 添加到您的应用,您需要有一个 Firebase 项目以及适用于您的应用的 Firebase 配置文件。

如果您还没有 Firebase 项目,请在 Firebase 控制台中创建一个。如果您已经有与自己的移动应用相关联的现有 Google 项目,请点击导入 Google 项目。如果没有,请点击添加项目

Android

  1. 点击将 Firebase 添加到您的 Android 应用,然后按设置步骤操作。如果您是导入现有 Google 项目,系统可能会自动执行这些操作,您只需下载配置文件即可。
  2. 出现提示时,输入应用的软件包名称。请务必输入应用在使用的软件包名称;只有在将应用添加到 Firebase 项目时您才能进行此设置。
  3. 按照说明下载 google-services.json 文件。您随时可以再重新下载此文件
  4. 将此文件复制到项目的资源文件夹内的任意位置。

iOS

  1. 点击将 Firebase 添加到您的 iOS 应用,然后按设置步骤操作。如果您是导入现有 Google 项目,系统可能会自动执行这些操作,您只需下载配置文件即可。
  2. 出现提示时,输入应用的软件包 ID。请务必输入应用在使用的软件包 ID;只有在将应用添加到 Firebase 项目时您才能进行此设置。
  3. 按照说明下载 GoogleService-Info.plist 文件。您随时可以再重新下载此文件
  4. GoogleService-Info.plist 文件添加到项目中。

    • 将从 Firebase 控制台下载的 GoogleService-Info.plist 拖动到 Unity 项目中的任意文件夹内。

将 Firebase Unity SDK 添加到您的应用

  1. 下载 Firebase Unity SDK
  2. 选择“Assets > Import Package > Custom Package”菜单项。
  3. 从之前下载的 Firebase Unity SDK 中导入 FirebaseAnalytics.unitypackage 软件包。
  4. 当出现 Import Unity Package 窗口时,点击 Import 按钮。

构建您的应用

Android

  1. 依次选择 File > Build Settings 菜单选项。
  2. 选择 Platform 列表中的 Android
  3. 点击 Switch Platform,选择 Android 作为目标平台。
  4. 等待 Unity 状态栏右下角的旋转进度条(正在编译)图标停止旋转。
  5. 点击 Build and Run

iOS

  1. 依次选择 File > Build Settings 菜单选项。
  2. 选择 Platform 列表中的 iOS
  3. 点击 Switch Platform,选择 iOS 作为目标平台。
  4. 等待 Unity 状态栏右下角的旋转进度条(正在编译)图标停止旋转。
  5. 点击 Build and Run

记录事件

初始化 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 帮助中心。

发送以下问题的反馈:

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