메인 콘텐츠로 건너뛰기

에러 코드 목록


에러별 상세 설명

ERROR_CODE_INVALID_UNIT (4000)

원인: 존재하지 않거나 비활성화된 광고 유닛 ID로 요청했습니다. 해결 방법:
  • 콘솔에서 광고 유닛 ID가 정확한지 확인
  • 광고 유닛이 활성화 상태인지 확인
  • 복사/붙여넣기 시 공백이나 특수문자가 포함되지 않았는지 확인

ERROR_CODE_AD_INACTIVE (4001)

원인: 해당 광고 유닛에 활성화된 광고 캠페인이 없습니다. 해결 방법:
  • 콘솔에서 캠페인이 실행 중인지 확인
  • 캠페인 일정(시작일/종료일)을 확인
  • 캠페인 예산이 소진되지 않았는지 확인

ERROR_CODE_AD_NO_FILL (4002)

원인: 타겟팅 조건에 맞는 광고를 찾을 수 없습니다. 해결 방법:
  • 타겟팅 설정이 너무 제한적이지 않은지 확인
  • 재시도 로직 구현 (지수 백오프 권장)
  • 대체 콘텐츠(폴백) 준비
재시도 구현 예시:

ERROR_CODE_INVALID_PARAMS (4003)

원인: 요청 파라미터가 잘못되었습니다. 해결 방법:
  • 필수 파라미터(unit)가 포함되었는지 확인
  • 파라미터 값의 형식이 올바른지 확인
  • 파라미터 이름에 오타가 없는지 확인
파라미터 체크리스트:

에러 처리 모범 사례

1. 에러 코드 기반 분기 처리

2. 폴백 콘텐츠 준비

3. 모니터링 및 로깅


HTTP 상태 코드

REST API는 표준 HTTP 상태 코드도 함께 반환합니다.
HTTP 200이라도 응답 본문의 code 값을 반드시 확인하세요. 비즈니스 로직 에러는 응답 본문에 포함됩니다.

관련 문서

REST API 개요

API 기본 사용법

타겟팅 설정

타겟팅 파라미터 설정