SSAI: Ad Block Detection and Auto-Failover

Product(s)
Video Cloud
Brightcove Player
SSAI
Role(s)
Player Developer
Topic(s)
Advertising

In this topic, you will learn how to turn on a Brightcove Player's auto-failover setting to request SSAi (Server Side Ads Insertion) ads when ad blockers are detected.

Overview

With ad failover turned on, when Brightcove Player detects an ad blocker present in the browser the player will automatically request an SSAI stream. Otherwise, it will use IMA ads.

Caveats

  • Ad blocker detection is very reliable, but not 100%.
  • Customers using this feature must be using Dynamic Delivery.
  • Only IMA and SSAI plugins are supported (no FreeWheel or OnceUX).

Player sample

Here is a sample player configured with IMA3 ads which will auto-failover to server-side ads when an ad blocker is detected in the browser.

  • Without ad blocker

    If you run the Codepen sample below in a browser without an ad blocker, you should see a DFP inline skippable ad by Google. This is the IMA3, client-side preroll ad:

    Client-side ad

  • With ad blocker

    If you run the Codepen sample below in a browser with an ad blocker, you should see a Brightcove guide to digital marketing ad. This is the Server-side ad (SSAI) as defined in our ad configuration:

    Server-side ad

Try running the Codepen sample below with and without an ad blocker.

See the Pen SSAI Auto-Failover by Brightcove Learning Services (@rcrooks1969) on CodePen.

Getting started

To play server-side ads from Video Cloud, you must follow these steps:

  1. Create an ad configuration
  2. Create a Brightcove player
  3. Implement auto-failover using Studio

Create an ad configuration

The ad configuration defines various aspects of SSAI playback, including ad calls, beacons, and other configuration options. Your ad response can be VAST, VMAP or DFP Ad Rules.

For details about creating and managing your ad configurations, see the Video Cloud SSAI Ad Config API document.

Create a Brightcove player

Create a new Brightcove player using Video Cloud Studio. For details, see the Quick Start: Creating and Styling a Player document.

Implementing auto-failover using Studio

The easiest way to configure your player for auto-failover ads is with Video Cloud Studio. Once you have created an ad configuration and player, then you are ready to configure the player for auto-failover as follows:

  1. Open the PLAYERS module and locate the player to which you want to add advertising functionality.
  2. Select the link for the player to open the player's properties.
  3. Select Advertising in the left navigation menu.
  4. Check the Enable Client-Side (IMA) checkbox.
  5. Include the URL for your IMA Ad Tag. For this example, we will use the sample Ad Tag URL.

    Enable client-side ads
    Enable client-side ads

    For details about the player advertising properties, see the Configuring Player Advertising using the Players Module document.

  6. Check the Enable Server-Side (SSAI) checkbox.

  7. From the Select Configuration dropdown menu, select the ad configuration that you would like to associate with this player.
  8. If you want overlays to display over your ads, check the Enable ad information overlays checkbox. This includes "Learn More" and ad count down overlays.
  9. Ad block detection with server-side ad failover is enabled automatically when you enable both client-side and server-side ads.

    SSAI advertising in Players module
    SSAI advertising in Players module
  10. Select Save.
  11. To publish the player, select Publish & Embed > Publish Changes.

    That's all you need to do to enable auto-failover for your player.

Play a video with ads

Any video that you retrieve from Video Cloud that has been ingested with Dynamic Delivery, will include the client-side IMA ads when no ad blocker is detected. When an ad blocker is detected, your video will include server-side ads specified in the VMAP file in your ad configuration. Note that the video needs to have an audio track associated with it for SSAI to work.