에러 처리
광고 로드에 실패하거나 표시하는 데 실패하면 광고 표시 위임(delegate) 또는 콜백 인터페이스가 호출을 받습니다. 이 호출에는 에러 코드가 함께 제공됩니다. 이 페이지에서는 이러한 에러 코드에 대해 설명합니다.
Error 객체
콜백에서 수신하는 에러는 MAError를 구현하는 일급 에러 객체입니다.
이 객체는 다음과 같은 API를 가집니다.
code- 에러 코드로, 아래 표에서 확인할 수 있습니다.
message- 에러를 설명하는 사람이 읽을 수 있는 메시지입니다.
mediatedNetworkErrorCode- 에러에 대한 mediated network의 에러 코드입니다. 광고 표시 실패 콜백에서 반환되는 에러에 대해서만 제공됩니다.
mediatedNetworkErrorMessage- 에러에 대한 mediated network의 에러 메시지를 반환합니다. 기본값은 빈 문자열입니다. 광고 표시 실패 콜백에서 반환되는 에러에 대해서만 제공됩니다.
getWaterfall()- 광고가 로드되거나 로드에 실패한 현재 waterfall에 대한 정보를 볼 수 있도록 합니다. 네트워크 응답은 waterfall에 있는 각 광고의 광고 로드 상태, 지연 시간, 자격 증명 및 mediated network 정보를 제공합니다. waterfall의 광고가 로드에 실패하면 네트워크 응답이 에러 정보를 제공합니다. 이 메서드에 대한 자세한 내용은 Advanced settings: Waterfall information API에서 확인할 수 있습니다.
MAX 에러 코드
| 코드 | 상수 | 설명 | Load / Display |
|---|---|---|---|
| −1 | MAErrorCodeUnspecified | 시스템이 예상치 못한 상태에 있습니다. 이 에러 코드는 MAX가 정의된 다른 에러 중 하나로 분류할 수 없는 에러를 나타냅니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오. | L/D |
| 204 | MAErrorCodeNoFill | 기기에 적합한 광고가 없습니다 (no fill). MAX가 이 앱/기기에 대해 mediated network로부터 적합한 광고를 반환받지 못했습니다. | L |
| −5001 | MAErrorCodeAdLoadFailed | 광고를 채울 수 있는 네트워크가 없어 로드에 실패했습니다. MAX가 mediated network로부터 적합한 광고를 반환받았으나, 모든 광고가 로드에 실패했습니다. 자세한 내용은 -[MAError waterfall]을 검사하십시오. | L |
| −1000 | MAErrorCodeNetworkError | 일반적인 네트워크 에러로 인해 광고 요청에 실패했습니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오. | L |
| −1001 | MAErrorCodeNetworkTimeout | 느린 인터넷 연결로 인해 광고 요청 시간이 초과되었습니다. | L |
| −1009 | MAErrorCodeNoNetwork | 기기가 인터넷에 연결되어 있지 않아 광고 요청에 실패했습니다. | L |
| −23 | MAErrorCodeFullscreenAdAlreadyShowing | 다른 전면 광고가 여전히 표시되고 있는 동안 전면 광고(interstitial 또는 rewarded)를 표시하려고 시도했습니다. | D |
| −24 | MAErrorCodeFullscreenAdNotReady | 전면 광고가 로드되기 전에 표시하려고 시도했습니다. | D |
| −25 | MAErrorCodeFullscreenAdInvalidViewController | 유효하지 않은 뷰 컨트롤러에서 전면 광고를 표시하려고 시도했습니다. | D |
| −4205 | MAErrorCodeAdDisplayFailed | 광고를 표시하는 동안 에러가 발생했습니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오. | D |
| −5201 | MAAdapterError.invalidLoadState | SDK의 내부 상태가 유효하지 않습니다. | L |
| −5205 | MAAdapterError.adNotReady | 표시를 시도할 때 어댑터에 준비된 광고가 없었습니다. | L |
| −5209 | MAAdapterError.internalError | 지정되지 않은 내부 에러입니다. | L |
| −5603 | MAErrorCodeInvalidAdUnitIdentifier | 퍼블리셔가 유효하지 않은 ad unit identifier를 제공하여 SDK가 광고를 로드하는 데 실패했습니다. 유효하지 않은 ad unit identifier의 가능한 원인:
| L |
다양한 네트워크의 에러 코드
광고 네트워크가 반환하는 에러 코드를 더 잘 이해하려면 해당 네트워크에서 게시한 에러 문서 페이지를 참조하십시오.
