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

# player_ranked_on_leaderboard_version

> player_ranked_on_leaderboard_version 이벤트입니다.

이 이벤트는 리더보드 버전이 변경될 때 트리거되며, "리더보드 버전 변경 시 전송되는 상위 순위 이벤트" 설정으로 정의된 제한까지 상위 순위 플레이어에 대한 이벤트를 생성합니다.

## 속성

| 이름                    | 형식                                                                                                                      | 설명                                                        |
| :-------------------- | :---------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------- |
| LeaderboardSource     | [LeaderboardSource](/services/playfab/api-references/events/data-types/leaderboardsource)                               | 리더보드 값의 소스입니다.                                            |
| Rank                  | uint32                                                                                                                  | 리더보드에서 플레이어의 순위입니다.                                       |
| TitleId               | String                                                                                                                  | 이 플레이어 이벤트가 적용되는 타이틀의 ID입니다.                              |
| Value                 | int32                                                                                                                   | 플레이어의 리더보드 값입니다.                                          |
| Version               | uint32                                                                                                                  | 플레이어가 순위에 오른 리더보드의 버전입니다. 플레이어 통계 리더보드의 경우 통계의 버전과 일치합니다. |
| VersionChangeBehavior | [LeaderboardVersionChangeBehavior](/services/playfab/api-references/events/data-types/leaderboardversionchangebehavior) | 버전 변경 시 리더보드 값에 대한 동작입니다.                                 |

## 공통 속성

모든 V1 PlayStream 이벤트는 JSON 객체 형식이며 다음과 같은 공통 속성을 공유합니다:

| 이름             | 형식                                                                          | 설명                                                                                                                                                                                                                                                  |
| :------------- | :-------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EntityId       | String                                                                      | 이 이벤트가 적용되는 엔터티(타이틀, 플레이어 등)의 식별자입니다.                                                                                                                                                                                                               |
| EntityType     | String                                                                      | 이 이벤트가 적용되는 엔터티(플레이어, 타이틀 등)의 유형입니다. PlayFab이 이 엔터티에 대해 작업을 수행하려면 EntityType이 'player', 'character' 또는 'title' 중 하나여야 합니다. PlayFab이 현재 구문 분석하지 않는 엔터티 유형에는 네임스페이스('com.mygame.guild' 등)를 접두사로 붙여야 하며, PlayFab이 언제든지 루트 엔터티를 구문 분석하기 시작할 수 있기 때문입니다. |
| EventId        | String                                                                      | 이 이벤트에 대해 PlayFab이 할당한 고유 식별자입니다.                                                                                                                                                                                                                   |
| EventName      | String                                                                      | 이 이벤트의 이름입니다.                                                                                                                                                                                                                                       |
| EventNamespace | String                                                                      | 이 이벤트에 할당된 네임스페이스입니다. 예: 'com.myprogram.ads'                                                                                                                                                                                                        |
| Source         | String                                                                      | 이 PlayStream 이벤트의 소스 이름이며, 이벤트가 PlayFab에서 시작된 경우 PlayFab이 됩니다.                                                                                                                                                                                      |
| SourceType     | [SourceType](/services/playfab/api-references/events/data-types/sourcetype) | 이 이벤트의 소스 유형입니다(PlayFab 파트너, 다른 백엔드 또는 PlayFab API에서).                                                                                                                                                                                              |
| Timestamp      | DateTime                                                                    | 이 이벤트와 연결된 시간(UTC)입니다.                                                                                                                                                                                                                              |


## Related topics

- [PlayFab의 PlayStream 이벤트 모델 참조](/ko/services/playfab/api-references/events/index.md)
- [Using resettable statistics and leaderboards](/ko/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards.md)
- [Limits on Leaderboards](/ko/services/playfab/community/leaderboards/limits-leaderboards.md)
- [leaderboard_version_ended](/ko/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended.md)
- [Leaderboards with PlayStream and Telemetry](/ko/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)