Radiant Media Player

VPAID ads



VPAID documentation sections


VPAID definition and scope of support

VPAID stands for Video Player Ad-Serving Interface Definition. It is a specification developed by the Interactive Advertising Bureau (IAB) which defines how an ad unit and a video player can interact with one another. VPAID add a new dimension to the VAST standard as it enables true engagement and interactivity with the ad viewer. VPAID is built on top of VAST and allows a video player to display rich interactive media ads (JavaScript executable ad unit for example).

Radiant Media Player supports the following types of VPAID ads in HTML5 video:

  • JavaScript VPAID 1 & 2 creatives

VPAID ads are supported with both the IMA SDK and rmp-vast. However VPAID support in rmp-vast is currently in BETA.


VPAID player setting

adVpaidMode: String

This setting applies only to the IMA SDK. A set of constants for enabling VPAID functionality with HTML5 video. Default: 'insecure'. Other accepted values are 'disabled' and 'enabled'.

  • 'insecure' means VPAID is enabled. The VPAID ad will load in a friendly iframe. This allows the ad access to the site via javascript.
  • 'enabled' means VPAID is enabled using a cross domain iframe. The VPAID ad cannot access the site. VPAID ads that depend on friendly iframe access may not play.
  • 'disabled' means VPAID is disabled. VPAID ads will be discarded when requested. An aderror event will be raised when this happens and content should resume.

See here for more information on the subject.

adVpaidControls: Boolean

By default the player does not show any controls when a linear VPAID ad is shown. It is expected that the VPAID ad would provide those controls if any are required. This setting lets you forces the display of controls during the display of linear VPAID ads. Only set adVpaidControls to true if required to support a specific use-case. Default: false.

adRmpVastEnableVpaid: Boolean

This setting applies only to rmp-vast. Enables support for VPAID ads in rmp-vast. Because VPAID support is currently in BETA this is an opt-in setting. Default: false.


VPAID player API

The general video ads API for the IMA SDK or rmp-vast can be used to control VPAID creatives. In addition the following method is available:

isVPAID()
rmp.isVPAID();

This method returns a boolean stating if the creative on stage is a JavaScript VPAID creative or not. It should be queried when the adstarted event fires. null is returned in case this value is not available.


VPAID support in rmp-vast

With Radiant Media Player 4.5.11 JavaScript VPAID 1 & 2 ads are supported in rmp-vast. Support is currently in BETA and we welcome any feedback either on our GitHub page or by contacting us directly.

The following limitations currently apply to VPAID support in rmp-vast:

  • no iOS or macOS Safari support (coming later)
  • supports only linear VPAID (non-linear support may be coming later)
  • no support for in-VPAID changes in linearity (likely to cause playback issues)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.