에러 처리
광고 로드에 실패하거나 디스플레이에 실패하면 광고 표시 delegate 또는 콜백 인터페이스가 호출을 받습니다. 이 호출에는 에러 코드가 함께 제공됩니다. 이 페이지에서는 이러한 에러 코드에 대해 설명합니다.
Error 객체
콜백에서 수신하는 에러는 MaxError를 구현하는 일급 에러 객체입니다.
이 객체는 다음과 같은 메서드를 가집니다.
getCode()- 아래 표에서 확인할 수 있는 에러 코드를 반환합니다.
getMessage()- 에러를 설명하는 사람이 읽을 수 있는 메시지를 반환합니다.
getMediatedNetworkErrorCode()- 에러에 대한 mediated network의 에러 코드를 반환합니다. 이 메서드는 광고 표시 실패 콜백에서 반환된 에러에 대해서만 사용할 수 있습니다.
getMediatedNetworkErrorMessage()- 에러에 대한 mediated network의 에러 메시지를 반환합니다. 기본값은 빈 문자열입니다. 이 메서드는 광고 표시 실패 콜백에서 반환된 에러에 대해서만 사용할 수 있습니다.
getWaterfall()- 광고의 현재 waterfall에 대한 정보를 볼 수 있도록 합니다. 네트워크 응답은 waterfall에 있는 각 광고의 광고 로드 상태, 지연 시간, 자격 증명 및 mediated network 정보를 제공합니다. waterfall의 광고가 로드에 실패하면 네트워크 응답이 에러 정보를 제공합니다. 이 메서드에 대한 자세한 내용은 Advanced settings: Waterfall information API에서 확인할 수 있습니다.
MAX 에러 코드
| 코드 | 상수 | 설명 | 로드(Load) / 표시(Display) |
|---|---|---|---|
| 204 | MaxErrorCode.NO_FILL | 기기에 적합한 광고가 없습니다 (no fill). MAX가 이 앱/기기에 대해 mediated network로부터 적합한 광고를 반환받지 못했습니다. | L |
| −1 | MaxErrorCode.UNSPECIFIED | 시스템이 예기치 않은 상태에 있습니다. MAX가 이 상태를 정의된 다른 에러 중 하나로 분류할 수 없습니다. 자세한 내용은 에러 객체의 메시지 필드를 참조하십시오. | L/D |
| −23 | MaxErrorCode.FULLSCREEN_AD_ALREADY_SHOWING | 다른 풀스크린 광고가 여전히 표시되고 있는 동안 풀스크린 광고(interstitial 또는 rewarded)를 표시하려고 시도했습니다. | D |
| −24 | MaxErrorCode.FULLSCREEN_AD_NOT_READY | 풀스크린 광고가 로드되기 전에 표시하려고 시도했습니다. | D |
| −1000 | MaxErrorCode.NETWORK_ERROR | 일반적인 네트워크 에러로 인해 광고 요청에 실패했습니다. 자세한 내용은 에러 객체의 메시지 필드를 참조하십시오. | L |
| −1001 | MaxErrorCode.NETWORK_TIMEOUT | 느린 인터넷 연결로 인해 광고 요청 시간이 초과되었습니다. | L |
| −1009 | MaxErrorCode.NO_NETWORK | 기기가 인터넷에 연결되어 있지 않아 광고 요청에 실패했습니다. | L |
| −4205 | MaxErrorCode.AD_DISPLAY_FAILED | 광고를 표시하는 동안 에러가 발생했습니다. 자세한 내용은 에러 객체의 메시지 필드를 참조하십시오. | D |
| −5001 | MaxErrorCode.AD_LOAD_FAILED | fill할 수 있는 네트워크가 없어 광고 로드에 실패했습니다. MAX가 mediated network로부터 적합한 광고를 반환받았으나, 모든 광고의 로드에 실패했습니다. 자세한 내용은 MaxError.getWaterfall()을 확인하십시오. | L |
| −5201 | MaxErrorCode.ERROR_CODE_INVALID_LOAD_STATE | SDK의 내부 상태가 유효하지 않습니다. | L |
| −5205 | MaxAdapterError.AD_NOT_READY | 표시를 시도할 때 adapter에 준비된 광고가 없었습니다. | L/D |
| −5209 | MaxAdapterError.INTERNAL_ERROR | 지정되지 않은 내부 에러입니다. | L |
| −5601 | MaxErrorCode.NO_ACTIVITY | 최상위 Activity를 찾을 수 없어 SDK가 광고 로드에 실패했습니다. | L |
| −5602 | MaxErrorCode.DONT_KEEP_ACTIVITIES_ENABLED | 사용자가 개발자 설정에서 "활동 보존 안 함(Don’t Keep Activities)"을 활성화하여 SDK가 광고 표시에 실패했습니다. | D |
| −5603 | MaxErrorCode.INVALID_AD_UNIT_ID | 퍼블리셔가 유효하지 않은 광고 단위 식별자를 제공하여 SDK가 광고 로드에 실패했습니다. 가능한 원인:
| L |
다양한 네트워크의 에러 코드
광고 네트워크가 반환하는 에러 코드를 더 잘 이해하려면 해당 네트워크에서 게시한 에러 문서 페이지를 참조하십시오.
