Amagi Integration

The following explains how publishers can add IRIS.TV data to their Amagi channels.

There are 5 steps to add IRIS.TV data to channels powered by Amagi:

  1. Providing video data to IRIS.TV 

  2. Adding IRIS.TV data to each video in the Amagi platform

  3. Passing IRIS.TV data into the Amagi SSAI (Thunderstorm)

  4. Passing IRIS.TV data to ad servers partners

  5. Passing IRIS.TV data to SSP partners

Step 1: Pulling video data from Amagi:

IRIS.TV has a central integration with the Amagi Channel API enabling IRIS.TV to gain access to a publishers video metadata without any development work needed by the publisher.

Providing Channel API Access to IRIS.TV:

Publishers should provide the following Channel API credentials to IRIS.TV:

  • Channel Code

  • Channel ID
Once the above credentials are provided, IRIS.TV will do a historical ingest of all videos in the channel and set up the ongoing pull requests to receive future videos added to the channel.

Step 2: Passing IRIS.TV data back to Amagi:

IRIS.TV will push the IRIS_ID (ex: iris_2hd85jf93or95be) and contextual segments (ex: ic_123456) to the Amagi Metastore API, using the Amagi video ID to identify assets.

IRIS.TV will only have the ability to update the following meta data fields in the Amagi Metastore for each video:

  • iris_id: iris_2hd85jf93or95be

  • iris_context: ic_123456

Step 3: Amagi HLS passing IRIS.TV data to the SSAI:

Once the IRIS.TV data have been added to Meta-store Amagi will ensure they are passed through the manifest at the time of playback to the Amagi SSAI.

Step 4: Amagi SSAI (Thunderstorm) passing IRIS.TV data to the ad server:

Once the IRIS.TV data is passed to the SSAI, Amagi will add two custom macros to the ad tags provided to them.

Step 5: Passing IRIS.TV data to the SSPs:

Once the IRIS.TV data has been passed to the ad server the publisher will need to update their connection with each SSP per our normal process/steps for each SSP. See here for further documentation.