Skip to main content

에러 코드 목록

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 상태 코드도 함께 반환합니다.
HTTP 200이라도 응답 본문의 code 값을 반드시 확인하세요. 비즈니스 로직 에러는 응답 본문에 포함됩니다.

관련 문서

REST API 개요

API 기본 사용법

타겟팅 설정

타겟팅 파라미터 설정