에러 코드 목록
REST 광고 요청(/request)은 응답 본문의 code 필드에 아래 코드 중 하나를 반환합니다.
인증에 실패하면 HTTP
401을 반환합니다. HTTP 상태 코드를 참고하세요.
msg필드에는 사람이 읽는 문구가 아니라 위 표의 상수명이 그대로 들어갑니다. 에러 처리는code값을 기준으로 분기하세요.- REST 광고 요청은
4000(ERROR_CODE_INVALID_UNIT)과4001(ERROR_CODE_AD_INACTIVE)을 반환하지 않습니다. 잘못된 광고 유닛 ID나 활성화된 캠페인이 없는 광고 유닛도4002로 응답합니다.
에러별 상세 설명
ERROR_CODE_AD_NO_FILL (4002)
원인: 요청에 노출할 수 있는 광고가 없습니다. 대표적인 원인은 다음과 같습니다.- 광고 유닛 ID가 잘못되었거나, App Key와 다른 앱의 광고 유닛 ID로 요청한 경우
- 배너·네이티브가 아닌 광고 유닛으로 요청한 경우
- 해당 광고 유닛에 활성화된 광고 캠페인이 없는 경우
- 요청이 캠페인의 타겟팅 조건(문맥 타겟팅의
contextId포함)과 맞지 않는 경우
- 광고 유닛 ID가 정확하고 App Key와 같은 앱의 광고 유닛인지, 복사/붙여넣기 시 공백이나 특수문자가 포함되지 않았는지 확인
- 배너 또는 네이티브 광고 유닛인지 확인
- 콘솔에서 캠페인이 실행 중인지, 캠페인 일정(시작일/종료일)과 예산 소진 여부 확인
contextId가 콘솔에 입력한 Context ID와 정확히 일치하는지 확인- 타겟팅 설정이 너무 제한적이지 않은지 확인
- 재시도 로직 구현 (지수 백오프 권장)
- 대체 콘텐츠(폴백) 준비
ERROR_CODE_INVALID_PARAMS (4003)
원인: 필수 파라미터(unit)가 없거나 값이 비어 있습니다.
해결 방법:
- 필수 파라미터(
unit)가 포함되어 있고 값이 비어 있지 않은지 확인 - 파라미터 이름에 오타가 없는지 확인
에러 처리 모범 사례
1. 에러 코드 기반 분기 처리
2. 폴백 콘텐츠 준비
3. 모니터링 및 로깅
HTTP 상태 코드
REST API는 표준 HTTP 상태 코드도 함께 반환합니다.관련 문서
REST API 개요
API 기본 사용법
타겟팅 설정
타겟팅 파라미터 설정