The following documentation pertains to context and brand-safety data partners looking to integration with the IRIS.TV Contextual Video Marketplace.
Below describes the typical integration and activation of contextual data partners in the IRIS.TV Contextual Video Marketplace.
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:
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",
"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