Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • client_token: Authentication string associated with each client. This will be provided by IRIS.TV once the content feed is imported.

  • platform_id: The reference ID for the video asset from the publisher’s CMS.

...

  1. IRIS.TV Context Script is loaded with the page.

  2. The Context Script is initialized.

  3. Call the Context Script with the platform_id for the video asset that is about to play to receive the videos asset’s contextual segments.

  4. Add the contextual segments to the pre-roll ad tag.

This process should be repeated as you iterate through the video playlist.

Excerpt

Installing the Script

NOTE: The script should be loaded as a high priority to ensure you can receive context information for the pre-roll of the initial videoasset.

An example of adding the script to your page HTML:

Code Block
languagehtml
<script src=”https://ovp.iris.tv/libs/context/iris-context.min.js” type=”text/javascript”></script>

If you do not want to load the script as a high-priority, there is an event that you can listen to at the global changes to ensure that the context methods are available. An example of setting up that event listener:

Code Block
window.addEventListener(‘IrisContextAPI’, function() {
    // window.IrisContextAPI is ready to be used
});

Initializing the Script

  • To initialize the script, provide your client token to the IrisContextAPI Object

Code Block
languagejs
   var IrisContext = window.IrisContextAPI({
      client_token: '<your client token here>'
   });

...

Once the script is initialized, you can send in a video an asset ID to receive the context segment on the video. These methods are:

  • getContext – requests the context information for the video asset ID.

  • getVideoInfo – requests context category information for the video ID.

...

Parameter for get_context methods:

  • platform_id: the CMS reference ID of the video. Required.

Please confirm with your IRIS.TV representative

  • Where the context field should be added within the ad tag (i.e. in the “cust_params” field in a DFP tag).

getContext

To retrieve the context use the following method:

...

Code Block
{
  platform_id: '6026440620001',
  context: ["e883d22ce29c85f9e910281d2a410c5bad77a098"segment_1", "segment_2"]
}