Skip to content

이벤트 ​

경로인증설명
POST/v1/events유저이벤트 전송 (최대 100건)
json
{
  "platform": "android",
  "app_version": "1.2.0",
  "events": [
    { "name": "stage_clear", "ts": 1795055466123, "props": { "stage": 12 } },
    { "name": "tutorial_done" }
  ]
}
필드규칙
platform선택. 소문자 2~16자 (android, ios, web, samsung …)
app_version선택. 32자 이내
events[].name소문자로 시작하는 [a-z0-9_] 64자
events[].ts선택. epoch 초 또는 밀리초. 생략하거나 7일보다 오래됐거나 미래면 받은 시각
events[].props선택. 4KB 이내 객체
  • 하나라도 형식이 틀리면 전체가 400이에요(일부만 저장되지 않아요). 오프라인 큐에서 그대로 재전송하면 돼요.
  • 유저당 하루 5,000건을 넘으면 429 EVENT_QUOTA_EXCEEDED예요.
  • 집계 결과는 개발사 서버 API의 /v1/server/metrics/events로 조회해요.

© WEBZEN K. All rights reserved.