에러 처리
광고 로드에 실패하거나 표시하는 데 실패하면 광고 표시 delegate 또는 콜백 인터페이스가 호출을 받습니다. 이 호출에는 에러 코드가 함께 제공됩니다. 이 페이지에서는 이러한 에러 코드에 대해 설명합니다.
Error 객체
콜백에서 수신하는 에러는 ErrorInfo를 구현하는 일급 에러 객체입니다.
이 객체는 다음과 같은 API를 가집니다.
Code- 에러 코드로, 아래 표에서 확인할 수 있습니다.
Message- 에러를 설명하는 사람이 읽을 수 있는 메시지입니다.
MediatedNetworkErrorCode- 에러에 대한 mediated network의 에러 코드입니다. 광고 표시 실패 콜백에서 반환된 에러에 대해서만 제공됩니다.
MediatedNetworkErrorMessage- 에러에 대한 mediated network의 에러 메시지를 반환합니다. 기본값은 빈 문자열입니다. 광고 표시 실패 콜백에서 반환된 에러에 대해서만 제공됩니다.
WaterfallInfo- 로드되거나 로드에 실패한 광고의 현재 waterfall에 대한 정보를 볼 수 있도록 합니다. 네트워크 응답은 waterfall에 있는 각 광고의 광고 로드 상태, 지연 시간, 자격 증명 및 mediated network 정보를 제공합니다. waterfall의 광고가 로드에 실패하면 네트워크 응답이 에러 정보를 제공합니다. 이 메서드에 대한 자세한 내용은 Advanced settings: Waterfall information API에서 확인할 수 있습니다.
MAX 에러 코드
| 코드 | MaxSdk.ErrorCode 상수 | 설명 | Load / Display |
|---|---|---|---|
| −1 | .Unspecified | 시스템이 예기치 않은 상태에 있습니다. 이 에러 코드는 MAX가 정의된 다른 에러 중 하나로 분류할 수 없는 에러를 나타냅니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오. | L/D |
| 204 | .NoFill | 기기에 적합한 광고가 없습니다 (no fill). MAX가 이 앱/기기에 대해 mediated network로부터 적합한 광고를 반환받지 못했습니다. | L |
| −5001 | .AdLoadFailed | 광고를 채울 수 있는 네트워크가 없어 로드에 실패했습니다. MAX가 mediated network로부터 적합한 광고를 반환받았으나, 모든 광고가 로드에 실패했습니다. 자세한 내용은 ErrorInfo.WaterfallInfo를 확인하십시오. | L |
| −1000 | .NetworkError | 일반적인 네트워크 에러로 인해 광고 요청에 실패했습니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오. | L |
| −1001 | .NetworkTimeout | 느린 인터넷 연결로 인해 광고 요청 시간이 초과되었습니다. | L |
| −1009 | .NoNetwork | 기기가 인터넷에 연결되어 있지 않아 광고 요청에 실패했습니다. | L |
| −23 | .FullscreenAdAlreadyShowing | 다른 풀스크린 광고가 여전히 표시되고 있는 동안 풀스크린 광고(interstitial 또는 rewarded)를 표시하려고 시도하고 있습니다. | D |
| −24 | .FullscreenAdNotReady | 풀스크린 광고가 로드되기 전에 표시하려고 시도하고 있습니다. | D |
| −25 | .FullscreenAdInvalidViewController | 잘못된 view controller에서 풀스크린 광고를 표시하려고 시도했습니다. (iOS 전용) | D |
| −26 | .FullscreenAdAlreadyLoading | 다른 풀스크린 광고가 이미 로드 중인 동안 풀스크린 광고를 로드하려고 시도하고 있습니다. | L |
| −27 | .FullscreenAdLoadWhileShowing | 다른 풀스크린 광고가 여전히 표시되고 있는 동안 풀스크린 광고를 로드하려고 시도하고 있습니다. | L |
| −4205 | .AdDisplayFailed | 광고를 표시하는 동안 에러가 발생했습니다. 자세한 내용은 에러 객체의 message 필드를 참조하십시오. | D |
| −5601 | .NoActivity | SDK가 최상위 Activity를 찾을 수 없어 광고 로드에 실패했습니다. | L |
| −5602 | .DontKeepActivitiesEnabled | 사용자가 개발자 설정에서 "활동 보존 안함(Don’t Keep Activities)"을 활성화했기 때문에 SDK가 광고를 표시하는 데 실패했습니다. | D |
| −5603 | .InvalidAdUnitID | 퍼블리셔가 잘못된 ad unit 식별자를 제공하여 SDK가 광고 로드에 실패했습니다. 잘못된 ad unit 식별자의 가능한 원인:
| L |
다양한 네트워크의 에러 코드
광고 네트워크가 반환하는 에러 코드를 더 잘 이해하려면 해당 네트워크에서 게시한 에러 문서 페이지를 참조하십시오.
- BidMachine (Android) & BidMachine (iOS)
- BIGO Ads (Android) & BIGO Ads (iOS)
- CSJ
- DT Exchange
- Google Bidding and Google AdMob (Android) & Google Bidding and Google AdMob (iOS)
- ironSource (Android) & ironSource (iOS)
- Liftoff Monetize
- Line (Android) & Line (iOS)
- Maio (Android) & Maio (iOS)
- Meta Audience Network
- Mintegral
- MobileFuse
- Pangle
- Tencent (Android) & Tencent (iOS)
- YSO Network (Android) & YSO Network (iOS)
