Radiant Media Player

Ad skipping



Documentation sections


Ad skipping scope of support

Offering ad skipping options to your audience is great way to monetise your content while providing a gentle and smart viewing experience. Radiant Media Player supports ad skipping in 2 ways:

  • VAST 3 skippable video ads: when a valid VAST 3 tag with skippable information (e.g. skip information are held within the VAST XML response) is presented to the player, it will automatically read that information and display a skip button when appropriate. This is available for the Google IMA and our rmp-vast VAST parser - no extra configuration is required.
  • Ad skipping through player settings: in this case skip information are not held within the VAST XML response but are passed to the player through player settings.

Ad skipping through player settings

Using VAST 3 skippable video ads (e.g. skip information held in the VAST XML response) is the preferred way to support ad skipping with Radiant Media Player. As an alternative we support configurable ad skipping through player settings with rmp-vast.

Configurable ad skipping through player settings is not available for the Google IMA SDK. VAST skippable ads must be configured with the ad-server when using the Google IMA SDK.

When both adSkipButton is set to true and a VAST skippable ad is detected, only one skip button will show and the VAST skippable data will take precedence.

adSkipButton: Boolean

When set to true this setting will enable the display of a skip button while a linear video ad is on stage. Default: false.

adSkipOffset: Number

Sets the time in seconds before the linear ad becomes effectively skippable. In-between the player will show a message and countdown announcing the soon-to-be available skip option. Default: 5.

It is also possible to customise the skip message and waiting for skip message through player labels.

Example:

Player code for the above example:

<!-- Include Radiant Media Player JavaScript file in your <body> or <head> -->
<script src="https://cdn.radiantmediatechs.com/rmp/4.9.0/js/rmp.min.js" 
  integrity="sha384-i3qlEyPNI8XWb4gU9AmU1cZeqZCeGI77B6wA4sq7fp7j8vvchcW54FuZrEACmZIF"
  crossorigin="anonymous"></script>
<!-- Set up your wrapper div with its unique id -->
<div id="rmpPlayer"></div>
<script>
// Our streaming URLs
var bitrates = {
  mp4: [
    'https://www.rmp-streaming.com/media/bbb-360p.mp4'
  ]
};
// Our player labels to customise our ad skipping messages
var labels = {
  ads: {
    controlBarCustomMessage: 'RMP ad',
    skipMessage: 'Skip this ad',
    skipWaitingMessage: 'Skip this ad in'
  }
};
// Our player settings
var settings = {
  licenseKey: 'your-license-key',
  bitrates: bitrates,
  width: 640,
  height: 360,
  ads: true,
  // Here we pass the ad skipping player settings
  adSkipButton: true,
  adSkipOffset: 4,
  adParser: 'rmp-vast',
  labels: labels,
  adTagUrl: 'https://www.radiantmediaplayer.com/vast/tags/inline-linear.xml',
  poster: 'https://www.radiantmediaplayer.com/images/poster-rmp-demo.jpg'
};
var elementID = 'rmpPlayer';
var rmp = new RadiantMP(elementID);
rmp.init(settings);
</script>
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.