Contact support

Video interstitial (app)

Overview

Formerly named "Smart Video-Interstitial SDK Publisher" / "RTB+ Smart Video-Interstitial SDK". The "Video interstitial" creative template displays a full-screen video ad above the app content. Users can close (skip) it or it can disappear automatically. 

Most common sizes 

Most common RTB sizes of this ad format: 320x480, 640x960.

Demo

Video interstitial demo available in these apps:

Compliancy

Criterion Compliancy
MRAID 1.0

MRAID 2.0

RTB

Creatives

This section applies for the direct creative template only. You need a minimum of 1 creative:

  • Creative #1 - mandatory; the video/VPAID creative displayed in portrait and landscape orientation. Warning: you must set the click URL in the "Click URL" field in the edit view of the creative
  • Creative #2 - optional; used as a background image of the interstitial; image files only; Note: If the creative template parameter "Video blurred background" is enabled, this creative will be used as an overlay
  • Creative #3 - optional; used as a poster image of the video; image files only

The Video interstitial is automatically adapted to the width of the screen. The height is adjusted to preserve the aspect ratio of the video.

Supported file formats:

  • video file: mp4, mov, 3gp
  • background image/poster image: jpg, gif, png
  • VPAID: javascript file, without Ad Parameters. (Only for SDK >= 6.4)

Creative template parameters

Parameter Description Default value
360° Video* iOS versions >= 9.0 disabled - the video will be displayed by a regular video player enabled - the video will be displayed by a 360° video player Disabled
App link URL (iOS only)* App URL that will be opened by the SDK instead of the creative click URL, if the app is available on the iOS device. The SDK will fall back on the creative click URL otherwise.  
Audio mode

muted - the video will be muted by default.

auto - the video will be muted or unmuted depending on the status of the phone silent switch (or ring volume for devices without silent switch). 

on - the video will be unmuted by default (user music playback will stop).

muted
Auto close when video ends If enabled, the interstitial will close as soon as the video is finished. Make sure you enable the close button if you disable the auto close feature! Disabled
Autoplay video*

If enabled, the video will start as soon as the interstitial is displayed.

Note: autoplay is enforced to true for VPAID creatives for compatibility reasons.

Enabled
Background color The color that will be displayed under the creative if it does not fit the display area. #000000
Close appearance countdown* Displays a countdown before showing the close button (the close appearance delay must be greater than 0 seconds). Disabled
Close appearance delay (in seconds) Number of seconds before the close button appears; set it to 0 for no delay at all  
Close button position   Top right
Close on click

disabled - the interstitial will stay on screen even if it is clicked by the user

enabled - the interstitial will be dismissed as soon as it is clicked by the user

Disabled
Progress tracking event offset position The timecode (HH:MM:SS or HH:MM:SS.mm or percentage n%) when the progress event will be sent.  
Redirect to third party (iOS only)*

disabled - the SDK will always attempt to open the creative click URL in-app (Safari modal, Store modal etc.)

enabled - the SDK will always open the creative click URL outside the app (Safari, App Store, etc.)

Disabled
Resize policy for background image*

cover - the image will cover the entire container even if it has to crop it in width or height

contain - the image will be resized to be contained in the screen (without modifying the aspect ratio) 100% - the image will be stretched to match both the device width and height

Cover
Swipe to close

disabled - the interstitial can only be closed using the close button. enabled - the interstitial can be closed by swiping it down as soon as the close button is enabled.

Note: this feature will not work with all creatives.

Disabled
Third party impression pixels Comma separated list of URLs that will be called when the impression is counted by the SDK.  
Vertical position for video* The vertical position of the video when the device is in portrait orientation. In landscape orientation, the video will always be centered vertically. Top
Video blurred background If enabled, add a dynamic blurred effect behind the video. The blur will replace any background color. This effect will not be applied on VPAID creatives. Disabled
Video blurred background blur radius The radius of the background blur that will be applied to the interstitial background; set it to 0 to disable blur 15
Video blurred background tint color* The tint color of the blurred background. #ffffff
Video blurred background tint color opacity*

The opacity to apply to the tint color of the blurred effect in percent (0-100 %).

Note: 100% will completely mask the effect.

0
Video is skippable If enabled, a close button will be displayed. Disabled
RTB options (only for the RTB template)
Acceptable sizes Acceptable creative sizes retrieved from RTB; format: comma-separated list of width*height pairs (no spaces). Example: 250*300,320*250  
Height The height of the video player in device independent pixels.  
Maximum bit rate The maximum bit rate in kbps for RTB ads.  
Maximum video duration The maximum duration in seconds for RTB video ads. 60
Minimum bit rate The minimum bit rate in kbps for RTB ads.  
Minimum video duration The minimum duration in seconds for RTB video ads. 1
Playback method The playback methods for video ads that will be retrieved from RTB. All
Use VAST companion as background image If this option is enabled, a companion image (in case one is found alongside your video creative in the VAST file) will be used as the background image of the interstitial. Disabled
VPAID version (SDK >= 6.5) Select the expected VPAID version(s). 0
Width The width of the video player in device independent pixels.  

* SDK 7 only 

Limitations

  • VPAID creatives and the go-to vertical video feature are supported only with SDK >= 6.4; the go-to-vertical feature refers to the blurred version of the video displayed to fill the screen space not covered by the video; 
  • 360°/3D videos are supported only with SDK >= 6.5 on iOS >= 9.0 and Android >= 4.4.

Known issues

n/a

Release notes

  • 2019-02-18 - Updated labels / tooltips / doc