Versions Compared

Key

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

Overview: Below is information regarding pertaining to how publishers can integrate with the IRIS.TV Context Script for the Contextual Video Marketplace. The Context Script gives publishers you the ability to retrieve contextual information for a given video asset. This If you are a publisher and oversee your ad operations and tech stack, this is meant to be used as a part of your existing ad workflow to send contextual data through your ad server. This documentation will walk through how to add the Context Script and workflows for adding the contextual targeting data to your ad tags.

See an example implementation page here: https://ovp.iris.tv/demos/context/iris-context-api.html

...

Before adding the Context Script the following needs to be completed:

Excerpt
  • A feed with video URLs needs to be provided for IRIS.TV to import and add contextual data to assets. Video asset URLs need to link to either MP4 or m3u8 files.

  • An ad tag that can be appended with iris_context custom key-value pair.

  • Ad targeting on the iris_context key-value pair needs to be set up through the ad server.

Please speak to your IRIS.TV representative for details on these requirements.

This workflow requires two values:

...

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

  • getContext – requests the context information for the platform_idasset ID.

  • getVideoInfo – requests context category information for the platform_id.

...

Parameter for get_context methods:

  • platform_id: the CMS reference ID of the asset. 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

  • video. Required.

To retrieve the context use the following method:

...

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

After the Integration is Complete

Once the integration is complete and you’re receiving contextual segments, move on to Activating Contextual Data in order to add the data into your existing ad workflow.