메트릭스 인터페이스

게임 이용 데이터 수집을 위해 플레이 세션을 기록하는 인터페이스입니다.

Metrics Interface (메트릭스 인터페이스)는 게임 이용을 추적하고 데브 포털 내의 게임 애널리틱스 대시보드를 채웁니다. 이 데이터는 게임 클라이언트와 서버의 활성 온라인 인스턴스, 그리고 로컬 플레이어가 플레이한 지난 세션을 포함합니다.

이용 메트릭스 수집

데이터 수집을 활성화하려면 플랫폼 인터페이스 함수인 EOS_Platform_GetMetricsInterface 를 통해 EOS_HMetrics 핸들을 획득합니다. 모든 메트릭스 인터페이스 함수는 첫 파라미터로 이 핸들을 필요로 합니다.

Epic Online Services (EOS, 에픽 온라인 서비스) SDK는 백엔드 서비스가 프로세싱과 스토리지를 수행하는 동안 데이터를 수집합니다. 집계된 결과는 게임 애널리틱스 대시보드에서 볼 수 있습니다. 이를 통해 전 세계 게임 활동, 플레이어 리텐션, 온라인 사용자 수 등을 모니터할 수 있습니다.

한계

메트릭스 데이터는 5분 간격으로 업데이트됩니다. 이 업데이트 간격 때문에 테스트하는 동안 클라이언트가 대시보드에 즉시 표시되지 않을 수 있습니다. 또한 사용자 리텐션 계산에는 며칠 동안의 기록 데이터가 필요하기 때문에 게임 애널리틱스 대시보드에 첫 며칠 동안의 플레이어 리텐션은 표시되지 않을 것입니다.

메트릭스 수집을 수행하려면 EOS SDK의 노출된 API만을 사용해야 합니다. EOS SDK는 외부 프로그램 또는 서비스와 함께 메트릭스 수집에 사용될 수 없습니다.

플레이 세션 보고

EOS 데이터 수집은 각 플레이어가 각 플레이 세션을 시작할 때와 끝낼 때 발생하는 게임 보고에 의존합니다. 세션을 기록하려면 EOS_Metrics_BeginPlayerSession 을 게임 내 각 플레이어에 대한 EOS_Metrics_BeginPlayerSessionOptions 데이터 구조체로 호출합니다. 이 작업은 플레이어가 외부 서버에서 게임에 참여했거나 자체적으로 게임을 호스팅하고 있음을 SDK에 알릴 것입니다. 플레이어가 서버를 떠나거나 로컬 세션을 끝내면 EOS_Metrics_EndPlayerSessionEOS_Metrics_BeginPlayerSessionOptions 데이터 구조체로 호출하여 세션 종료를 표시합니다.

EOS_Metrics_BeginPlayerSession 호출과 EOS_MetricsEndPlayerSession 호출을 짝 지워야 합니다. 그렇게 하지 않으면 보고된 메트릭스 데이터가 부정확해집니다. EOS_Metrics_BeginPlayerSessionEOS_Metrics_BeginPlayerSession

EOS_Metrics_BeginPlayerSession 을 호출할 때는 EOS_Metrics_BeginPlayerSessionOptions 구조체를 다음 정보로 초기화합니다.

프로퍼티

ApiVersion

EOS_METRICS_BEGINPLAYERSESSION_API_LATEST 로 설정합니다.

LocalUserId

로컬 사용자의 글로벌 고유 계정 식별자입니다. 에픽 사용자 계정에 사용됩니다.

LocalUserIdExternal

로컬 사용자의 글로벌 고유 계정 식별자입니다. 에픽 사용자가 아닌 계정에 사용됩니다.

DisplayName

UTF-8 스트링인 플레이어의 게임 내 이름입니다.

ControllerType

플레이어가 사용 중인 게임 컨트롤러 유형입니다.

ServerIp

게임 세션을 호스팅하는 게임 서버의 IP 주소입니다.

GameSessionId

게임은 맞춤형 매치 식별자 문자열을 설정하여 백엔드 서비스의 세션 기록에 붙일 수 있습니다. 향후 이 데이터를 게임 세션 플레이 도중 발생한 추적된 이벤트와 연결할 수 있게 됩니다.

EOS_Metrics_EndPlayerSession 을 호출할 때는 EOS_Metrics_EndPlayerSessionOptions 구조체를 다음 정보로 초기화합니다.

프로퍼티

ApiVersion

EOS_METRICS_ENDPLAYERSESSION_API_LATEST 로 설정합니다.

LocalUserId

세션을 시작한 플레이어의 계정 ID입니다. 앞서 호출한 EOS_Metrics_BeginPlayerSession 에 사용된 `LocalUserId`와 일치해야 합니다.

LocalUserIdExternal

세션을 시작한 플레이어의 계정 ID입니다. 앞서 호출한 EOS_Metrics_BeginPlayerSession 에 사용된 LocalUserIdExternal 과 일치해야 합니다.

Concurrent Online Users (CCU, 온라인 동시 사용자)와 사용자 리텐션 데이터 수집

EOS SDK는 온라인 동시 사용자와 게임 서버의 수를 자동으로 기록합니다. 이 기능은 SDK가 게임 클라이언트 또는 서버를 실행되고 있는 온라인 기기에서 초기화될 때 활성화됩니다. 사용자 리텐션은 게임이 며칠 동안 실행된 이후에 계산되며, 보고된 게임 세션을 바탕으로 한 기록 데이터를 사용합니다.