Error Handling

Your ad display delegate or callback interface will receive a call if an ad failed to load or failed to display. This call will be accompanied by an error code. This page describes the error codes you may see.

Error Object and MAX Error Codes

Error Object

The error that you receive in your callback is a first-class error object that implements MaxError. This object has the following methods:

getCode()
Returns the error code, which you can find in the table below.
getMessage()
Returns a human-readable message that describes the error.
getMediatedNetworkErrorCode()
Returns the mediated network’s error code for the error. Available for errors returned in ad display failure callbacks only.
getMediatedNetworkErrorMessage()
Returns the mediated network’s error message for the error. Defaults to an empty string. Available for errors returned in ad display failure callbacks only.
getWaterfall()
Allows you to see the information about the current waterfall for an ad that has loaded or failed to load. The network responses provide the ad load state, latency, credentials, and mediated network information for each ad in the waterfall. If an ad in the waterfall fails to load, the network response provides error information. You can find out more about this method in Advanced Settings: Waterfall Information API.

MAX Error Codes

Code Constant Description Load / Display
−1 MaxErrorCode.UNSPECIFIED The system is in an unexpected state. This error code represents an error that could not be categorized into one of the other defined errors. See the message field in the error object for more details. L/D
204 MaxErrorCode.NO_FILL No ads are currently eligible for your device (no fill). MAX returned no eligible ads from any mediated networks for this app/device. L
−5001 MaxErrorCode.AD_LOAD_FAILED The ad failed to load due to no networks being able to fill. MAX returned eligible ads from mediated networks, but all ads failed to load. See the adLoadFailureInfo field in the error object for more details. L
−1000 MaxErrorCode.NETWORK_ERROR The ad request failed due to a generic network error. See the message field in the error object for more details. L
−1001 MaxErrorCode.NETWORK_TIMEOUT The ad request timed out due to a slow internet connection. L
−1009 MaxErrorCode.NO_NETWORK The ad request failed because the device is not connected to the internet. L
−23 MaxErrorCode.FULLSCREEN_AD_ALREADY_SHOWING You are attempting to show a fullscreen ad (interstitial or rewarded) while another fullscreen ad was still showing. D
−24 MaxErrorCode.FULLSCREEN_AD_NOT_READY You are attempting to show a fullscreen ad before it has been loaded. D
−5201 MaxErrorCode.ERROR_CODE_INVALID_LOAD_STATE The internal state of the SDK is invalid. There are various ways this can occur. L
−5205 MaxAdapterError.AD_NOT_READY The adapter did not have an ad ready when attempting to display. L
−5209 MaxAdapterError.INTERNAL_ERROR Unspecified internal error. L
−5601 MaxErrorCode.NO_ACTIVITY The SDK failed to load an ad because it could not find the top Activity. L
−5602 MaxErrorCode.DONT_KEEP_ACTIVITIES_ENABLED The SDK failed to display an ad because the user has the “Don’t Keep Activities” developer setting enabled. D

Error Codes from Various Networks

To better understand the error codes that various ad networks return, see the error documentation pages published by those networks: