Limited Availability - Do not share this document

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

Overview

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.

Caveats

  • 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. Select 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 preroll property
    IMA preroll property
  14. Select 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.