自定义事件

自定义事件 使您能够跟踪特定于您游戏的指标，而这些指标是其他事件无法完全捕捉的。这包括：

• 采纳 — 有多少用户点击了特定的 UI 组件？
• 用户行为 — 每张地图上最常用的能力是什么？
• 核心循环 — 不同武器之间的击杀/死亡比如何比较？

一旦您的游戏开始跟踪自定义事件，您将解锁 Creator Hub 中的分析仪表板的 探索 页面。您可以在游戏中添加最多 100 个自定义事件。

跟踪自定义事件

要解锁 探索 页面，您必须先在游戏中跟踪自定义事件。首先确定哪些指标对于监控和改善您的游戏最为重要。事件每天汇总，因此图表可能需要最多 24 小时才能在页面上显示。

计数器

计数器是捕获的单次事件，没有值。您可以使用计数器跟踪特定事件发生的次数。将计数器用于单一操作，例如点击按钮、开始任务或使用工具。

事件会自动跟踪事件计数和唯一用户计数。对于值聚合，计数器事件被视为默认值为 1 的事件。这意味着最大/最小/平均等聚合将始终等于 1，总和将等于事件的总数。

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionStarted" -- 事件名称
)

带值的事件

您还可以跟踪带值的事件，以获取更多定量数据的指标，例如击杀/死亡比或用户在任务上花费的时间。它也可以用作批量发送事件的方式，以确保不超过速率限制，例如，发送 10 个击毙的僵尸，而不是 1 个被击毙的僵尸十次。

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionCompletedDuration", -- 事件名称
    120 -- 事件值
)

事件聚合

所有事件指标包括以下聚合，并支持切片和切块：

• 计数
• 唯一用户计数
• 平均值
• 总和
• 最小值
• 最大值
• 每用户的平均值

通过选择聚合类型，您可以在 探索 页面上查看事件聚合。

使用自定义字段

自定义事件还允许在自定义字段上进行细分，以支持不同区域之间的更容易比较。例如，您可以为每个事件提供任务名称，以查看哪些任务是用户最喜欢的，或附加玩家职业，以查看某个职业是否有显著更高的击杀/死亡比。

您可以通过使用细分选择器来使用自定义字段进行细分。

您应该尽可能使用自定义字段，而不是事件名称，因为事件名称的基数限制比自定义字段要严格得多。使用自定义字段还可以让您看到跨字段值的事件可视化。

例如，您可以将三个单独的事件 PlantCabbage、PlantTurnip、PlantPepper 更改为一个名为 PlantSeed 的单一事件，使用自定义字段值 Plant - Cabbage、Plant - Turnip 和 Plant - Pepper。这样，您可以在同一可视化中可视化总种植的种子数量，同时比较每种植物。这还降低了您的事件名称基数。

有关更多信息，请参见 自定义字段。

使用自定义事件来发展您的游戏

自定义事件使您能够跟踪最重要的指标，提供有关玩家如何与特定功能和内容互动的洞察。利用这些事件发现玩家行为的模式，并优化您的核心游戏循环。

在参考游戏 Plant 中，核心循环会在玩家收获成熟植物时触发 HarvestPlant 事件。通过使用自定义事件，您可以跟踪每天每个玩家收获的植物平均数量，并按植物类型作为自定义字段进行细分：

• 尝试改善游戏中的内容多样性，鼓励玩家探索其他选项，作为 核心循环 的一部分，以防止重复性。
• 探索用户为何显著偏爱萝卜，而萝卜是否造成了任何失衡（例如与 经济事件 相关）。
• 在您的循环中添加更多事件跟踪，例如种植种子、浇水植物和去商店，以更好地跟踪玩家行为和其他改进领域。