> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 排行榜與 PlayStream 和 Telemetry

> 將 PlayFab 排行榜版本結束事件和實體排名事件發送至 PlayStream 或 Telemetry，以觸發 CloudScript、Azure Functions 或獎勵排名最高的玩家。

透過 Leaderboards 與 [PlayStream](/zh-TW/services/playfab/data-analytics/ingest-data/playstream-overview) 的整合，您可以輕鬆利用即時事件擷取和處理管線，建置在排行榜版本變更時觸發的自訂玩家體驗。透過 [PlayStream 動作和規則](/zh-TW/services/playfab/data-analytics/acting-data/action-rules-quickstart)，您可以觸發自訂 [CloudScript](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript) 或 [Azure Functions](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)，以推動參與度和留存率功能，例如向排名最高的玩家[授與獎勵](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory)、傳送個人化通知給玩家，或執行分數驗證以檢查作弊者。PlayStream 事件也會封存在 Data Explorer 中，以供資料分析和倉儲使用。

如果您只需要資料分析和倉儲，而不需要即時事件動作，Leaderboards 與 [Telemetry 事件](/zh-TW/services/playfab/data-analytics/ingest-data/telemetry-overview)整合，可只提供分析功能。

Leaderboards 提供兩個選用事件：

* [`playfab.leaderboard.leaderboard_version_ended`](/zh-TW/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](/zh-TW/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)

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

## 啟用 PlayStream 或 Telemetry 事件

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

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/create-leaderboard-with-events.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=c45d0ef67226e657e6e7c272ea3c0279" alt="此影像顯示用於設定事件參數的設定畫面，包括重設頻率、排行榜事件和實體排名限制。" width="1157" height="830" data-path="images/playfab/community/leaderboards/create-leaderboard-with-events.png" />

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

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

## 事件使用方式

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

* [搭配 PlayStream 使用 CloudScript 動作](/zh-TW/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [快速入門：使用 Azure Functions 撰寫 PlayFab CloudScript](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [CloudScript 快速入門](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)

## 限制與注意事項

* `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`](/zh-TW/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](/zh-TW/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)
* [PlayStream 概觀](/zh-TW/services/playfab/data-analytics/ingest-data/playstream-overview)
* [統計資料與 PlayStream 和 Telemetry](/zh-TW/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry)。
* [Telemetry 概觀](/zh-TW/services/playfab/data-analytics/ingest-data/telemetry-overview)
* [定價計量](/zh-TW/services/playfab/pricing/meters/meters)
* [PlayStream 事件功能](/zh-TW/services/playfab/data-analytics/ingest-data/playstream-event-capabilities)
* [搭配 PlayStream 使用 CloudScript 動作](/zh-TW/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [快速入門：使用 Azure Functions 撰寫 PlayFab CloudScript](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [CloudScript 快速入門](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)
* [排行榜的限制](/zh-TW/services/playfab/community/leaderboards/limits-leaderboards)
* [排行榜與 Cloudscript](/zh-TW/services/playfab/community/leaderboards/leaderboards-cloudscript)。


## Related topics

- [PlayFab Leaderboards 概觀](/zh-TW/services/playfab/community/leaderboards/index.md)
- [群組排行榜](/zh-TW/services/playfab/community/leaderboards/group-leaderboards.md)
- [排行榜配額](/zh-TW/services/playfab/community/leaderboards/quota-leaderboards.md)
- [季節性排行榜](/zh-TW/services/playfab/community/leaderboards/seasonal-leaderboards.md)
- [排行榜的限制](/zh-TW/services/playfab/community/leaderboards/limits-leaderboards.md)
