Video floor
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
Compliancy
| Criterion | Compliancy |
|---|---|
| Creative rotation | ✅ |
| Friendly iFrame | ✅ |
| Responsive web design | ✅ |
| RTB | ✅ |
| SIMID | ❌ |
| VAST 4.2 and lower | ✅ |
| VAST wrapper | ✅ |
| VPAID | ✅ |
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 | ||
| Creative feedback | Shows creative feedback button | true |
| Horizontal position | Horizontal position of creative | center |
| 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 |
|
| Vertical position | Vertical position of creative | bottom |
| zIndex | zIndex of creative | 1000 |
| 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 opacity | Select opacity of the background between 0 (transparent) and 1 (opaque). If you set 0, the background will not appear. | 0.5 |
| Background position | Specifies the background position. More details here. | center top |
| Background repeat | Specifies how to repeat the background image | no-repeat |
| 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 | ||
| Loop video | Specifies if video will be looped | false |
| On mouse out mute player | On mouse out mute sound | false |
| 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 |
| Pause player on tab changing | Stop video when changing browser tabs | true |
| Buttons options | ||
| 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 |
| 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 |
| 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) | ||
| Maximum bitrate | Maximum expected bitrate for the video creative, in Kbps. | |
| Maximum duration | Maximum ad duration, in second(s) | |
| Minimum bitrate | Minimum expected bitrate for the video creative, in Kbps | |
| Minimum duration | Minimum ad duration, in second(s) | |
| Video player width | Specifies the video player width (in px). The height will be calculated automatically using the aspect ratio (16:9). | |
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");
});Creative prioritization (VPAID or video file)
To ensure proper ad event tracking in web environments, the creative template defaults to prioritizing VPAID creatives (Video Player Ad Interface Definition) over standard video media files. However, VPAID usually doesn't function correctly in mobile web environments. In such cases, the template automatically discards the VPAID creative and plays the video assets instead.
If you need to override this default behavior and prioritize VPAID creatives in mobile web environments, you can set the sasVpaidFirst variable to true. Add the following snippet to the Custom script field of the insertion:
<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 Report metric reference 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
- 08-09-2025 - Added Creative prioritization
- 2025-06-16 - Add DSA and feedback button
- 2025-04-01 - Remove custom close button option
- 2025-03-05 - Updates for action pixels generation
- 2025-04-01 - Remove custom close button option
- 2025-03-05 - Updates for action pixels generation
- 2024-09-25 - Add support for OMSDK
- 2024-01-24 - Removed support for obsolete macros
- 2023-10-16 - Update Video Placement Type parameter
- 2023-07-18 - Added new RTB macros
- 2023-04-05 - Update sas-libs version to 1.1
- 2023-02-02 - Select the most appropriate creative encoded version based on bandwidth and resolution
- 2020-05-13 - Remove start muted custom parameter
- 2019-05-30 - Added support for video placement types (OpenRTB 2.5) in RTB template
- 2019-02-05 - Viewability module improvements - Measures are now more accurate and more integrations are covered
- 2019-01-28 - Add RTB dimensions in click url
- 2018-09-13 - On mouse over/out unmute/mute disabled by default
- 2018-07-16 - Removed support for flash creatives
- 2018-04-25 - Parse RTB parameters into strings
- 2018-03-06 - Additional RTB parameters in event trackers
- 2018-02-19 - Enable viewability counting by default
- 2018-01-30 - Updated tracking urls
- 2018-01-22 - Updated meta parameters
- 2017-11-23 - New default close button
- 2017-11-21 - Updated meta parameters in RTB template
- 2017-11-20 - Code refactoring + VAST4 support
- 2017-09-25 - Updated meta parameters in RTB template
- 2017-08-10 - Support for standalone tag
- 2017-05-18 - Support for tagId ad call parameter