> ## 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.

# Leaderboards with PlayStream and Telemetry

> Emit PlayFab leaderboard version-ended and entity rank events to PlayStream or Telemetry to trigger CloudScript, Azure Functions, or reward top players.

리더보드가 [PlayStream](/services/playfab/data-analytics/ingest-data/playstream-overview)과 통합되어 있으므로, 실시간 이벤트 수집 및 처리 파이프라인을 손쉽게 활용하여 리더보드 버전이 변경될 때 트리거되는 사용자 지정 플레이어 경험을 구축할 수 있습니다. [PlayStream 작업 및 규칙](/services/playfab/data-analytics/acting-data/action-rules-quickstart)을 사용하면 사용자 지정 [CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript) 또는 [Azure Functions](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)를 트리거하여, 상위 플레이어에게 [보상 지급](/services/playfab/economy-monetization/economy-v2/inventory), 플레이어에게 개인화된 알림 전송, 부정 행위자 검사를 위한 점수 검증 수행 등 참여와 유지를 유도하는 기능을 실행할 수 있습니다. PlayStream 이벤트는 데이터 분석 및 웨어하우징을 위해 Data Explorer에 보관되기도 합니다.

실시간 이벤트 작업 없이 데이터 분석과 웨어하우징만 원한다면, 리더보드는 [Telemetry Events](/services/playfab/data-analytics/ingest-data/telemetry-overview)와도 통합되어 분석 기능만 제공합니다.

리더보드는 두 가지 선택 이벤트를 제공합니다.

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

이 두 이벤트를 통해 리더보드 버전이 종료된 시점을 빠르게 알 수 있고, 원할 때 즉시 이전 데이터를 쿼리할 수 있습니다. entity rank on leaderboard version ended를 사용하면, 리더보드 버전이 종료될 때 해당 리더보드의 상위 엔티티의 순위와 점수를 얻을 수 있습니다.

## PlayStream 또는 Telemetry 이벤트 활성화

새 리더보드를 만들거나 기존 리더보드 정의를 편집할 때 이벤트를 활성화할 수 있습니다. PlayStream 및 telemetry 이벤트 구성 섹션을 찾아 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" />

> **참고:** 기존 리더보드에는 기본적으로 leaderboard version ended 및 entity rank on leaderboard version ended 이벤트가 모두 꺼져 있습니다. 이 두 가지를 모두 또는 하나만 활성화하려면 수정하려는 리더보드로 이동하여 해당 설정을 활성화하세요.

제출되면 리더보드 버전이 변경될 때마다 이벤트가 발생합니다.

## 이벤트 사용

이 이벤트를 활용해 Azure Function 연결과 같은 다양한 작업을 수행하는 방법에 대한 자세한 내용은 다음 리소스를 확인하세요.

* [PlayStream과 함께 CloudScript 작업 사용](/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [Quickstart: Azure Functions를 사용하여 PlayFab CloudScript 작성하기](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [CloudScript 빠른 시작](/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`](/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)
* [PlayStream 개요](/services/playfab/data-analytics/ingest-data/playstream-overview)
* [PlayStream 및 Telemetry로 통계 사용](/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry).
* [Telemetry 개요](/services/playfab/data-analytics/ingest-data/telemetry-overview)
* [Pricing Meters](/services/playfab/pricing/meters/meters)
* [PlayStream 이벤트 기능](/services/playfab/data-analytics/ingest-data/playstream-event-capabilities)
* [PlayStream과 함께 CloudScript 작업 사용](/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [Quickstart: Azure Functions를 사용하여 PlayFab CloudScript 작성하기](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [CloudScript 빠른 시작](/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)
* [리더보드 제한 사항](/services/playfab/community/leaderboards/limits-leaderboards)
* [리더보드와 CloudScript](/services/playfab/community/leaderboards/leaderboards-cloudscript).


## Related topics

- [PlayFab 리더보드 개요](/ko/services/playfab/community/leaderboards/index.md)
- [PlayStream 및 Telemetry와 함께 사용하는 통계](/ko/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry.md)
- [PlayFab의 PlayStream 이벤트 모델 참조](/ko/services/playfab/api-references/events/index.md)
- [PlayStream](/ko/services/playfab/data-analytics/ingest-data/playstream-overview.md)
- [Insights 모범 사례](/ko/services/playfab/data-analytics/legacy/insights/best-practices.md)
