事件

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

  • 使用特定物品
  • 达到特定等级
  • 执行某些特定游戏操作

您可以使用事件数据作为关于如何改进游戏的反馈。例如，您可以调整游戏中某些关卡的难度级别，这些关卡玩家发现太难完成。

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

在游戏中集成事件

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

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

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

  3. 查看事件数据。转到 Google Play Console 中您游戏的“事件”页面以查看捕获事件的统计信息。

事件基础

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

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

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

示例

  • "击杀的僵尸"
  • "收集到的红色宝石"
描述 事件的较长描述（例如，“玩家击杀僵尸的次数”或“玩家消灭和匹配的红色宝石总数”）。描述最多可包含 500 个字符。此值由 Google Play Console 使用，并可能显示在您的游戏中。
事件类型

声明事件正在跟踪的数据类型的字段。此值由 Google Play Console 用于支持玩家分析报告。

支持两种事件类型

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

创建事件

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

  1. 在 Google Play Console 中添加您的游戏，如果您尚未这样做。
  2. 在 Google Play Console 中，点击左侧的游戏服务图标，然后选择您游戏的条目。
  3. 选择左侧的“事件”选项卡，然后点击“添加事件”按钮。
  4. 填写您要创建的事件的详细信息。
  5. 点击“保存”。如果没有任何错误，您的事件将进入“准备发布”状态。您现在可以继续 发布游戏更改。

编辑事件

要编辑您创建的事件

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

删除事件

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

重置事件数据

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

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

客户端实现

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