Skip to content

basil79/ads-manager

Repository files navigation

npm version downloads per week license

ads-manager

HTML5 Video Ads Manager based on @dailymotion/vast-client

This SDK supports:

  • VAST versions 2.0, 3.0 and 4.0+ up to 4.2 (included) - Complies with the VAST 4.2 specification provided by the Interactive Advertising Bureau (IAB).
  • Inline Linear
  • Wrapper
  • AdPod
  • Tracker for VAST tracking events
  • Media Types (Assets):
    • video/mp4; codecs=“avc1.42E01E, mp4a.40.2”
    • video/webm; codecs=“vp8, vorbis”
    • video/ogg; codecs=“theora, vorbis”
    • video/3gpp; codecs=“mp4v.20.8, samr” (Safari)
    • application/javascript (VPAID)
  • VPAID 2.0

This README is for developers who want to use and/or contribute to ads-manager.

Table of Contents

Usage

import AdsManager from 'ads-manager';

// Get your video element
const videoElement = document.getElementById('video-element');
// Get your HTML element for ad container
const adContainer = document.getElementById('ad-container');
// Define ads manager and pass ad container
const adsManager = new AdsManager(adContainer);
// Subscribe for events
// AdsManagerLoaded
adsManager.addEventListener('AdsManagerLoaded', function() {
  // Get height and width of your video element
  let width = videoElement.clientWidth;
  let height = videoElement.clientHeight;
  let viewMode = 'normal'; // fullscreen
  // Init
  try {
    adsManager.init(width, height, viewMode);
  } catch (adError) {
    // Play your context without ads, if an error occurs
  }
});
// AdError
adsManager.addEventListener('AdError', function(adError) {
  if(adsManager) {
    // Removes ad assets loaded at runtime that need to be properly removed at the time of ad completion
    // and stops the ad and all tracking.
    adsManager.abort();
  }
  // ... 
});
// AdLoaded
adsManager.addEventListener('AdLoaded', function(adEvent) {
  // Ad loaded, awaiting start
  // Check if ad type is linear
  if(adEvent.isLinear()) {
    try {
      // Start ad
      adsManager.start();
    } catch (adError) {
      // Play video content without ads in case of error
    }
  } else {
    // Ad is not linear
  }
});
// AdStarted
adsManager.addEventListener('AdStarted', function() {
  // Pause your video content
  videoElement.pause();
});
// ...
// AdDurationChange
// AdSizeChange
// AdImpression
// AdVideoStart
// AdVideoFirstQuartile
// AdVideoMidpoint
// AdVideoThirdQuartile
// AdVideoComplete
// AdPaused
// AdPlaying
// AdStopped
// AdSkipped
// AdClickThru
// ...
// AllAdsCompleted
adsManager.addEventListener('AllAdsCompleted', function() {
  // Play your video content
  videoElement.play();
});


// VAST tag url
let vastUrl = 'your VAST tag url';

// Request Ads
adsManager.requestAds(vastUrl);

/*
// VAST XML
let vastXML = `<?xml version="1.0" encoding="UTF-8"?>
    <VAST version="2.0">
      <Error><![CDATA[http://example.com/empty-no-ad]]></Error>
    </VAST>`;
adsManager.requestAds(vastXML);
 */

Documentation

For the full documentation:

Pre-bundled versions

Browser script

A pre-bundled version of ads-manager is available: ads-manager.js [minified].

You can add the script directly to your page and access the library's components through the adserve object.

<script src="ads-manager.js"></script>
// Get your HTML element for ad container
const adContainer = document.getElementById('ad-container');
// Define ads manager and pass ad container
const adsManager = new adserve.AdsManager(adContainer);

Install

Get Started

ads-manager is available as an NPM package and can be easily installed with:

$ npm i ads-manager 

Using Git

$ git clone https://github.com/basil79/ads-manager
$ cd ads-manager
$ npm ci

Build

To build the project for development:

$ npm run build:dev

To build the project for production:

$ npm run build:prod

This will generate the following file:

  • ./dist/ads-manager.js - Minified browser production code

Run

$ npm start

Then navigate to: http://localhost:8081 in your browser

Supported Browsers

ads-manager is supported all modern browsers.

Contribute

See CONTRIBUTING