排行榜与 PlayStream 和遥测

通过将排行榜与 PlayStream 集成，你可以轻松利用实时事件摄取和处理管道，构建在排行榜版本变更时触发的自定义玩家体验。借助 PlayStream 操作和规则，你可以触发自定义的 CloudScript 或 Azure Functions，以驱动参与度和留存功能，例如向顶级玩家授予奖励、向玩家发送个性化通知，或执行分数验证以检查作弊者。PlayStream 事件也将存档在数据资源管理器中，用于数据分析和数据仓库。 如果你只需要数据分析和数据仓库功能而不需要实时事件操作，排行榜还与遥测事件集成，仅提供分析功能。 排行榜提供两个可选事件：

• playfab.leaderboard.leaderboard_version_ended
• playfab.leaderboard.entity_rank_on_leaderboard_version_ended

这两个事件允许你快速了解排行榜版本何时结束，并允许你根据需要立即查询以前的数据。借助排行榜版本结束时的实体排名事件，你可以获取该排行榜版本结束时排名最高的实体的排名和分数。

​

启用 PlayStream 或遥测事件

你可以在创建新排行榜或编辑现有排行榜定义时启用事件。找到 PlayStream 和遥测事件配置部分，然后选择 None、PlayStream 或 Telemetry。

注意： 预先存在的排行榜默认关闭排行榜版本结束事件和排行榜版本结束时的实体排名事件。如果你想启用它们或只启用其中之一，请转到你想要修改的排行榜并启用该设置。

一旦提交，每当排行榜版本变更时就会发出事件。

​

事件用法

若要了解如何利用这些事件执行不同的操作，例如连接到 Azure 函数，请查看以下资源：

• 将 CloudScript 操作与 PlayStream 结合使用
• 快速入门：使用 Azure Functions 编写 PlayFab CloudScript
• CloudScript 快速入门

​

限制和注意事项

• playfab.leaderboard.entity_rank_on_leaderboard_version_ended 事件仅返回排名前 1000 名。
• playfab.leaderboard.entity_rank_on_leaderboard_version_ended 事件将为排行榜内的每一条目发送一个事件。
• playfab.leaderboard.entity_rank_on_leaderboard_version_ended 事件不适用于实体类型为 master_player_account 或 external 的排行榜。

​

另请参阅

• playfab.leaderboard.leaderboard_version_ended
• playfab.leaderboard.entity_rank_on_leaderboard_version_ended
• PlayStream 概述
• 统计信息与 PlayStream 和遥测。
• 遥测概述
• 定价计量表
• PlayStream 事件功能
• 将 CloudScript 操作与 PlayStream 结合使用
• 快速入门：使用 Azure Functions 编写 PlayFab CloudScript
• CloudScript 快速入门
• 排行榜的限制
• 排行榜与 CloudScript。