> ## 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. # 이벤트 개요 > 이벤트 기반 플레이어 데이터 타이틀에서 통계, 순위표 및 매치메이킹을 업데이트하기 위해 XBOX Live 게임 이벤트가 사용자 통계 서비스에 데이터를 공급하는 방법. **참고:** 이 문서는 타이틀 관리 사용자 통계가 아닌 이벤트 기반 사용자 통계를 사용하는 경우에만 적용됩니다. **참고** Application Insights는 더 이상 사용되지 않습니다. 이벤트를 모니터링하려면 [fiddler](https://learn.microsoft.com/windows/uwp/xbox-live/using-xbox-live/troubleshooting/how-to-set-up-fiddler-for-debugging)를 사용하세요. ## XBOX services 사용자 통계 서비스에 게임 이벤트 작성 게임에서 가장 흥미로운 순간은 중요한 무언가가 일어날 때입니다. 상대를 물리치거나, 패배하거나, 위치로 이동하거나, 무기를 발사하거나, 꽃을 꺾을 때 등이 그러합니다. XBOX services를 사용하면 타이틀은 플레이어의 게임에서 중요한 이벤트에 대한 정보를 공유할 수 있습니다. 세부 정보는 사용자에 대한 통계를 기록하는 XBOX services로 보낼 수 있습니다. 이 통계는 사용자 통계, 순위표 및 매치메이킹에서 사용하기 위해 검색할 수 있습니다. 이벤트와 이벤트의 일부로 전송된 데이터가 서비스에 도달하면 XBOX services는 타이틀에 대한 서비스 구성에서 정의한 규칙을 처리하여 사용자 통계, 순위표 등을 만들거나 업데이트합니다. ### Partner Center 구성 먼저 Partner Center의 플레이어 통계 | 통계 규칙 페이지에서 이벤트를 정의합니다. Partner Center에 이벤트와 통계가 정의되면 다음 단계에 따라 이벤트를 전송할 수 있습니다. ### 이벤트 작성 Microsoft Game Development Kit (GDK) 타이틀의 경우 이벤트를 전송하는 API가 XBOX One Software Development Kit 타이틀과 다르며 매니페스트 파일을 사용할 필요가 없습니다. [XblEventsWriteInGameEvent](/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent) 함수는 다음과 같이 선언됩니다. ```cpp theme={null} STDAPI XblEventsWriteInGameEvent( _In_ XblContextHandle xboxLiveContext, _In_z_ const char* eventName, _In_opt_z_ const char* dimensionsJson, _In_opt_z_ const char* measurementsJson ) XBL_NOEXCEPT; ``` `xboxLiveContext`는 XBOX services 컨텍스트 핸들입니다. `eventName`은 Partner Center에서 정의한 이벤트 이름입니다. `dimensions`는 유한한 값 집합을 가지는 이벤트 속성에 해당하는 속성 모음입니다. 예: 레벨, 무기 또는 캐릭터. `measurements`는 불확정한 값 집합을 가지는 이벤트 속성에 해당하는 속성 모음입니다. 예: 주행 거리, 처치한 적 수 또는 플레이한 시간(분). Dimensions와 Measurements에 대해서는 아래에서 더 자세히 설명합니다. #### Measurements와 Dimensions XBOX services에서 이벤트 목적으로 [XblEventsWriteInGameEvent](/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent)를 호출할 때 이벤트 속성을 dimension으로 전달하든 measurement로 전달하든 차이가 없습니다. 이러한 차이는 원격 분석을 위해 Application Insights에서 이벤트를 분석하는 경우에만 관련이 있으며, 이는 게임 플레이 경험에 영향을 미치지 않습니다. 자세한 정보는 [사용자 지정 이벤트 및 메트릭용 Application Insights API](https://azure.microsoft.com/documentation/articles/app-insights-api-custom-events-metrics/)에 있습니다. Dimensions는 이벤트를 필터링하거나 피벗하는 데 사용할 수 있습니다. 예: 레벨 6을 완료한 사용자를 표시하거나 사용된 무기가 "Minigun"이었던 "Enemies Killed" 이벤트를 모두 표시합니다. Measurements는 그래픽으로 표시하거나 순위표에 사용하는 것이 합리적일 수 있습니다. 예: 트랙 시간, 연속 라운드 승리 등. 그러나 XBOX services에서 사용할 목적으로는 이벤트 속성을 measurement로 전달하든 dimension으로 전달하든 차이가 없으며, 도전 과제 잠금 해제 및 기타 XBOX services 관련 기능의 목적으로 동일하게 처리됩니다. ### XBOX services 이벤트 디버깅 타이틀의 이벤트가 XBOX services에 성공적으로 도달하지 못하면 히어로 통계 및 순위표가 업데이트되지 않습니다. 이벤트가 XBOX services에서 성공적으로 수신되지 않고 있다고 의심되는 경우 다음 단계를 시도하세요. * 샌드박스가 올바른지 확인합니다. * 디바이스에서 Fiddler를 설정합니다. Fiddler에서 다음과 같이 이벤트를 볼 수 있습니다. Fiddler 디코딩되지 않은 이벤트 `v10.vortex-win.data.microsoft.com`에 대한 호출을 찾습니다. 표시된 대로 요청 본문을 디코딩해야 하며, JSON을 보면 다음과 같은 내용을 확인할 수 있습니다. Fiddler 디코딩된 이벤트 이벤트 이름이 예상한 것과 같은지 확인할 수 있습니다. 타이틀 ID가 이름 앞에 추가됩니다. 또한 200 반환 코드를 받고 있는지 확인해야 합니다. ## 참고 항목 [이벤트 기반과 타이틀 관리 통계 비교](/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm#update-frequency). ## Related topics - [이벤트](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-events-nav.md) - [이벤트 기반 스탯 첫걸음](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md) - [서비스에서 생성된 이벤트 활성화 또는 비활성화](/ko/services/playfab/data-analytics/ingest-data/opt-in-events.md) - [이벤트 기반 통계 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md) - [이벤트 기반 업적 개요](/ko/services/xbox-services/player-data/achievements/event-based/live-achievements-eb-overview.md)