콘텐츠로 이동

빠른 시작

이 가이드에서는 Framedash 무료 계정을 생성하고, SDK를 통합하여 첫 퍼포먼스 데이터를 전송하기까지의 절차를 설명합니다.

  1. Framedash 가입 페이지에 접속
  2. 이메일 주소로 가입, 또는 Google / GitHub / Microsoft로 계속
  3. 약관에 동의하여 계정 생성 완료

대시보드에 로그인 후:

  1. “새 프로젝트” 클릭
  2. 프로젝트 이름을 입력하고 프로젝트 생성
  3. 생성한 프로젝트를 열고 “API 키”로 이동
  4. Ingest 프리셋의 fd_ API 키를 생성한 뒤 다이얼로그를 닫기 전에 복사

Ingest 키는 이벤트 전송만 가능합니다. 나중에 CLI나 REST의 원시 SQL 쿼리로 취합을 확인하려면 별도의 Full 키가 필요합니다(원시 SQL에는 data:admin 스코프가 필요합니다. 5단계에서 다룹니다).

사용하는 엔진에 따라 SDK를 통합합니다:

SDK를 설정한 후 게임을 실행하면 퍼포먼스 데이터가 자동으로 Framedash에 전송됩니다.

CI나 헤드리스 빌드에서 실행하는 경우, 사용하는 엔진의 “헤드리스 / CI” 섹션을 참고하세요: Unity, UE5, Godot.

프로젝트의 “맵” 페이지를 열고 맵을 업로드하거나 데모 데이터를 생성합니다. 맵을 연 뒤 히트맵 모드로 전환하면 맵 위에 퍼포먼스 데이터가 오버레이 표시됩니다.

대시보드 없이 취합을 확인하려면 CLIREST 쿼리 엔드포인트에서 데이터를 쿼리하세요. 원시 SQL 쿼리에는 data:admin 스코프가 필요하므로 Full API 키를 사용하세요. Read-only 키는 403이 반환됩니다.