빠른 시작
이 가이드에서는 Framedash 무료 계정을 생성하고, SDK를 통합하여 첫 퍼포먼스 데이터를 전송하기까지의 절차를 설명합니다.
1. 계정 생성
섹션 제목: “1. 계정 생성”- Framedash 가입 페이지에 접속
- 이메일 주소로 가입, 또는 Google / GitHub / Microsoft로 계속
- 약관에 동의하여 계정 생성 완료
2. 프로젝트 및 API 키 생성
섹션 제목: “2. 프로젝트 및 API 키 생성”대시보드에 로그인 후:
- “새 프로젝트” 클릭
- 프로젝트 이름을 입력하고 프로젝트 생성
- 생성한 프로젝트를 열고 “API 키”로 이동
- Ingest 프리셋의
fd_API 키를 생성한 뒤 다이얼로그를 닫기 전에 복사
Ingest 키는 이벤트 전송만 가능합니다. 나중에 CLI나 REST의 원시 SQL 쿼리로 취합을 확인하려면 별도의 Full 키가 필요합니다(원시 SQL에는 data:admin 스코프가 필요합니다. 5단계에서 다룹니다).
3. SDK 통합
섹션 제목: “3. SDK 통합”사용하는 엔진에 따라 SDK를 통합합니다:
4. 데이터 전송
섹션 제목: “4. 데이터 전송”SDK를 설정한 후 게임을 실행하면 퍼포먼스 데이터가 자동으로 Framedash에 전송됩니다.
CI나 헤드리스 빌드에서 실행하는 경우, 사용하는 엔진의 “헤드리스 / CI” 섹션을 참고하세요: Unity, UE5, Godot.
5. 히트맵 확인
섹션 제목: “5. 히트맵 확인”프로젝트의 “맵” 페이지를 열고 맵을 업로드하거나 데모 데이터를 생성합니다. 맵을 연 뒤 히트맵 모드로 전환하면 맵 위에 퍼포먼스 데이터가 오버레이 표시됩니다.
대시보드 없이 취합을 확인하려면 CLI나 REST 쿼리 엔드포인트에서 데이터를 쿼리하세요. 원시 SQL 쿼리에는 data:admin 스코프가 필요하므로 Full API 키를 사용하세요. Read-only 키는 403이 반환됩니다.
다음 단계
섹션 제목: “다음 단계” AI 에이전트용: llms.txt