Ad Intelligence Plugin

In this topic, you will learn how to use the Ad Intelligence plugin with Brightcove Player to generate reports that provide insights into ad performance.


Brightcove has partnered with Watching That to provide video and ad performance reports. The reports help you to identify issues, errors and opportunities. The data gives you an overview of the entire video chain from ad servers to players. Using this information, you can optimize ad fill rate and yield.

Some of the ad metrics include:

  • Ad delivery
  • Ad diagnostics
  • Ad viewing events

Here's an example showing fill rate and error rate data:

Multi-metric visualization
Multi-metric visualization


The following notes refer to this feature:

  • The Ad intelligence plugin works on top of Brightcove Player. The plugin works with both VOD and live content.
  • The plugin focuses on CSAI, which limits Ad insertion for live streams to pre-rolls only.


The following requirements are needed to use the Ad Intelligence plugin:

  • Brightcove Player v6.58.0 and newer
  • Contact your account manager to get your Watching That API key

Implement using Players module

To add the Ad Intelligence plugin to a player, follow these steps:

  1. In Video Cloud Studio, navigate to the Players module.
  2. Click the link for the player that you want to add the plugin to.
  3. In the left navigation, select Plugins.
  4. Expand Add a Plugin, and select Custom Plugin.

    Custom Plugin
    Custom Plugin
  5. For the Plugin Name, enter wtAdTracer.
  6. For the JavaScript URL, enter the following:
  7. For the Options(JSON), enter the following with your own API key value :

      "apiKey": "your api key"
  8. Your plugin details should look similar to this:

    WT plugin values
    WT plugin values
  9. Click Save.
  10. Re-publish the player. Once the player is published, contact customer support to confirm that the Data is being received correctly.

For a deeper integration with Watching That, provide your CMS API credentials to your account manager during onboarding for this feature.

Implement using code

To implement a plugin, the player needs to know the location of the plugin code, the plugin name and plugin configuration options.

  1. Include the plugin code:
  2. Use the plugin name to load it into the player: wtAdTracer
  3. Include a player option with your API key:

      "apiKey": "your api key"
  4. Here is an example using the Advanced Embed implementation to associate the Playlist Endscreen plugin with a single instance of a player.

    <div style="max-width: 960px;">
      <video-js id="myPlayerID"
        data-account="your account ID"
        data-player="your player ID"
        data-video-id="your video ID"
    <script src=" account ID/your player ID_default/index.min.js"></script>
    <!-- script for the Ad Intelligence plugin -->
    <script src=""></script>
    <!-- custom script -->
      videojs.getPlayer('myPlayerID').ready(function() {
        var myPlayer = this;
        // initialize the Ad Intelligence plugin
        myPlayer.wtAdTracer({"apiKey": "your api key"}); 


You may pass in an options object to the plugin upon initialization. This object may contain any of the following options:


  • The API key from your Watching That account.
  • Type: string
  • Default: ""

Ad performance report

The Ad performance report will be sent to the email address that you provided during onboarding for this feature.