AI-generated Key Takeaways
-
IMAErrorCode
is an enumeration defining possible error codes raised while loading or playing ads. -
Errors like
VAST_MALFORMED_RESPONSE
,VAST_TRAFFICKING_ERROR
, andVAST_LOAD_TIMEOUT
indicate issues with the VAST ad response or loading process. -
Errors in the 400 range, such as
VIDEO_PLAY_ERROR
andVAST_MEDIA_LOAD_TIMEOUT
, are related to problems playing the video ad or loading media assets. -
Other errors cover issues like failed companion ad loading, unknown errors, problems requesting ads, invalid arguments, API usage errors, and issues with the video element or content playhead.
IMAErrorCode
enum IMAErrorCode : NSInteger {}
Possible error codes raised while loading or playing ads.
-
The ad response was not recognized as a valid VAST ad.
Declaration
Swift
case VAST_MALFORMED_RESPONSE = 100
Objective-C
kIMAError_VAST_MALFORMED_RESPONSE = 100
-
Trafficking error. Video player received an ad type that it was not expecting and/or cannot display.
Declaration
Swift
case VAST_TRAFFICKING_ERROR = 200
Objective-C
kIMAError_VAST_TRAFFICKING_ERROR = 200
-
The VAST URI provided, or a VAST URI provided in a subsequent Wrapper element, was either unavailable or reached a timeout, as defined by the video player. The timeout is 8 seconds for initial VAST requests and 4 seconds for each subsequent Wrapper.
Declaration
Swift
case VAST_LOAD_TIMEOUT = 301
Objective-C
kIMAError_VAST_LOAD_TIMEOUT = 301
-
The maximum number of VAST wrapper redirects has been reached.
Declaration
Swift
case VAST_TOO_MANY_REDIRECTS = 302
Objective-C
kIMAError_VAST_TOO_MANY_REDIRECTS = 302
-
At least one VAST wrapper loaded and a subsequent wrapper or inline ad load has resulted in a 404 response code.
Declaration
Swift
case VAST_INVALID_URL = 303
Objective-C
kIMAError_VAST_INVALID_URL = 303
-
There was an error playing the video ad.
Declaration
Swift
case VIDEO_PLAY_ERROR = 400
Objective-C
kIMAError_VIDEO_PLAY_ERROR = 400
-
Failed to load media assets from a VAST response. The default timeout for media loading is 8 seconds.
Declaration
Swift
case VAST_MEDIA_LOAD_TIMEOUT = 402
Objective-C
kIMAError_VAST_MEDIA_LOAD_TIMEOUT = 402
-
Assets were found in the VAST ad response for linear ad, but none of them matched the video player’s capabilities.
Declaration
Swift
case VAST_LINEAR_ASSET_MISMATCH = 403
Objective-C
kIMAError_VAST_LINEAR_ASSET_MISMATCH = 403
-
A companion ad failed to load or render.
Declaration
Swift
case COMPANION_AD_LOADING_FAILED = 603
Objective-C
kIMAError_COMPANION_AD_LOADING_FAILED = 603
-
An unexpected error occurred and the cause is not known. Refer to the inner error for more information.
Declaration
Swift
case UNKNOWN_ERROR = 900
Objective-C
kIMAError_UNKNOWN_ERROR = 900
-
Ads list response was malformed.
Declaration
Swift
case PLAYLIST_MALFORMED_RESPONSE = 1004
Objective-C
kIMAError_PLAYLIST_MALFORMED_RESPONSE = 1004
-
There was a problem requesting ads from the server.
Declaration
Swift
case FAILED_TO_REQUEST_ADS = 1005
Objective-C
kIMAError_FAILED_TO_REQUEST_ADS = 1005
-
Listener for at least one of the required vast events was not added.
Declaration
Swift
case REQUIRED_LISTENERS_NOT_ADDED = 1006
Objective-C
kIMAError_REQUIRED_LISTENERS_NOT_ADDED = 1006
-
No assets were found in the VAST ad response.
Declaration
Swift
case VAST_ASSET_NOT_FOUND = 1007
Objective-C
kIMAError_VAST_ASSET_NOT_FOUND = 1007
-
The ad slot is not visible on the page.
Declaration
Swift
case ADSLOT_NOT_VISIBLE = 1008
Objective-C
kIMAError_ADSLOT_NOT_VISIBLE = 1008
-
A VAST response containing a single
<VAST>
tag with no child tags.Declaration
Swift
case VAST_EMPTY_RESPONSE = 1009
Objective-C
kIMAError_VAST_EMPTY_RESPONSE = 1009
-
There was an error loading the ad.
Declaration
Swift
case FAILED_LOADING_AD = 1010
Objective-C
kIMAError_FAILED_LOADING_AD = 1010
-
There was an error initializing the stream.
Declaration
Swift
case STREAM_INITIALIZATION_FAILED = 1020
Objective-C
kIMAError_STREAM_INITIALIZATION_FAILED = 1020
-
Invalid arguments were provided to SDK methods.
Declaration
Swift
case INVALID_ARGUMENTS = 1101
Objective-C
kIMAError_INVALID_ARGUMENTS = 1101
-
Generic invalid usage of the API.
Declaration
Swift
case API_ERROR = 1102
Objective-C
kIMAError_API_ERROR = 1102
-
The version of the runtime is too old.
Declaration
Swift
case OS_RUNTIME_TOO_OLD = 1103
Objective-C
kIMAError_OS_RUNTIME_TOO_OLD = 1103
-
Another VideoAdsManager is still using the video. It must be unloaded before another ad can play on the same element.
Declaration
Swift
case VIDEO_ELEMENT_USED = 1201
Objective-C
kIMAError_VIDEO_ELEMENT_USED = 1201
-
A video element was not specified where it was required.
Declaration
Swift
case VIDEO_ELEMENT_REQUIRED = 1202
Objective-C
kIMAError_VIDEO_ELEMENT_REQUIRED = 1202
-
Content playhead was not passed in, but list of ads has been returned from the server.
Declaration
Swift
case CONTENT_PLAYHEAD_MISSING = 1205
Objective-C
kIMAError_CONTENT_PLAYHEAD_MISSING = 1205