排行榜與 PlayStream 和 Telemetry

透過 Leaderboards 與 PlayStream 的整合，您可以輕鬆利用即時事件擷取和處理管線，建置在排行榜版本變更時觸發的自訂玩家體驗。透過 PlayStream 動作和規則，您可以觸發自訂 CloudScript 或 Azure Functions，以推動參與度和留存率功能，例如向排名最高的玩家授與獎勵、傳送個人化通知給玩家，或執行分數驗證以檢查作弊者。PlayStream 事件也會封存在 Data Explorer 中，以供資料分析和倉儲使用。 如果您只需要資料分析和倉儲，而不需要即時事件動作，Leaderboards 與 Telemetry 事件整合，可只提供分析功能。 Leaderboards 提供兩個選用事件：

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

這兩個事件可讓您快速得知排行榜版本何時結束，並讓您能隨時查詢先前的資料。透過排行榜版本結束時的實體排名事件，您可以在排行榜版本結束時，取得該排行榜排名最高實體的排名和分數。

​

啟用 PlayStream 或 Telemetry 事件

您可以在建立新排行榜或編輯現有排行榜定義時啟用事件。找到 PlayStream 和遙測事件設定的區段，然後選取 [None]、[PlayStream] 或 [Telemetry]。

注意： 既有的排行榜預設會關閉排行榜版本結束事件和排行榜版本結束時的實體排名事件。如果您想要啟用這兩個事件或其中之一，請前往您要修改的排行榜並啟用該設定。

提交後，每當排行榜版本變更時就會發出事件。

​

事件使用方式

若要深入了解如何利用這些事件執行不同的動作 (例如連線至 Azure 函式)，請參閱下列資源：

• 搭配 PlayStream 使用 CloudScript 動作
• 快速入門：使用 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 和 Telemetry。
• Telemetry 概觀
• 定價計量
• PlayStream 事件功能
• 搭配 PlayStream 使用 CloudScript 動作
• 快速入門：使用 Azure Functions 撰寫 PlayFab CloudScript
• CloudScript 快速入門
• 排行榜的限制
• 排行榜與 Cloudscript。