In-Stream Video Ad

Creative Type

Played before, during or after the streaming video content that the consumer has requested (Pre-roll, Mid-roll, Post-roll). These ads cannot typically be stopped from being played (particularly with pre-roll). This format is frequently used to monetize the video content that the publisher is delivering. In-Stream Video Ads can be played inside short or long-form video and rely on video content for their delivery. There are four different types of video content where in-stream may play: UGC (User Generated Content/Video), Syndicated, Sourced and Journalistic. In-Stream Video Ads are displayed within the context of streaming video content.

VIDEO ADVERTISING GLOSSARY, IAB

To get more information about the creative type please visit the website of the IAB and check the glossary.

Behaviour

The guxa.tv ad plugin is added to the publisher player as an ad server plugin, enabling the player to play pre- mid- and post-roll videos. Additionaly the plugin provides the necessary metadata to the publisher website to display companion ads.

To be most compatible with existing Ad Specifications, the plugin supports VAST 3.0 and VPAID Standart.

The communication between the plugin, the player and the website is done using events and a dedicated API.

The player informs the plugin when a new video content is ready for playing or provides information about the actual play time. These information is used to check if preroll, midroll or postroll ads are available. If this is the case, the player is paused, a snapshot is taken from the status and configuration, and a new configuration suited for ad videos is loaded. After the ad has ended or has been canceled the status and configuration of the player is restored to allow seamless video consumption to the enduser without disturbing additional configured plugins.

During Ad Playback all player events are prepended with a prefix, to allow deep integration with existing website features or App UX.

All actions, as well as all VAST tracking codes are logged to the corresponding servers for detailed measurement, providing valuable statistics for the advertiser.

Integration into Publisher site

First initialise the video.js video player. For a detailed instruction have a look at the setup guides.
Additionaly initialise the guxa.tv ad plugin.

  var settings = {
    "adTagUrl": "https://whatmore.guxa.tv/vast/wrapper/569F2B7A67.xml?ts=1485846526907",
    'skip': 5,
    'cappingFreeLunch': 0,
    'cappingMinimumTimeInterval': 0,
    'timeout': 3000,
    'prerollTimeout': 100,
    'postrollTimeout': 100,
    'stitchedAds': false,
    'debug': false,
    "player": {
      "responsive": false,
      "width": 320
    }
  };
  var videoSrc = [
    {
      "src": "//vjs.zencdn.net/v/oceans.mp4",
      "type": "video/mp4"
    },
    {
      "src": "//vjs.zencdn.net/v/oceans.webm",
      "type": "video/webm"
    }
  ];
  var player = videojs(
    'guxatv-instream-player', {
      'controls': true,
      'autoplay': false,
      'preload': 'auto',
      'poster': "https://dummyimage.com/320x180/000/fff",
      'loop': false,
      'fluid': true,
      'loadingSpinner': false
    }).ready(function () {
    //Initialise the plugin
    player.guxatvInstream(settings);
    player.src(videoSrc);
  });

Please notice that the Demo AdServer does not always deliver an Ad impression due to load limiting.
If you do not see an ad player please be patient and retry after a few seconds.

Options

Skip

Enable or disable the Skip Button. Timeout in seconds after which the user is allowed to skip. 0 disables the Skip button.
e.g.: ‘skip’: 5

CappingFreeLunch

How many videos are started before the next ad is displayed
e.g.: ‘cappingFreeLunch’: 0

CappingMinimumTimeInterval

How long (in ms) videos are played before next ad may be displayed
e.g.: ‘cappingMinimumTimeInterval’: 0,

Timeout

Timeout until an Ad has to be delivered by the Ad Server
e.g.: ‘timeout’: 3000

prerollTimeout

Timeout to start preroll video
e.g.: ‘prerollTimeout’: 100

postrollTimeout

Timeout to start postroll video
e.g.: ‘postrollTimeout’: 100

stitchedAds

Are there stiched ads in the video embedded
e.g.: ‘stitchedAds’: false

Events

Additionaly to all the events that are emitted through video.js, the plugin will emitt the following events.

adsready

The Plugin is ready to play ads.

guxatv-instream-ready

Triggered when a video ad is ready for playback and the player is completely initialised. This will be fired shortly before the video ad is displayed.

adplaying

This event is triggered when an ad starts playing.

guxatv-instream-ended

Triggered after the video ad playback has finished and normal video playback will restart.