事件

借助 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 方法

客户端实现

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