Contact Support | System Status
Page Contents

    SSAI: Ad Block Detection and Auto-Failover

    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.


    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.


    • 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).

    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 pre-roll 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. To create an ad configuration, follow these steps:

    1. In Video Cloud Studio, expand the ADMIN menu and select Server-Side Ad Settings.

      Ad configuration admin
      Ad configuration admin
    2. Add information for your ad configuration and select Save.

      Ad settings
      Ad settings

    For details, see the Configuring Server-Side Ad Settings document.

    To create an ad configuration using the SSAI API, 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.

    Page last updated on 09 Sep 2021