메트릭스 인터페이스(Metrics Interface) 는 게임 이용을 추적하여 개발자 포털 내의 게임 애널리틱스(Game Analytics ) 대시보드를 채웁니다. 이 데이터는 게임 클라이언트와 서버의 활성 온라인 인스턴스, 그리고 로컬 플레이어가 플레이한 지난 세션을 포함합니다. 게임 애널리틱스 대시보드 에 액세스하려면 dev.epicgames.com/portal에서 개발자 포털에 로그인한 다음 왼쪽 탐색 메뉴에서 애널리틱스(Analytics) 를 선택합니다.
이용 메트릭스 수집
데이터 컬렉션을 활성화하려면 플랫폼 인터페이스 함수인 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_EndPlayerSession 을 EOS_Metrics_EndPlayerSessionOptions 데이터 구조체로 호출하여 세션 종료를 표시합니다.
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 과 일치해야 합니다. |
온라인 동시 사용자(CCU)와 사용자 리텐션 데이터 수집
EOS SDK는 온라인 동시 사용자와 게임 서버의 수를 자동으로 기록합니다. 이 기능은 게임 클라이언트 또는 서버를 실행하고 있는 온라인 장치에서 SDK가 초기화될 때 활성화됩니다. 사용자 리텐션 데이터는 게임이 며칠 동안 실행된 이후에 계산되며, 보고된 플레이 세션을 바탕으로 한 기록 데이터를 사용합니다.