Errors

Errors arrive in the AdError event. The type field shows the stage: adLoadError — loading, adShowError — playback.

Integration errors

Code	Cause	What to do
1	Failed to parse the SDK page address, for example the url parameter is missing or controls isn't valid JSON.	Check the page address and parameter encoding.
web_ui_in_native_build	os=web was passed in a WebView.	Open an address with the platform in the path (/android/, /androidtv/, /ios/) and drop os=web.
viewport_unavailable	The page didn't get dimensions within 3 seconds.	Make sure the WebView or container is visible and sized before the ad loads.
900	Failed to start the player (iOS).	Check the WKWebView configuration.
permission_denied	The browser blocked playback (browser only).	Start playback after a user action, or without sound.

VAST errors

Numeric codes correspond to the VAST specification.

Code	Description
100–102	VAST parsing error or unsupported version.
301–303	Wrapper chain error: timeout, limit exceeded, or no ad after the wrapper.
400	General linear creative playback error.
401	Video file not found.
402	Video file loading timeout.
403	No video file in a supported format.
900	Unknown error.
901	VPAID creative error.
902	VAST request timeout.
903	Invalid VAST XML document.
1001	Invalid input data for loading.

VPAID error 901

A VPAID creative receives the page dimensions at load time. If the page has zero or too small dimensions, the creative fails with error 901. Make sure the WebView is visible on screen before playback.