이벤트 개요
참고: 이 문서는 타이틀 관리 사용자 통계가 아닌 이벤트 기반 사용자 통계를 사용할 때 적용됩니다.
참고 Application Insights는 더 이상 사용하지 않습니다. fiddler를 사용하여 이벤트를 모니터링하세요.
Xbox 서비스 사용자 통계 서비스에 게임 이벤트 쓰기
게임에서 가장 흥미로운 순간은 적에게 승리하고, 패배하고, 위치를 이동하고, 무기를 발사하고, 꽃을 따는 것과 같이 무언가 중요한 일이 벌어질 때입니다. 타이틀은 Xbox 서비스를 사용하여 플레이어 게임의 중요한 이벤트에 대한 정보를 공유할 수 있습니다. 세부 정보는 사용자에 대한 통계를 기록하는 Xbox 서비스로 보낼 수 있습니다. 이러한 통계를 검색하여 사용자 통계, 순위표, 매치 메이킹에서 사용할 수 있습니다.
이벤트 및 이벤트의 일부로 전송된 모든 데이터가 서비스에 도달하면 Xbox 서비스는 타이틀에 대한 서비스 구성에서 정의한 규칙을 처리하여 사용자 통계, 순위표 등을 생성하거나 업데이트합니다.
파트너 센터에서의 구성
먼저 플레이어 통계 | 상태 규칙 페이지의 파트너 센터에서 이벤트를 정의합니다. 파트너 센터에서 이벤트 및 통계를 정의하면, 다음 단계를 수행하여 이벤트를 보낼 수 있습니다.
이벤트 쓰기
Microsoft GDK(게임 개발 키트) 타이틀의 경우 이벤트를 보내는 API는 Xbox One 소프트웨어 개발 키트 타이틀의 경우와 다르며 매니페스트 파일을 사용할 필요가 없습니다.
XblEventsWriteInGameEvent 함수는 다음과 같이 선언됩니다.
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 서비스 컨텍스트 핸들입니다.
eventName은(는) 파트너 센터에 정의된 이벤트 이름입니다.
dimensions은(는) 한정된 값 집합을 취하는 이벤트 속성에 해당하는 속성 모음입니다. 예: 레벨, 무기 또는 문자.
measurements은(는) 불확실한 값 집합이 있는 이벤트 속성에 해당하는 속성 모음입니다. 예: 주행 거리, 적군 살해 또는 플레이 시간.
차원 및 측정값에 대해서는 아래에서 자세히 설명합니다.
측정값 및 차원
Xbox 서비스의 이벤트 목적으로 XblEventsWriteInGameEvent를 호출할 때 이벤트 속성을 차원이나 측정값으로 전달해도 차이가 없습니다. 이러한 차이점은 원격 분석용 Application Insights 이벤트를 분석하는 경우에만 관련이 있습니다. 게임 플레이 환경에는 영향을 주지 않습니다. 사용자 지정 이벤트 및 메트릭용 Application Insights API에 자세한 정보가 있습니다.
차원을 사용하여 이벤트에서 필터링 또는 피벗을 수행할 수 있습니다. 예: 사용자를 완료된 레벨 6으로 표시하거나 사용한 무기가 "미니건"인 모든 "적군 사살" 이벤트를 표시합니다.
측정값은 그래픽으로 표시하거나 순위표에서 사용할 수 있습니다. 예: 트랙 시간, 연승 기록 등
그러나 Xbox 서비스에서 사용하는 데는 이벤트 속성을 측정값으로 또는 차원으로 전달하든 전혀 차이가 없고, 도전 과제 잠금 해제 및 기타 Xbox 서비스 관련 기능에서는 동일하게 처리됩니다.
Xbox 서비스 이벤트 디버깅
타이틀의 이벤트가 Xbox 서비스에 성공적으로 도달하지 않으면 영웅 통계와 순위표가 업데이트되지 않습니다. 이벤트가 Xbox 서비스에서 성공적으로 수신되지 않는 것으로 의심되면 다음 단계를 시도하세요.
샌드박스가 올바른지 확인합니다.
디바이스에서 Fiddler를 설정합니다. Fiddler에서는 다음과 같은 이벤트가 표시됩니다.
v10.vortex-win.data.microsoft.com에 대한 호출을 찾습니다. 표시된 대로 요청 본문을 디코딩해야 합니다. 그런 다음 JSON을 보면 다음과 같은 내용이 표시될 것입니다.
이벤트 이름이 예상대로 표시되는지 확인할 수 있습니다. 타이틀 ID가 이름 앞에 붙습니다. 또한 200 반환 코드가 있는지도 확인해야 합니다.