事件

借助 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 可引用游戏客户端中的活动。
Name 活动的简称。名称最多可包含 100 个字符。此值供 Google Play 管理中心使用，且可在游戏中显示。

示例：

  • “杀死的僵尸数量”
  • “收集的红宝石数量”
Description 活动的详细说明（例如，“玩家杀死僵尸的次数”或“玩家消除并匹配的红宝石总数）。说明最多可包含 500 个字符。此值供 Google Play 管理中心使用，且可在游戏中显示。
Event type

用于声明活动跟踪的数据类型的字段。Google Play 管理中心使用此值来支持玩家分析报告。

支持以下两种活动类型：

游戏代币来源
对于跟踪游戏代币来源的活动，请选择此类型。例如：
  • “赚取的金币”
  • “购买的翡翠”
游戏代币消耗
对于跟踪游戏代币消耗的活动，请选择此类型。例如：
  • “花费的金币”
  • “使用的翡翠”
Icon 将与活动相关联的方形图标。

创建活动

如需为您的游戏创建新活动，请按以下步骤操作：

  1. 将游戏添加到 Google Play 管理中心（如果您尚未添加）。
  2. 在 Google Play 管理中心内，点击左侧的“游戏服务”图标，然后选择您的游戏对应的条目。
  3. 选择左侧的活动标签页，然后点击添加活动按钮。
  4. 输入您要创建的活动的详细信息。
  5. 点击保存。如果没有出现错误，您的活动将处于“可以发布”状态。您现在可以继续发布游戏更改。

修改活动

若要修改您已创建的活动，请按以下步骤操作：

  1. 在 Google Play 管理中心内，打开活动标签页，然后选择要修改的活动对应的条目。您应该会看到创建活动时所用的表单。
  2. 根据需要进行修改。
  3. 修改完活动后，点击保存按钮。
  4. 测试您的游戏，以验证修改后的活动。如果一切正常，请重新发布游戏更改。

删除活动

您可以删除处于草稿状态或已发布的活动。如需在 Google Play 管理中心内删除活动，请在相应活动的表单底部点击标有删除的按钮。

重置活动数据

您可以为活动的测试人员重置玩家进度数据。

  • 如需在 Google Play 管理中心内重置活动草稿，请在相应活动的表单底部点击标有重置活动进度的按钮。
  • 如需以编程方式重置活动数据，请调用 Management API Events 方法。

客户端实现

如需了解如何为您的平台实现活动，请参阅以下资源：