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.