Data Partner Integration

The following documentation pertains to context and brand-safety data partners looking to integration with the IRIS.TV Contextual Video Marketplace.

Integration Workflow:

Below describes the typical integration and activation of contextual data partners in the IRIS.TV Contextual Video Marketplace.

IRIS.TV Data Partner Integration Workflow

Integration Overview:

Step 1: Providing Video Data to the Contextual Data Partner

IRIS.TV will send publisher video metadata and URLs to contextual data partners for processing.

For each new video asset IRIS.TV will:

  • Send enrichment HTTP Post requests with a JSON body of video metadata

  • Use the video URL to identify the video asset

Video Metadata will include:

  • Title

  • Description

  • Length Seconds

  • Source Keywords

  • Thumbnail URL

  • Video URL

    • either MP4 or m3u8

  • VTT file or Transcript (where available)

Sample video asset metadata JSON:

{
"source_url" : "https://cbsi-drphil-video-fastly.global.ssl.fastly.net/2020/02/11/1696087107539/18066_5-f1bce056_444291_5192.mp4",
"title" : "‘You Are A Loudmouth Bully,’ Dr. Phil Says To Guest",
"description" : "‘You Are A Loudmouth Bully,’ Dr. Phil Says To Guest",
"length_secs" : 136,
"thumbnail_url" : "https://cbsi-drphil-video-fastly.global.ssl.fastly.net/2020/02/10/18066_5_video_640x360-e44050dc.jpg",
"source_keywords" :
[
"behavior",
"dad",
"Psychologist",
"talk",
"News",
"dr phil show",
],
"transcript" : "https://cbsi-drphil-video-fastly.global.ssl.fastly.net/2020/02/10/18066_5-e13346aa.vtt"
}

Step 2: Sending Contextual Segments to IRIS.TV

Contextual data partners will send segments for each video to IRIS.TV to be stored and activated via IRIS.TV’s ad server integrations:

  • Data segments will be sent via an HTTP Post to IRIS.TV with a JSON body containing the segments

  • The video URL will be used to identify the video asset

 

Step 3: Activating Contextual Segments

  • IRIS.TV will store contextual data partners segments as 3rd party meta-data on each videos asset record in the IRIS.TV system
  • When a video is viewed IRIS.TV will send contextual data partners segments to the publishers ad call in the form of a key value pair