This plugin allows videojs to monetise its videos. To do so, it implements the VAST and VPAID specifications from IAB.
Currently we support VAST and VPAID Flash preroll ads. We are working to support VPAID HTML5 preroll ads, and we will add more VAST ad types as we need them.
It is important to notice that VPAID integration is still in beta and we have not yet released a stable version.
You can find a demo of the plugin working together with video.js here
To integrate the plugin with videoJs you need to:
1.- Add all files from bin to some path in your server
2.- If don't have videoJs, add their scripts and stylesheet to your page
<link href="http://vjs.zencdn.net/4.12/video-js.css" rel="stylesheet">
<script src="http://vjs.zencdn.net/4.12/video.js"></script>
3.- After videoJs add the plugin script stylesheet and swfobject (if you want to support flashvpaid) to your page
<script src="/path/to/swfobject.js"></script>
<link href="/path/to/videojs-vast-plugin.css" rel="stylesheet">
<script src="/path/to/videojs-vast-plugin.min.js"></script>
if you need to support older browsers add this to your page before the plugin script
<script src="/path/to/es5-shim.js"></script>
4.- Create you own ads plugin to pass an add media tag to the plugin
Below you have a simple ads-setup-plugin
vjs.plugin('ads-setup', function (opts) {
var player = this;
var adsCancelTimeout = 3000;
var vastAd = player.vastClient({
//Media tag URL
url: "http://pubads.g.doubleclick.net/gampad/ads?env=....",
playAdAlways: true,
//Note: As requested we set the preroll timeout at the same place thant the adsCancelTimeout
adCancelTimeout: adsCancelTimeout,
adsEnabled: !!options.adsEnabled
});
});You can also configure the vast plugin using the data-setup attribute
<video id="example_video_1" class="video-js vjs-default-skin"
controls preload="auto" width="640" height="264"
poster="http://video-js.zencoder.com/oceans-clip.png"
data-setup='{
"plugins": {
"vastClient":{
"url": "http://pubads.g.doubleclick.net/gampad/ads?env=....",
"adsCancelTimeout": 5000,
"adsEnabled": true
}
}
}'>
<source src="http://video-js.zencoder.com/oceans-clip.mp4" type='video/mp4'/>
<source src="http://video-js.zencoder.com/oceans-clip.webm" type='video/webm'/>
<source src="http://video-js.zencoder.com/oceans-clip.ogv" type='video/ogg'/>
<p class="vjs-no-js">To view this video please enable JavaScript, and consider upgrading to a web browser that <a
href="http://videojs.com/html5-video-support/" target="_blank">supports HTML5 video</a></p>
</video>Use it to pass the ad media tag, it can be a string containing the Media tag url
var vastAd = player.vastClient({ url: "http://pubads.g.doubleclick.net/gampad/ads?env=....", ... });
or a function that will return the Media tag whenever called
var vastAd = player.vastClient({ url: getAdsUrl, ... }); function getAdsUrl() { return "http://pubads.g.doubleclick.net/gampad/ads?env=...."; }On initialization, the plugin well call the function and store the returned Media tag to request the VAST/VPAID ads.
Flag to indicate if we must play an ad whenever possible. If set to true the plugin will play an ad every time the user watches a new video or replays the actual video. Defaults to false
Number of milliseconds for the ad to start before canceling it. Defaults to 3000
Flag to disable the ads. Defaults to false.
Flag to enable resize of the adUnit on window's
resizeandorientationchangeevents. This is useful for responsive players. Defaults to true
Path to the vpaidFlashloader swf file. It defaults to '/VPAIDFlash.swf'
An invocation to player.vastClient({...}) returns and object that with some helper functions that allow you to dynamically enable or disable the vast plugin, or check if it is enabled.
var vastPlugin = player.vastClient({
url: getAdsUrl,
playAdAlways: true,
//Note: As requested we set the preroll timeout at the same place thant the adsCancelTimeout
adCancelTimeout: adsCancelTimeout,
adsEnabled: !!options.adsEnabled
});
player.on('reset', function () {
if (!vastPlugin.isEnabled()) {
vastPlugin.enable();
} vastPlugin {
vastAd.disable();
}
});This function returns true if the player is enabled and false otherwise.
Enables the VAST plugin
Disables the plugin
The returned object described above it is also published as a player property so that you can use it anywhere as long as you have access to the player instance.
player.vastClient({
url: getAdsUrl,
playAdAlways: true,
//Note: As requested we set the preroll timeout at the same place thant the adsCancelTimeout
adCancelTimeout: adsCancelTimeout,
adsEnabled: !!options.adsEnabled
});
player.on('reset', function () {
if (!player.vast.isEnabled()) {
player.vast.enable();
} vastPlugin {
player.vast.disable();
}
});If you want to run the plugin you need to clone the repo into your local environment
git clone [email protected]:MailOnline/videojs-vast-vpaid.git
and install the dependencies
$ cd videojs-vast-vpaid
$ npm install
$ bower install
after installing the dependencies you are ready to go. If you want to see the available build tasks, run
$ gulp
[12:27:22] Using gulpfile ~/dev/mailOnline/videojs-vast-vpaid/gulpfile.js
[12:27:22] Starting 'default'...
Welcome to MailOnline's new
____ ____.__ .___ __ ____ ____ __ ____ ____ .__ .___
\ \ / /|__| __| _/ ____ ____ |__| ______ \ \ / /_____ _______/ |_ \ \ / /______ _____ |__| __| _/
\ Y / | | / __ | _/ __ \ / _ \ | | / ___/ \ Y / \__ \ / ___/\ __\ \ Y / \____ \ \__ \ | | / __ |
\ / | |/ /_/ | \ ___/ ( <_> ) | | \___ \ \ / / __ \_ \___ \ | | \ / | |_> > / __ \_| |/ /_/ |
\___/ |__|\____ | \___ > \____/ /\__| |/____ > \___/ (____ //____ > |__| \___/ | __/ (____ /|__|\____ |
\/ \/ \______| \/ \/ \/ |__| \/ \/
###### Below, you have the list of all the available build tasks ########
╔═════════════════════════╤════════════════════════════════════════════════════════════════════════════════╗
║ Name │ Description ║
╟─────────────────────────┼────────────────────────────────────────────────────────────────────────────────╢
║ start-dev │ Starts dev server and watch task. ║
║ │ If you use "--env production" everything will be minified ║
║ │ and the dist folder will be updated accordingly. ║
╟─────────────────────────┼────────────────────────────────────────────────────────────────────────────────╢
║ release │ Creates a new version of the player and releases it. ║
║ │ Increasing version, creating new tag and so on (--bump [patch(default)/minor/… ║
╟─────────────────────────┼────────────────────────────────────────────────────────────────────────────────╢
║ watch │ watches for changes on the plugin files and executes the appropriate tasks ║
╟─────────────────────────┼────────────────────────────────────────────────────────────────────────────────╢
║ build │ This task builds the plugin ║
╟─────────────────────────┼────────────────────────────────────────────────────────────────────────────────╢
║ build-demo │ Builds the demo ║
╟─────────────────────────┼────────────────────────────────────────────────────────────────────────────────╢
║ ci-test │ Starts karma test and generates test code coverage, to be used by CI Server ║
╟─────────────────────────┼────────────────────────────────────────────────────────────────────────────────╢
║ test │ Starts karma on 'autowatch' mode with all the libs, ║
║ │ sources and tests of the player ║
╚═════════════════════════╧════════════════════════════════════════════════════════════════════════════════╝
[12:27:22] Finished 'default' after 8.12 ms
Which will show you a table with the main build tasks. If you want start the demo locally just run:
$ gulp start-dev
and open the following link into your browser http://localhost:8085
videojs-vast-plugin is licensed under the MIT License, Version 2.0. View the license file
Copyright (c) 2015 MailOnline