---
url: https://developers.webzenk.kr/guide/metrics.md
---
# 지표·이벤트

## 자동으로 집계되는 지표

게임이 따로 보내지 않아도 서버가 집계해요.

| 지표 | 기준 |
|---|---|
| DAU | 그날 로그인 또는 API 호출이 있었던 유저 |
| 신규 | 그날 가입한 유저 |
| 결제·결제자 | 검증일 기준, 테스트 결제 제외 |
| 매출 | **통화별로 따로** (환산 안 함). Google Play는 앱이 보낸 표시 가격 기준 |
| 광고 | 보상 확정 건수와 시청 유저 수 |
| 리텐션 | 가입일 코호트의 D1·D3·D7·D14·D30 재접속률 |

날짜는 게임 시간대 기준이고, 매시간 오늘·어제를 다시 계산하므로 최대 1시간 늦어요.
조회는 [개발사 서버 API](/api/server)로 해요.

## 커스텀 이벤트

게임 고유의 행동(스테이지 클리어, 튜토리얼 완료 등)은 **이벤트**로 보내면 이름별로 건수·유저 수가 집계돼요.

| 항목 | 규칙 |
|---|---|
| 이름 | 소문자로 시작하는 `[a-z0-9_]` 64자 — 예: `stage_clear`, `tutorial_done` |
| 속성 (props) | 4KB 이내 객체 |
| 한도 | 요청당 100건, 유저당 하루 5,000건 |
| 원본 보관 | 90일 (집계 결과는 계속 남아요) |

SDK는 이벤트를 모아서 보내고, 오프라인이면 기기에 보관했다가 다시 보내요.

**관련 문서** · [이벤트 API](/api/events) · [개발사 서버 API](/api/server)
