GoogleInteractiveMediaAds Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-21 UTC.
[null,null,["Last updated 2024-08-21 UTC."],[[["\u003cp\u003e\u003ccode\u003eIMAErrorCode\u003c/code\u003e is an enum defining error codes encountered during ad loading or playback in the IMA SDK.\u003c/p\u003e\n"],["\u003cp\u003eErrors encompass issues with VAST responses, ad trafficking, media loading, companion ads, and general SDK usage.\u003c/p\u003e\n"],["\u003cp\u003eSpecific error codes provide insights into the nature of the problem, such as malformed responses, timeouts, and asset mismatches.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use these error codes to diagnose and handle ad-related issues in their applications.\u003c/p\u003e\n"],["\u003cp\u003eSome error codes indicate critical failures, while others may represent recoverable situations.\u003c/p\u003e\n"]]],[],null,["# GoogleInteractiveMediaAds Framework Reference\n\nIMAErrorCode\n============\n\n enum IMAErrorCode : NSInteger {}\n\nPossible error codes raised while loading or playing ads.\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_MALFORMED_RESPONSE](#/c:@E@IMAErrorCode@kIMAError_VAST_MALFORMED_RESPONSE)\n\n `\n ` \n The ad response was not recognized as a valid VAST ad. \n\n #### Declaration\n\n Swift \n\n case VAST_MALFORMED_RESPONSE = 100\n\n Objective-C \n\n kIMAError_VAST_MALFORMED_RESPONSE = 100\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_TRAFFICKING_ERROR](#/c:@E@IMAErrorCode@kIMAError_VAST_TRAFFICKING_ERROR)\n\n `\n ` \n Trafficking error. Video player received an ad type that it was not expecting and/or cannot\n display. \n\n #### Declaration\n\n Swift \n\n case VAST_TRAFFICKING_ERROR = 200\n\n Objective-C \n\n kIMAError_VAST_TRAFFICKING_ERROR = 200\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_LOAD_TIMEOUT](#/c:@E@IMAErrorCode@kIMAError_VAST_LOAD_TIMEOUT)\n\n `\n ` \n The VAST URI provided, or a VAST URI provided in a subsequent Wrapper\n element, was either unavailable or reached a timeout, as defined by the\n video player. The timeout is 8 seconds for initial VAST requests and 4\n seconds for each subsequent Wrapper. \n\n #### Declaration\n\n Swift \n\n case VAST_LOAD_TIMEOUT = 301\n\n Objective-C \n\n kIMAError_VAST_LOAD_TIMEOUT = 301\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_TOO_MANY_REDIRECTS](#/c:@E@IMAErrorCode@kIMAError_VAST_TOO_MANY_REDIRECTS)\n\n `\n ` \n The maximum number of VAST wrapper redirects has been reached. \n\n #### Declaration\n\n Swift \n\n case VAST_TOO_MANY_REDIRECTS = 302\n\n Objective-C \n\n kIMAError_VAST_TOO_MANY_REDIRECTS = 302\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_INVALID_URL](#/c:@E@IMAErrorCode@kIMAError_VAST_INVALID_URL)\n\n `\n ` \n At least one VAST wrapper loaded and a subsequent wrapper or inline ad\n load has resulted in a 404 response code. \n\n #### Declaration\n\n Swift \n\n case VAST_INVALID_URL = 303\n\n Objective-C \n\n kIMAError_VAST_INVALID_URL = 303\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VIDEO_PLAY_ERROR](#/c:@E@IMAErrorCode@kIMAError_VIDEO_PLAY_ERROR)\n\n `\n ` \n There was an error playing the video ad. \n\n #### Declaration\n\n Swift \n\n case VIDEO_PLAY_ERROR = 400\n\n Objective-C \n\n kIMAError_VIDEO_PLAY_ERROR = 400\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_MEDIA_LOAD_TIMEOUT](#/c:@E@IMAErrorCode@kIMAError_VAST_MEDIA_LOAD_TIMEOUT)\n\n `\n ` \n Failed to load media assets from a VAST response.\n The default timeout for media loading is 8 seconds. \n\n #### Declaration\n\n Swift \n\n case VAST_MEDIA_LOAD_TIMEOUT = 402\n\n Objective-C \n\n kIMAError_VAST_MEDIA_LOAD_TIMEOUT = 402\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_LINEAR_ASSET_MISMATCH](#/c:@E@IMAErrorCode@kIMAError_VAST_LINEAR_ASSET_MISMATCH)\n\n `\n ` \n Assets were found in the VAST ad response for linear ad, but none of them\n matched the video player's capabilities. \n\n #### Declaration\n\n Swift \n\n case VAST_LINEAR_ASSET_MISMATCH = 403\n\n Objective-C \n\n kIMAError_VAST_LINEAR_ASSET_MISMATCH = 403\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_COMPANION_AD_LOADING_FAILED](#/c:@E@IMAErrorCode@kIMAError_COMPANION_AD_LOADING_FAILED)\n\n `\n ` \n A companion ad failed to load or render. \n\n #### Declaration\n\n Swift \n\n case COMPANION_AD_LOADING_FAILED = 603\n\n Objective-C \n\n kIMAError_COMPANION_AD_LOADING_FAILED = 603\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_UNKNOWN_ERROR](#/c:@E@IMAErrorCode@kIMAError_UNKNOWN_ERROR)\n\n `\n ` \n An unexpected error occurred and the cause is not known. Refer to the\n inner error for more information. \n\n #### Declaration\n\n Swift \n\n case UNKNOWN_ERROR = 900\n\n Objective-C \n\n kIMAError_UNKNOWN_ERROR = 900\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_PLAYLIST_MALFORMED_RESPONSE](#/c:@E@IMAErrorCode@kIMAError_PLAYLIST_MALFORMED_RESPONSE)\n\n `\n ` \n Ads list response was malformed. \n\n #### Declaration\n\n Swift \n\n case PLAYLIST_MALFORMED_RESPONSE = 1004\n\n Objective-C \n\n kIMAError_PLAYLIST_MALFORMED_RESPONSE = 1004\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_FAILED_TO_REQUEST_ADS](#/c:@E@IMAErrorCode@kIMAError_FAILED_TO_REQUEST_ADS)\n\n `\n ` \n There was a problem requesting ads from the server. \n\n #### Declaration\n\n Swift \n\n case FAILED_TO_REQUEST_ADS = 1005\n\n Objective-C \n\n kIMAError_FAILED_TO_REQUEST_ADS = 1005\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_REQUIRED_LISTENERS_NOT_ADDED](#/c:@E@IMAErrorCode@kIMAError_REQUIRED_LISTENERS_NOT_ADDED)\n\n `\n ` \n Listener for at least one of the required vast events was not added. \n\n #### Declaration\n\n Swift \n\n case REQUIRED_LISTENERS_NOT_ADDED = 1006\n\n Objective-C \n\n kIMAError_REQUIRED_LISTENERS_NOT_ADDED = 1006\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_ASSET_NOT_FOUND](#/c:@E@IMAErrorCode@kIMAError_VAST_ASSET_NOT_FOUND)\n\n `\n ` \n No assets were found in the VAST ad response. \n\n #### Declaration\n\n Swift \n\n case VAST_ASSET_NOT_FOUND = 1007\n\n Objective-C \n\n kIMAError_VAST_ASSET_NOT_FOUND = 1007\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_ADSLOT_NOT_VISIBLE](#/c:@E@IMAErrorCode@kIMAError_ADSLOT_NOT_VISIBLE)\n\n `\n ` \n The ad slot is not visible on the page. \n\n #### Declaration\n\n Swift \n\n case ADSLOT_NOT_VISIBLE = 1008\n\n Objective-C \n\n kIMAError_ADSLOT_NOT_VISIBLE = 1008\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VAST_EMPTY_RESPONSE](#/c:@E@IMAErrorCode@kIMAError_VAST_EMPTY_RESPONSE)\n\n `\n ` \n A VAST response containing a single `\u003cVAST\u003e` tag with no\n child tags. \n\n #### Declaration\n\n Swift \n\n case VAST_EMPTY_RESPONSE = 1009\n\n Objective-C \n\n kIMAError_VAST_EMPTY_RESPONSE = 1009\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_FAILED_LOADING_AD](#/c:@E@IMAErrorCode@kIMAError_FAILED_LOADING_AD)\n\n `\n ` \n There was an error loading the ad. \n\n #### Declaration\n\n Swift \n\n case FAILED_LOADING_AD = 1010\n\n Objective-C \n\n kIMAError_FAILED_LOADING_AD = 1010\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_STREAM_INITIALIZATION_FAILED](#/c:@E@IMAErrorCode@kIMAError_STREAM_INITIALIZATION_FAILED)\n\n `\n ` \n There was an error initializing the stream. \n\n #### Declaration\n\n Swift \n\n case STREAM_INITIALIZATION_FAILED = 1020\n\n Objective-C \n\n kIMAError_STREAM_INITIALIZATION_FAILED = 1020\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_INVALID_ARGUMENTS](#/c:@E@IMAErrorCode@kIMAError_INVALID_ARGUMENTS)\n\n `\n ` \n Invalid arguments were provided to SDK methods. \n\n #### Declaration\n\n Swift \n\n case INVALID_ARGUMENTS = 1101\n\n Objective-C \n\n kIMAError_INVALID_ARGUMENTS = 1101\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_API_ERROR](#/c:@E@IMAErrorCode@kIMAError_API_ERROR)\n\n `\n ` \n Generic invalid usage of the API. \n\n #### Declaration\n\n Swift \n\n case API_ERROR = 1102\n\n Objective-C \n\n kIMAError_API_ERROR = 1102\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_OS_RUNTIME_TOO_OLD](#/c:@E@IMAErrorCode@kIMAError_OS_RUNTIME_TOO_OLD)\n\n `\n ` \n The version of the runtime is too old. \n\n #### Declaration\n\n Swift \n\n case OS_RUNTIME_TOO_OLD = 1103\n\n Objective-C \n\n kIMAError_OS_RUNTIME_TOO_OLD = 1103\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VIDEO_ELEMENT_USED](#/c:@E@IMAErrorCode@kIMAError_VIDEO_ELEMENT_USED)\n\n `\n ` \n Another VideoAdsManager is still using the video. It must be unloaded\n before another ad can play on the same element. \n\n #### Declaration\n\n Swift \n\n case VIDEO_ELEMENT_USED = 1201\n\n Objective-C \n\n kIMAError_VIDEO_ELEMENT_USED = 1201\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_VIDEO_ELEMENT_REQUIRED](#/c:@E@IMAErrorCode@kIMAError_VIDEO_ELEMENT_REQUIRED)\n\n `\n ` \n A video element was not specified where it was required. \n\n #### Declaration\n\n Swift \n\n case VIDEO_ELEMENT_REQUIRED = 1202\n\n Objective-C \n\n kIMAError_VIDEO_ELEMENT_REQUIRED = 1202\n\n- `\n ``\n ``\n `\n\n ### [kIMAError_CONTENT_PLAYHEAD_MISSING](#/c:@E@IMAErrorCode@kIMAError_CONTENT_PLAYHEAD_MISSING)\n\n `\n ` \n Content playhead was not passed in, but list of ads has been returned\n from the server. \n\n #### Declaration\n\n Swift \n\n case CONTENT_PLAYHEAD_MISSING = 1205\n\n Objective-C \n\n kIMAError_CONTENT_PLAYHEAD_MISSING = 1205"]]