Summary
Overview
Most common sizes
Demo
Compliancy
Creatives
Creative template parameters
Features
Metrics
Limitations
Known issues
Release notes
Overview
Formerly named "Smart Video-Floorad" / "RTB+ Smart Video-Floorad". The "Video floor" creative template displays a video ad that sticks at the top or bottom of the window.
Most common sizes
Most common RTB sizes of this ad format: 768x1024
Demo
Video floor demo
Compliancy
| Criterion | Compliancy |
|---|
| RTB | ✅ |
| VAST 4.2 and lower | ✅ |
| VAST wrapper | ✅ |
| VPAID | ✅ |
| SIMID | ❌ |
| Creative rotation | ✅ |
| Responsive web design | ✅ |
| Friendly iFrame | ✅ |
Creatives
This section applies for the direct creative template only.
Supported video files:
- mp4, webm (use files with high resolution and bitrate)
- any VAST redirect containing the formats: mp4, ogg, webm, javascript (for VPAID only)
Note 1: In case of VAST redirects, the ad format picks the most appropriate file to play according to the following priorities: (1) mp4, (2) webm, (3) ogg, (4) javascript
Note 2: In case of VAST redirects, use the "Paste script" creation method and paste the URL or the entire XML into the "Creative script" field.
Note 3: In case of creative scripts, make sure you specify the size.
Creative template parameters
| Name | Description | Default value |
| Main options |
| Vertical position | Vertical position of creative | bottom |
| Horizontal position | Horizontal position of creative | center |
| zIndex | zIndex of creative | 1000 |
| Margin | Margin from bottom or top of the page (in px) | 0 |
| Tracking URL | Make sure you add [timestamp] to the URL for cache busting | |
| Creative feedback | Shows creative feedback button | true |
| Close button options |
| Add close button | Specifies if close button will appear | true |
| Background options |
| Background color | Specifies the background color | #000 |
| Background image | Specifies the background images to be used | |
| Background repeat | Specifies how to repeat the background image | no-repeat |
| Background position | Specifies the background position. More details here | center top |
| Background opacity | Select opacity of the background between 0 (transparent) and 1 (opaque). If you set 0, the background will not appear. | 0.5 |
| Expand options |
| Collapsed height | Specifies the collapsed height of the expandable ad. 0 means that expand mode is disabled. | 0 |
| Enable transition effect | Enable/disable transition effect when expanding/collapsing. This feature works only on modern browsers: IE10+, Chrome, Firefox, Opera, Safari | true |
| Transition duration | Specifies transition duration | 1 |
| Transition type | Specifies transition type | ease |
| Player options |
| On mouse over unmute player | On mouse over unmute sound
Please notice that the newest versions of Chrome and Safari browsers do not allow to mute / unmute video programmatically. In that case video player may be paused instead of muted / unmuted. We recommend to keep this option disabled. | false |
| On mouse out mute player | On mouse out mute sound | false |
| Loop video | Specifies if video will be looped | false |
| Pause player on tab changing | Stop video when changing browser tabs | true |
| Buttons options |
| Fullscreen button | Specifies if player will have fullscreen button | false |
| Play/pause button | Specifies if player will have play/pause buttons | false |
| Volume button | Specifies if player will have volume button | true |
| Auto hide buttons | Specifies if buttons should be hidden after a short time. This option works only if the "Bar mode" param is set to "FLOATING" | true |
| Bar options |
| Bar mode | Specifies the player bar mode | FLOATING |
| Bar opacity | Select opacity of the player's bar between 0 (transparent) and 1 (opaque). | 0.5 |
| RTB options (only for the RTB template) |
| Video player width | Specifies the video player width (in px). The height will be calculated automatically using the aspect ratio (16:9). | |
| Minimum duration | Minimum ad duration, in second(s) | |
| Maximum duration | Maximum ad duration, in second(s) | |
| Minimum bitrate | Minimum expected bitrate for the video creative, in Kbps | |
| Maximum bitrate | Maximum expected bitrate for the video creative, in Kbps. | |
Features
- sticks to top or bottom of the display
- supports a nice CSS3 animation for expand/collapse
- works for web only (no mobile web supported)
Event listening
The Video floor creative template supports the following events: adBegin, adDuration, adEnd and adError. You can listen to these events to control the functioning of your site.
Any event contains the parameter formatId to get which formatId (on the page) fired the event:
window.addEventListener('adBegin', function (e) {
console.log(e.formatId);
});
adBegin / adEnd
For instance, if your website has a video player playing video content, you can mute that player when the ad appears and unmute when it disappears:
window.addEventListener('adBegin', function (e) {
document.querySelector('video').muted = true;
});
adDuration
The adDuration provides access to the videoDuration property, which can be useful to retrieve the duration of the whole video ad:
window.addEventListener('adDuration', function (e) {
console.log(e.videoDuration);
});
adError
To take an action when there is an error or the VAST is empty:
window.addEventListener('adError', function (e) {
console.log("Ad error occured");
});
Force VPAID media files
To update media files selection and prioritize VPAID creatives the sasVpaidFirst variable can be used with a value of true. The below snippet can be added as a custom script:
<script> sasVpaidFirst = true; </script>
Metrics
The player and data logging start immediately. This ad format also logs the "expand" and "collapse" metrics.
Also see the Video metrics article.
Limitations
- works for web only (no mobile web supported)
- the newest versions of Chrome and Safari browsers do not allow to mute / unmute video programmatically. In that case video player may be paused instead of muted / unmuted. We recommend to keep "On mouse over unmute" and "On mouse out mute" options disabled
Known issues
Internet Explorer 10, 9, 8 are not supported anymore
Release notes
- 16-06-2025 - Add DSA and feedback button
- 01-04-2025 - Remove custom close button option
- 05-03-2025 - Updates for action pixels generation
- 25-09-2024 - Add support for OMSDK
- 24-01-2024 - Removed support for obsolete macros
- 16-10-2023 - Update Video Placement Type parameter
- 18-07-2023 - Added new RTB macros
- 05-04-2023 - Update sas-libs version to 1.1
- 02-02-2023 - Select the most appropriate creative encoded version based on bandwidth and resolution
- 13-05-2020 - Remove start muted custom parameter
- 30-05-2019 - Added support for video placement types (OpenRTB 2.5) in RTB template
- 05-02-2019 - Viewability module improvements - Measures are now more accurate and more integrations are covered
- 28-01-2019 - Add RTB dimensions in click url
- 13-09-2018 - On mouse over/out unmute/mute disabled by default
- 16-07-2018 - Removed support for flash creatives
- 25-04-2018 - Parse RTB parameters into strings
- 06-03-2018 - Additional RTB parameters in event trackers
- 19-02-2018 - Enable viewability counting by default
- 30-01-2018 - Updated tracking urls
- 22-01-2018 - Updated meta parameters
- 23-11-2017 - New default close button
- 21-11-2017 - Updated meta parameters in RTB template
- 20-11-2017 - Code refactoring + VAST4 support
- 25-09-2017 - Updated meta parameters in RTB template
- 10-08-2017 - Support for standalone tag
- 18-05-2017 - Support for tagId ad call parameter
