Godot용 게임 분석
프롬프트 한 번으로 설정하는 Godot 게임 분석
Ziva에게 게임에 분석 기능을 추가해 달라고 요청하세요. Ziva가 작은 GDScript SDK를 설치하고, 알고 싶은 이벤트의 추적 코드를 추가하고, ziva.sh의 실시간 대시보드로 이벤트를 보냅니다. 서버를 만들 필요도, 키를 복사할 필요도 없습니다.
작동 방식
프롬프트에서 실시간 대시보드까지
보통 분석 기능을 넣으려면 서비스를 고르고, 프로젝트를 만들고, 키를 복사하고, SDK를 연결해야 합니다. Ziva는 이 단계를 Godot 에디터 안에서 대신 처리합니다.
- 01
Ziva에게 요청
알고 싶은 내용을 말하세요. 예: "내 게임에 분석 기능을 추가해 줘. 플레이어가 코인을 모으거나 첫 레벨을 클리어할 때 추적해 줘."
- 02
Ziva가 SDK 설치
Ziva 계정에 분석 프로젝트를 만들고, ZivaAnalytics 오토로드를 추가하고, 설정을 project.godot에 저장합니다. 그다음 이벤트 추적 호출을 추가합니다.
- 03
플레이하고 확인
게임을 실행한 뒤 Ziva에게 분석을 확인해 달라고("check analytics") 요청하면 이벤트가 도착했는지 확인합니다. 이벤트는 보통 5-15초 후 대시보드에 표시됩니다.
ZivaAnalytics.track("level_complete", {"level": 3, "time_s": 41.2})
ZivaAnalytics.identify("Bobby")대시보드
누가 플레이하고 무엇을 하는지 확인
Ziva의 Settings → Pro Features → Game Analytics 또는 ziva.sh의 Account → Analytics에서 열 수 있습니다.
지금 플레이 중인 플레이어
최근 2분간의 활성 세션, 오늘의 일일 활성 플레이어, 선택한 기간의 순 플레이어 수를 보여 줍니다.
시간별 활동
최근 1시간, 24시간, 7일, 30일의 이벤트 수와 최근 30일간의 일일 활성 플레이어를 보여 줍니다.
상위 이벤트
선택한 기간에 가장 많이 발생한 이벤트를 보여 주므로 각 레벨이 얼마나 자주 시작되고 클리어되는지 비교할 수 있습니다.
실시간 피드
최신 이벤트를 몇 초마다 새로 고쳐 보여 주며, 이벤트 이름, 플레이어 이름, 이벤트 세부 정보로 검색할 수 있습니다.
플레이어 조회
이름이나 ID로 플레이어를 찾아 그 플레이어의 이벤트를 따라가 보세요. 이름은 게임이 보내는 경우에만 표시됩니다.
테스트 실행 제외
출처로 필터링하면 직접 실행한 에디터 실행이나 Ziva의 테스트 실행 없이 내보낸 빌드만 볼 수 있으므로 테스트가 수치를 왜곡하지 않습니다.
자동 추적
이벤트를 하나도 추가하기 전부터 유용한 데이터
SDK를 설치하면 추가 코드 없이 다음 이벤트를 기록합니다:
- session_start
- 게임이 시작될 때, Godot 버전과 로캘과 함께 기록합니다.
- scene_changed
- 현재 씬이 바뀔 때, 씬 이름과 함께 기록합니다.
- heartbeat
- 60초마다, 지금까지의 플레이 시간과 함께 기록합니다.
- session_end
- 창을 닫을 때, 전체 플레이 시간과 함께 가능한 경우 기록합니다.
모든 이벤트에는 세션 ID, 무작위 플레이어 ID, 플랫폼, 그리고 설정된 경우 게임 버전도 포함됩니다.
분석 기능은 에디터, Ziva 플레이테스트, 웹 빌드를 포함한 내보낸 게임에서 작동합니다. SDK는 이벤트를 백그라운드에서 보내므로 게임을 멈추지 않습니다. 서버가 이벤트를 거부하면 게임을 중단하는 대신 해당 세션의 분석 기능만 꺼집니다.
다른 도구와 비교
독립형 분석 플러그인보다 적은 설정
전문 분석 서비스는 더 깊이 있는 리포트를 제공합니다. Ziva Analytics는 파이프라인을 직접 만들지 않고 답을 얻고 싶은 Godot 개발자를 위한 도구입니다.
| 기능 | 독립형 분석 플러그인 | Ziva Analytics |
|---|---|---|
| 프로젝트와 키 자동 생성 | 가입 후 키 복사 | 프롬프트 한 번 |
| 이벤트 추적 코드 작성 | 호출을 직접 작성 | 평소 말로 요청 |
| 이벤트 도착 확인 | 대시보드를 열어 직접 확인 | Ziva에게 확인 요청 |
| 테스트 실행과 내보낸 빌드 구분 | 서비스마다 다름 | 에디터, 에이전트, 플레이어 출처 |
| 퍼널, 코호트, 리텐션 리포트 | 포함된 경우가 많음 | 실시간 피드, 일일 플레이어, 상위 이벤트 |
| 무료 요금제 | 제공되는 경우가 많음 | Pro 필요 |
개인정보와 제한 사항
전송되는 데이터
- 분석 기능은 이벤트, 기본 게임 정보, 무작위 플레이어 ID, 그리고 게임이 보내는 이벤트 세부 정보나 플레이어 이름을 전송합니다.
- SDK는 하드웨어 식별자, IP 기반 위치 정보, 파일 경로를 읽지 않습니다. 게임의 개인정보 처리방침에서 다루지 않는 한 개인정보를 포함하지 마세요.
- 프로젝트에 저장되는 키는 내 프로젝트에 이벤트를 추가하는 용도로만 쓸 수 있습니다. 아무것도 읽을 수 없으므로 내보낸 빌드에 포함해도 안전합니다.
- 원본 이벤트는 90일간 보관됩니다.