Skip to content
English
  • There are no suggestions because the search field is empty.

Amazon s3 Content Ingestion

This page details how publishers can integrate with IRIS.TV via Amazon s3

Overview: This details how publishers can set up s3 integrations that can be used to:

  • Send assets to IRIS.TV
  • Retrieve a map of Content ID to IRIS_ID

Please Note: This doesn’t detail the format of the file itself. For those instructions please refer to Custom Content Feed Ingestion or Standard Feed Ingestion. Please reach out to your technical account manager if you’re using a custom JSON, XML, or CSV file.


Provisioning s3 Bucket

We recommend provisioning the s3 bucket and asking your TAM for the IRIS.TV AWS ARN. 

Uploading assets to s3

To upload assets to s3:

  • Please upload the file to the following path: s3://[bucket_name]/iris_tv_import/[file_name]
  • The file name should be the timestamp that the file was uploaded in UTC time formatted as YYYYMMDDhhmm_assets

An example of this would be: s3://publisher_bucket/iris_tv_import/202601271654_assets.json


IRIS.TV will check the bucket every 8 hours starting at 0000h UTC.


Retrieving the Content ID to IRIS_ID Map


After IRIS.TV processes the file, it’ll post a CSV of all Content IDs mapped to IRIS_IDs. That file will posted to:

  • Tthe following path: s3://[bucket_name]/iris_id_map/[file_name]
  • The file name should be the timestamp that the file was uploaded in UTC time formatted as YYYYMMDDhhmm_iris_ids



An example of this would be: s3://publisher_bucket/iris_tv_import/202601271854_iris_ids.csv


By default, this will be a CSV file.


Support

If you have any questions about this, please reach out to your technical account manager.