에러 코드 목록
에러별 상세 설명
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 상태 코드도 함께 반환합니다.관련 문서
REST API 개요
API 기본 사용법
타겟팅 설정
타겟팅 파라미터 설정