事件

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. 选择左侧的“事件”选项卡，然后点击“添加事件”按钮。
3. 填写您要创建的事件的详细信息。
4. 点击“保存”。如果没有任何错误，您的事件将置于“准备发布”状态。您现在可以继续发布游戏更改。

编辑事件

要编辑您创建的事件

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

删除事件

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

重置事件数据

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

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

客户端实现

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

• Android
• Web