Video interstitial (redirect, app)
Overview
Formerly named "Smart Video-Interstitial SDK VAST" / "RTB+ Smart Video-Interstitial SDK". The "Video interstitial (redirect)" creative template displays a full-screen VAST 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 (redirect) 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. This creative template uses the same creatives for both portrait and landscape orientation. Filling the VAST URL field (see "Creative template parameters" below) is mandatory. Optionally, you can add images used as a background and poster image:
- Creative #1 - optional image creative 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 #2 - optional image creative used as a poster image of the video; image files only
Supported file formats:
- Video
- Option 1: a VAST URL which calls a valid VAST 2.0 or VAST 3.0 XML with at least one mp4 video encoded in H.264; Warning: 360°/3D Videos are supported only with SDK >= 6.5 on iOS >= 9.0 and Android >= 4.4.
- Option 2: a VPAID javascript media file; ad parameters are supported for VPAID creatives; Warning: 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;
- Background/Poster image:
- jpg
- gif
- png
The interstitial is automatically adapted to the width of the screen. The height is adjusted to preserve the aspect ratio of the video.
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)* | If available, the SDK will try to open directly the app corresponding to this URL. The target app will be presented only if it's installed on the device (iOS 10 and more) or allowlisted by the app referral. If it can't be opened the SDK will try to open the Click URL as a fallback. | |
| 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 |
| Click URL | If you provide a click URL, it will override any click URL available in the VAST file. | |
| Close appearance countdown* | Displays a countdown before showing the close button (the close appearance delay must be greater than 0 seconds). | Enabled |
| 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 | Position of the close button | 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 |
Enabled |
| 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. |
Disabled |
| Third party impression pixels | Comma separated list of URLs that will be called when the impression is counted by the SDK. | |
| Use VAST companion as background image* | If enabled, any companion image found in the VAST file will be used as the background image of the interstitial. | Disabled |
| VAST URL | The URL of the VAST file that will be used by the insertion. | |
| 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 |
Used to override the skip configuration found in the VAST file: Yes - the video will always be skippable. No - the video will never be skippable. Keep VAST setting - use the configuration found in the VAST file. |
Yes |
| 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