Contact Support | System Status
Page Contents

    Client-Side Pre-roll Ads with Live SSAI

    In this topic, you will learn how use Brightcove Player to play a client-side pre-roll ad with live streams enabled for server-side ad insertion (SSAI).


    When delivering live streams with server-side ad insertion (SSAI) using Brightcove Player, you can insert a client-side pre-roll ad. For client-side ads, this feature supports IMA ads.


    • Customers using this feature must be using Dynamic Delivery.
    • Only IMA and SSAI plugins are supported (no FreeWheel).
    • Currently, this feature only supports a single player on the page.

    Getting started

    To play a client-side IMA pre-roll ad with a live SSAI stream, follow these steps:

    1. Create an SSAI-enabled live stream
    2. Create a Brightcove player
    3. Implement client-side pre-roll using Studio

    Create an SSAI-enabled live stream

    The Live module supports Server-Side Ad Insertion (SSAI) enabling server-side ads can be requested and displayed during a live stream. To create your live stream, see the following:

    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 client-side pre-roll 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. In the left navigation menu, select Advertising.
    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.
      Enable SSAI
      Enable SSAI
    9. Click the Save button.
    10. In the left navigation menu, select JSON Editor.
    11. In the JSON editor, scroll down until you see the ad_failover: true property.

      Ad failover property
      Ad failover property
    12. Replace the ad_failover: true property with the following:
      "ima_preroll_with_ssai": true
    13. Your JSON editor should look similar to this:
      IMA pre-roll property
      IMA pre-roll property
    14. Click the Save button.
    15. To publish the player, select Publish & Embed > Publish Changes.
    16. Now, you are ready to publish your live event. For details, see the Implementing Server-Side Ads in the Live Module document.

    Page last updated on 17 Jun 2021