Video error code reference
Overview
Equativ's video errors are a useful tool to troubleshoot problems in video integrations or insertions, letting you track lost opportunities and understand the causes of poor delivery rates. Equativ provides the video errors specified by the VAST standard as well as its own proprietary video errors.
To get the insights, create a video error report in Instant Report Builder.
Create video error report
To create an Instant Report Builder report with video errors, proceed as follows:
- Sign in to EMP.
- Go to Reports > Instant Report Builder.
- Click Select template.
- Select the Video troubleshooting report template.
- Observe the Video Error Count metric and the Video Error Code Name dimension. For more details, see “Video error codes” at the end of this document.
- Finish the report configuration, selecting the appropriate dimensions, metrics and filters.
The Video Error Count may appear unusually high due to the Ad buffet feature supported by Equativ’s In-Stream Video Plugin and Embedded Ad Manager: the player requests a pod size—a specific number of video ads—along with additional fallbacks. If an error occurs while attempting to play an ad, the player automatically tries the next ad in the buffet until the requested number of ads—the pod size—is played. This behavior might therefore inflate the overall Video Error Count.
Video error codes
Error Code | Error Name | Description |
---|---|---|
100 | XML_PARSING_ERROR | XML Parsing error |
101 | SCHEMA_ VALIDATION_ERROR | VAST does not comply with VAST schema |
102 | RESPONSE_VERSION_ NOT_SUPPORTED | VAST version of response not supported |
200 | PLAYER_RECEIVED_AD_TYPE_ UNEXPECTED_OR_CANNOT_PLAY | Trafficking error; media player received an ad type that it was not expecting and/or cannot play |
201 | PLAYER_EXPECTING_ DIFFERENT_LINERARITY | Client-side component received a linear creative while expecting a non-linear creative and vice versa |
202 | PLAYER_EXPECTING_ DIFFERENT_DURATION | The client-side component cannot play the ad because it is longer than the allowed duration |
203 | PLAYER_EXPECTING_DIFFERENT_SIZE | The client-side component received an ad size it did not expect |
204 | REQUIRED_AD_CATEGORY_IS_MISSING | Ad category was required but not provided |
205 | INLINE_CATEGORY_VIOLATES_ WRAPPER_BLOCKED_AD_CATEGORIES | Inline Category violates Wrapper Blocked Ad Categories |
206 | AD_BREAK_SHORTENED | Ad Break shortened. Ad was not served. |
300 | GENERAL_WRAPPER_ERROR | General error related to the wrapper |
301 | VAST_URI_TIMEOUT | Timeout of VAST URI provided in wrapper element or in subsequent wrapper element (URI either unavailable or reached a timeout as defined by the media player) |
302 | WRAPPER_LIMIT_REACHED | Wrapper limit reached as defined by the media player; too many wrapper responses without any InLine response have been received |
303 | NO_VAST_RESPONSE | No VAST response after one or multiple wrappers |
304 | FETCH_TIMEOUT | InLine response returned ad unit that failed to result in ad display within defined time limit |
400 | GENERAL_LINEAR_ERROR | General Linear error; media player unable to display the linear ad |
401 | NO_MEDIA_FILE | File not found; unable to find linear/MediaFile from URI |
402 | MEDIA_FILE_TIMEOUT | Timeout of MediaFile URI |
403 | NO_MEDIA_FORMAT | Found no MediaFile supported by this media player, based on the attributes of the MediaFile element |
405 | MEDIA_FILE_DISPLAY_ISSUE | Problem displaying the MediaFile; media player found a MediaFile with supported type but could not display it; MediaFile may include: unsupported codecs, MIME type different from the MediaFile@type, unsupported delivery method, etc. |
406 | REQUIRED_MEZZANINE_IS_MISSING | Mezzanine was required but not provided; ad not served |
407 | MEZZANINE_FIRST_DOWNLOAD_ IN_PROGRESS | Mezzanine is in the process of being downloaded for the first time; download may take several hours; ad will not be served until mezzanine is downloaded and transcoded |
408 | CONDITIONAL_AD_REJECTED | Conditional ad rejected |
409 | INTERACTIVE_CREATIVE_ FILE_NOT_EXECUTED | Interactive unit in the InteractiveCreativeFile node was not executed |
410 | UNIVERSAL_AD_ID_REJECTED | Verification unit in the Verification node was not executed |
411 | MEDIA_FILE_UNSUITABLE | Mezzanine was provided as required, but file did not meet required specification; ad not served |
500 | GENERAL_NON_LINEAR_ ADS_ERROR | General error related to NonLinearAds |
501 | CREATIVE_DIMENSION_UNALIGNED_ TO_CREATIVE_DISPLAY_AREA | Unable to display NonLinearAd because creative dimensions do not align with creative display area (i.e. creative dimension too large) |
502 | FETCH_ERROR_NONLINEAR / NONLINEARADS_RESOURCE | Unable to fetch NonLinearAds/NonLinear resource. |
503 | NO_NONLINEAR_RESOURCE_ FORMAT | Could not find NonLinear resource with supported type |
600 | GENERAL_COMPANION_ADS_ ERROR | General CompanionAds error |
601 | CREATIVE_DIMENSION_DO_NOT_ FIT_CREATIVE_DISPLAY_AREA | Unable to display Companion because creative dimensions do not fit within Companion display area (i.e. no available space) |
602 | UNABLE_TO_DISPLAY_REQUIRED_ COMPANION_ADS_ERROR | Unable to display required Companion |
603 | FETCH_ERROR_COMPANION / COMPANIONADS_RESOURCE | Unable to fetch CompanionAds/Companion resource |
604 | NO_COMPANION_ RESOURCE_FORMAT | Could not find Companion resource with supported type |
900 | UNDEFINED_ERROR | Undefined error |
901 | VPAID_GENERAL_ERROR | General VPAID error |
902 | GENERAL_INTERACTIVE_ CREATIVE_FILE_ERROR | General Interactive Creative File error |