Overview

Formerly named "Smart Video-Screening". The "Video canvas" creative template displays a video ad in the background, expanding to full-screen mode on mouse over.

Demo

Video canvas demo

Compliancy

Creatives

• Creative #1: optional banner; supported file formats: image (use transparency for better effects), creative script, HTML5
• Creative #2: optional video; supported file formats: mp4, webm (use files with high resolution and bitrate) - or - any VAST redirect containing the formats: mp4, ogg, webm, javascript (for VPAID only)
• Creative #3: optional banner shown after close; supported file formats: image, creative script, HTML5

Equativ strongly recommends to use HD video files for this ad format.

Note 1: 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 2: If the first or third creative is an creative script or HTML5, make sure you specify the size 

Note 3: If there is no third creative, the first creative will be displayed after close

Note 4: To get the behavior shown in this sample (transparent banner), add the first creative as a creative script and specify the width and height; then add the following code to make it transparent

<div style="width:750px;height:200px"></div>

Note 5: To avoid showing the banner after close (third creative), add the third creative as an empty creative script and set its width and height to 0.

Note 6: 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

Creative template parameters

Features

Event listening

The Video canvas 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. The Equativ visibility events always have a value of 100. Equativ logs the "fullscreen" event when the user goes to fullscreen mode. Also see the Report metric reference article.

Limitations

• works for web only (no mobile web supported!)
• IE 10, 9, 8 are not supported anymore

Known issues

n/a

Release notes

• 2024-09-25 - Add support for OMSDK
• 2024-01-24 - Removed support for obsolete macros
• 2023-04-05 - Update sas-libs version to 1.1
• 2023-03-27 - Select the most appropriate creative encoded version based on bandwidth and resolution
• 2020-05-13 - Remove start muted custom parameter
• 2019-03-25 - Hide player controls in non-expand mode
• 2019-02-05 - Viewability module improvements - Measures are now more accurate and more integrations are covered
• 2018-10-15 - Fix for creatives as creative script
• 2018-07-02 - Removed support for flash video 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-12-20 - Code refactoring + VAST4 support
• 2017-08-24 - Add click map
• 2017-08-16 - Support for standalone tag
• 2017-06-28 - Support for tagId ad call parameter