데이터 모델

Framedash SDK가 수집하고 전송하는 데이터의 구조를 설명합니다.

이벤트

모든 텔레메트리는 이벤트로 전송됩니다. 각 이벤트에는 공통 필드와 커스텀 속성이 있습니다.

공통 필드

필드	타입	설명
event_type	string	이벤트 종류 (예: performance_sample, player_death)
timestamp	ISO 8601	이벤트 발생 시각
session_id	UUID	게임 세션 ID
device_id	string	디바이스 식별자
build_id	string	빌드 버전

퍼포먼스 샘플

SDK가 자동으로 수집하는 퍼포먼스 데이터:

필드	타입	단위
fps	float	frames/sec
frame_time	float	ms
gpu_time	float	ms
memory_used	int64	bytes
position	vec3	world units

커스텀 이벤트

개발자가 정의하는 게임 고유의 이벤트입니다. properties 필드에 임의의 JSON 객체를 저장할 수 있습니다.

세션

게임의 시작부터 종료까지를 하나의 세션으로 관리합니다. 세션에는 다음의 메타데이터가 포함됩니다:

• 디바이스 정보 (OS, GPU, RAM)
• 빌드 정보 (버전, 프로필)
• 플레이어 정보 (선택사항)

다음 단계

• API 레퍼런스 — REST API로 데이터에 접근
• 히트맵 — 위치 데이터의 시각화