Video skin
Overview
Formerly named "Smart Video-Background" / "RTB+ Smart Video-Background". The "Video skin" creative template displays a background ad, visible on the left, top and right side of the page, including a video ad that can expand to full-screen mode.
Demo
Compliancy
| Criterion | Compliancy |
|---|---|
| Creative rotation | ✅ |
| Friendly iFrame | ✅ |
| Responsive web design | ✅ |
| RTB | ✅ |
| SIMID | ❌ |
| VAST 4.2 and lower | ✅ |
| VAST wrapper | ✅ |
| Viewability counting (MRC standard) | ✅ |
| 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.
Creative template parameters
| Name | Description | Default value |
|---|---|---|
| Template options | ||
| Expand/close animation speed | Specifies speed of expand and close animation; select "none" to get no animation at all | fast |
| Place of ad | Specifies where the ad should be placed | top |
| Tracking url | Make sure you add [timestamp] to the URL for cache busting |
|
| zIndex | zIndex of the creative | 999 |
| zIndex expand | zIndex of the creative in expand mode | 9999 |
| Player options (non expand mode) | ||
| Autoplay (non expand mode) | Specifies if the player should start automatically | true |
| Loop video (non expand mode) | Specifies if the small video is looped | true |
| Player height (non expand mode) | Specifies the height of the small player | 190 |
| Player horizontal offset(non expand mode) | Specifies the horizontal offset of the small player; positive number: to the right side; number with "-": to the left side | 0 |
| Player vertical offset (non expand mode) | Specifies the vertical offset of the small player; positive number: to the bottom; number with "-": to the top | 0 |
| Player width (non expand mode) | Specifies the width of the small player | 600 |
| Video disappear when finished (non expand mode) | Specifies if the small video disappears when finished; to use it, "Loop video" cannot be selected | false |
| Volume button (non expand mode) | Specifies if small player has volume button. The expanded player will always start muted | false |
| Player options (expand mode) | ||
| Bar mode (expand mode) | Specifies the bar mode | FLOATING |
| Bar opacity (expand mode) | Specifies the opacity of the bar | 0.5 |
| Duration label (expand mode) | Specifies the duration label; Note: use {0} in label to count down until the end of the ad | End of break ads in {0}s |
| Expand mode | Specifies the type of expand mode | video + background |
| Fullscreen button(expand mode) | Specifies if the player has a fullscreen button | false |
| Loop video(expand mode) | Specifies if the video is looped | false |
| On mouse out mute(expand mode) | Specifies if the sound is muted on mouse out | false |
| On mouse over unmute(expand mode) | Specifies if the sound is unmuted on mouse over 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 on tab changing (expand mode) | Stops the video when changing browser tabs | true |
| Play/pause button (expand mode) | Specifies if the player has a play/pause buttons | true |
| Player height (expand mode) | Specifies the player height in expand mode | 600 |
| Player vertical offset (expand mode) | Player vertical position; positive number: move to the bottom; number with "-": move to the top | 0 |
| Player width (expand mode) | Specifies the player width in expand mode | 800 |
| Volume button (expand mode) | Specifies if the player has a volume button | true |
| Buttons options | ||
| Show close button in: | Specifies where the close button should appear | collapse and expand mode |
| Text label options | ||
| Label text | Specifies the label which appears above the player | Advertisement |
| Label text font color | Specifies the color of the label text | #cccccc |
| Label text font size | Specifies the font size of the label | 12 |
| Background options | ||
| Background attachment | Specifies the background attachment | scroll |
| Background color | Specifies the background color | #FFFFFF |
| Background color (expand mode) | Specifies the background color in expand mode | #FFFFFF |
| Background position | Specifies the background position; more information here | center top |
| Background position (expand mode) | Specifies the background position; more information here | center top |
| Background repeat | Specifies the background repeat | no-repeat |
| Background repeat (expand mode) | Specifies the background repeat in expand mode | no-repeat |
| Background url | Specifies the background URL | |
| Background url (expand mode) | Specifies the background URL in expand mode | |
| Background video | ||
| Add background video | Specifies if a background video is added to the ad | true |
| Add background video (expand mode) | Specifies if a background video is added to the ad in expand mode | false |
| Opacity |
Sets the opacity level for the video. The opacity-level describes the transparency-level, where:
|
0.9 |
| Click map options | ||
| Allow click over the background | Specifies if the background should be clickable | true |
| Height of clickmap (left and right side) | Defines the height of click map area on the left and right side of page | 1500 |
| Show test border line | Shows border line over the clickmap; this option will help to set up the click map position | false |
| Width of clickmap (right and left side) | Defines the width of the click map area on the left and right side of the page | 5000 |
| Width of page | Is mandatory if the background is supposed to be clickable | 0 |
| Start expand options | ||
| Click starts expand | Specifies if a click starts expanding | false |
| Hover over video starts expand | Specifies if hovering over the video-banner starts counting to expand | true |
| 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) | |
Features
Formerly named "Smart Video-Background" / "RTB+ Smart Video-Background". The "Video skin" creative template displays a background ad, visible on the left, top and right side of the page, including a video ad that can expand to full-screen mode.
Behavior on mouse hover
On mouse hover, the video behaves in three possible ways:
- Video displays in full screen mode
- Video + Background is displayed
- No changes
Default behavior
- the small video is auto-played in auto-replay mode
- sound is inactive on mouse hover
- on mouse hover, the ad goes into full screen mode
- in full screen mode, the sound is off and the ad is skippable from the beginning; when finished, it goes back to the main website
The default behavior is completely customizable from the Equativ Monetization Platform.
Clickable background
The background can be clickable. To set it up, enable the checkbox "Allow click over the background" and fill the parameters:
- ① width of clickmap (left and right side)
- ② height of clickmap (left and right side)
- ③ width of page
Event listening
The Video skin 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 small player and data logging start immediately. Data from the small and the big players are summed up. Also see the Video metrics article.
Limitations
- works for web only (no mobile web supported)
- IE 10, 9, 8 are not supported anymore
- 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
n/a
Release notes
- 01-04-2025 - Removed custom close button options
- 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
- 27-06-2020 - Bugfix - play button not disappearing
- 01-06-2020 - Add volume button for small player
- 23-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
- 17-10-2018 - Fix for video in expand mode
- 13-09-2018 - Start muted enabled 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 URL
- 30-01-2018 - Code refactoring + VAST4 support
- 22-01-2018 - Updated meta parameters
- 22-11-2017 - New default close button
- 22-11-2017 - Updated meta parameters in RTB template
- 26-09-2017 - Updated meta parameters in RTB template
- 10-08-2017 - Support for standalone tag
- 03-08-2017 - Fix for clickmap
- 03-08-2017 - Log expand action + update for HTML5 player
- 16-02-2017 - Make template RTB compliant
- 15-11-2016 - Enable click action after first loop
- 07-11-2016 - Enable scroll after expand action
- 18-10-2016 - Support for flv files and VPAID with flash creatives; choose the best file to play according to priority (VAST redirects)
- 06-10-2016 - Logging data for the small player