에러 처리

광고 로드에 실패하거나 표시하는 데 실패하면 광고 표시 delegate 또는 콜백 인터페이스가 호출을 받습니다. 이 호출에는 에러 코드가 함께 제공됩니다. 이 페이지에서는 이러한 에러 코드에 대해 설명합니다.

에러 객체

콜백에서 수신하는 에러는 일급 에러 객체인 AdError입니다. 이 객체는 세 가지 프로퍼티를 가집니다:

Code
에러 코드로, 아래 표에서 확인할 수 있습니다.
Message
에러를 설명하는 사람이 읽을 수 있는 메시지입니다.
AdLoadFailureInfo
존재하는 경우, 각 미디에이션 네트워크가 광고를 로드하는 데 실패한 에러 코드와 이유를 포함하는 설명 문자열입니다.

MAX 에러 코드

코드설명Load / Display
204기기에 적합한 광고가 없습니다 (no fill). MAX가 이 앱/기기에 대해 어떤 미디에이션 네트워크로부터도 적합한 광고를 반환받지 못했습니다.L
−1시스템이 예기치 않은 상태에 있습니다. 이 에러 코드는 MAX가 정의된 다른 에러 중 하나로 분류할 수 없는 에러를 나타냅니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오.L/D
−23다른 풀스크린 광고가 여전히 표시되고 있는 동안 풀스크린 광고(interstitial 또는 rewarded)를 표시하려고 시도했습니다.D
−24풀스크린 광고가 로드되기 전에 표시하려고 시도했습니다.D
−25잘못된 뷰 컨트롤러에서 풀스크린 광고를 표시하려고 시도했습니다. (iOS 전용)D
−1000일반적인 네트워크 에러로 인해 광고 요청에 실패했습니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오.L
−1001느린 인터넷 연결로 인해 광고 요청 시간이 초과되었습니다.L
−1009기기가 인터넷에 연결되어 있지 않아 광고 요청에 실패했습니다.L
−4205광고를 표시하는 동안 에러가 발생했습니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오.D
−5001fill할 수 있는 네트워크가 없어 광고 로드에 실패했습니다. MAX가 미디에이션 네트워크로부터 적합한 광고를 반환받았으나, 모든 광고가 로드에 실패했습니다.L
−5201SDK의 내부 상태가 유효하지 않습니다.L
−5205표시를 시도할 때 어댑터에 준비된 광고가 없었습니다.L
−5209지정되지 않은 내부 에러입니다.L
−5601최상위 Activity를 찾을 수 없어 SDK가 광고를 로드하는 데 실패했습니다. (Android 전용)L
−5602사용자가 개발자 설정에서 "활동 보존 안 함(Don’t Keep Activities)"을 활성화했기 때문에 SDK가 광고를 표시하는 데 실패했습니다. (Android 전용)D
−5603퍼블리셔가 잘못된 광고 단위 식별자를 제공하여 SDK가 광고를 로드하는 데 실패했습니다. 잘못된 광고 단위 식별자의 가능한 원인:
  • 광고 단위 식별자의 형식이 잘못되었거나 존재하지 않음
  • 광고 단위가 비활성화됨
  • 광고 단위가 현재 앱의 패키지 이름과 연결되어 있지 않음
  • 광고 단위가 최근 30~60분 이내에 생성됨
L

다양한 네트워크의 에러 코드

광고 네트워크가 반환하는 에러 코드를 더 잘 이해하려면 해당 네트워크에서 게시한 에러 문서 페이지를 참조하십시오:

프라이버시 매니페스트
SKAdNetwork
© 2026 AppLovin. All rights reserved.
운영정책이용약관퍼블리셔 정책디맨드 파트너 정책플랫폼 규제프라이버시Your Privacy ChoicesCPRA쿠키설정
search