Below is information pertaining to how IRIS.TV’s Video Data Platform integrates with a publisher's Electronic Program Guide (EPG).
Accepted Methods for Video Asset Metadata Ingestion
IRIS.TV supports the following EPG formats for ingest:
- EPG available via API, formatted in JSON or XML.
- EPG available via URL, formatted in CSV.
Once you have sent IRIS.TV your EPG to access your assets, IRIS.TV will ingest your video data into a secure account.
Feed Pagination
Please notify your IRIS.TV TAM for how your EPG is scoped. This could be one of the following:
- Date scope: Date parameters are passed into the URL to pull data for a specific date
- Offset parameter: Feed parameters that allow for calling a specific number of assets and an offset for how far to go into the feed.
- Next link pagination: a link for the next page is included in the current page
- No pagination: The feed is one large file
Metadata Requirements
IRIS.TV has ranked metadata requirements in two sections (actual field names can vary):
- Required – this data is necessary to create contextual segments for your assets.
- Optional – this data can improve the contextual segmentation for your assets.
Required Metadata Fields
These fields are necessary to create contextual segments for your assets. If title and GUID are not sent, no context can be provided. The rest of the fields can have null values.
- Title : The video assets title.
- GUID: The unique numeric identifier of the asset.
- Publishers should confirm what ad server parameter the GUID will be passed through to retrieve IRIS data.
- Description: A description for the asset.
- Tags: Any keywords or tags associated with the asset. This should also include categories that are included in the publisher's taxonomy.
- Original Air Date: The date of asset's original airing (requirement for CTV VOD/streaming pubs) (UTC milliseconds since epoch).
- Publish Date: The date/time when the asset record was first published on your web site or video application (UTC milliseconds since epoch)
- Update Date: The date/time when the asset record was last modified (required) (UTC milliseconds since epoch).
- Duration: The duration of the video in seconds.
- Thumbnail URL: The URL for thumbnail or image that you want to represent your asset. For best results, the image should be at least 300 pixels (width) with a 16:9 ratio.
- If the following data exists please add:
- State: The active or inactive state of the video in your CMS.
- Show Name: The title of the show.
- Season Number: The numerical season that the episode is in. This should be formatted as an integer.
- Episode Number: The order that the episode is in for the season. This should be formatted as an integer.
- Genre: Topic categorization of the asset (ex. action, documentary).
- Language: The language of audio in the video.
- Transcript URL: url that refers to transcript or closed caption data.
Optional Meta Data
This data can improve the organization and categorization of your assets.
- Video URL: A link to asset’s video file from either your CDN or CMS (mp4 or m3u8 format is required).
- Expiration Date: The date when video should no longer be accessible to viewers (UTC milliseconds since epoch).
- Sensitive/Explicit Content: A flag to show a video contains sensitive or explicit content.
- Rating: TV or MPAA rating.