事件

Google Play 游戏事件服务允许您收集玩家在游戏过程中生成的累积数据，并将其存储在 Google 服务器中以进行游戏分析。您可以灵活定义您的游戏应收集哪些玩家数据；这可能包括以下指标的频率，例如

  • 玩家使用某个特定物品的频率
  • 玩家达到某个特定等级的频率
  • 玩家执行某个特定游戏动作的频率

您可以将事件数据作为改进游戏的反馈。例如，您可以调整游戏中某些玩家觉得太难完成的关卡的难度级别。

要了解如何为您的平台实现事件，请参阅客户端实现。

在您的游戏中集成事件

以下工作流程描述了如何在游戏中应用事件

  1. 定义事件。要在游戏中定义要捕获的新事件
    1. 在Google Play 管理中心，转到您游戏的事件页面。
    2. 点击添加新事件按钮并配置事件属性。
    3. 按照发布您的游戏更改中描述的步骤发布您的事件定义。

  2. 使用事件 API 在游戏中实现事件捕获。例如，在您的 Android 代码中，每当您的游戏检测到其关注的事件被触发时，调用事件 increment 方法。

  3. 查看事件数据。转到 Google Play 管理中心中您游戏的事件页面，以查看所捕获事件的统计信息。

事件基础知识

事件 API 提供了一种定义和收集有趣游戏指标并将其上传到 Play 游戏 SDK 的方法。

Play 游戏 SDK 事件包含以下关键属性

属性 说明
ID Google Play 管理中心为此事件生成的唯一字符串。使用此唯一 ID 在您的游戏客户端中引用该事件。
名称 事件的短名称。名称最多可包含 100 个字符。此值由 Google Play 管理中心使用，并可在您的游戏中显示。

示例

  • “僵尸击杀数”
  • “收集的红色宝石数”
说明 事件的更长说明（例如，“玩家击杀僵尸的次数”或“玩家消除和匹配的红色宝石总数”）。说明最多可包含 500 个字符。此值由 Google Play 管理中心使用，并可在您的游戏中显示。
事件类型

一个字段，声明事件正在跟踪的数据类型。此值由 Google Play 管理中心用于支持玩家分析报告。

支持两种事件类型

高级货币来源
选择此类型用于跟踪高级货币来源的事件。例如
  • “赚取的金币”
  • “购买的翡翠”
高级货币消耗
选择此类型用于跟踪高级货币消耗或使用的事件。例如
  • “花费的金币”
  • “使用的翡翠”
图标 将与您的事件关联的方形图标。

创建事件

要为您的游戏创建新事件，请按照以下步骤操作

  1. 在Google Play 管理中心，点击左侧的游戏服务图标并选择您的游戏条目。
  2. 选择左侧的事件标签页，然后点击添加事件按钮。
  3. 填写您要创建的事件的详细信息。
  4. 点击保存。如果没有错误，您的事件将处于“准备发布”状态。您现在可以继续发布您的游戏更改。

编辑事件

要编辑您已创建的事件

  1. 在Google Play 管理中心，打开事件标签页并选择您要编辑的事件条目。您应该会看到与创建事件时使用的相同表单。
  2. 进行您的编辑更改。
  3. 完成事件编辑后，点击保存按钮。
  4. 测试您的游戏以验证修改后的事件。如果它正常工作，请重新发布您的游戏更改。

删除事件

您可以删除处于草稿状态或已发布的事件。要在 Google Play 管理中心删除事件，请点击该事件表单底部的删除按钮。

重置事件数据

您可以重置事件测试人员的玩家进度数据。

  • 要在 Google Play 管理中心重置草稿事件，请点击该事件表单底部的重置事件进度按钮。
  • 要以编程方式重置事件数据，请调用管理 API Events 方法。

客户端实现

要了解如何为您的平台实现事件，请参阅以下资源