플레이타임 세션 기록
Playtime
플레이타임 세션 기록
단일 플레이타임 세션을 기록합니다.
자동 귀속:
campaignId미지정 시 프로젝트의 활성 캠페인 스폰서로 자동 귀속
멱등성:
- 고유 키는
projectId+sessionId입니다 - 중복
sessionId는 에러가 아닙니다: 기존 row가 유지되며 응답의recorded값이false로 반환됩니다
POST
플레이타임 세션 기록
인증
Server API Key (format: {keyId}:{secret})
본문
application/json
클라이언트에서 생성한 고유 세션 ID
사용자 ID
세션 지속 시간 (초)
필수 범위:
x >= 1세션 시작 시각 (ISO 8601 UTC 형식)
- 형식:
YYYY-MM-DDTHH:mm:ss.sssZ - 예시:
2024-01-15T10:30:00.000Z
세션 종료 시각 (ISO 8601 UTC 형식, startedAt 이상이어야 함)
- 형식:
YYYY-MM-DDTHH:mm:ss.sssZ - 예시:
2024-01-15T11:00:00.000Z
캠페인 ID (선택). 미지정 시 프로젝트의 활성 캠페인 스폰서로 자동 귀속
크리에이터 키 (선택, 정확히 5자리 대문자 영숫자)
Pattern:
^[A-Z0-9]{5}$플레이타임 플랫폼 (선택, 미지정 시 서버에서 Other로 기본 설정)
사용 가능한 옵션:
iOS, Android, Web, Roblox, Other 임의의 키/값 메타데이터
웹훅 추적용 ID (이 요청으로 발생하는 웹훅 이벤트에 포함됨)
테스트 모드 (실제 데이터 생성 안 함)
응답
성공
기록된 플레이타임 세션