Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview: Below is information pertaining to how IRIS.TV’s Contextual Video Marketplace integrates with a publisher's content management system (CMS) via a feed or API.

Setting Up Video Asset Metadata Ingestion

IRIS.TV supports a wide range of feed and data formats to handle content feed ingestion. Below are lists of accepted ingest methods and metadata requirements for adding contextual segments to your video content.

Accepted Methods for Video Asset Metadata Ingestion

IRIS.TV supports the following feed formats for asset library ingest:

...

Once your have sent IRIS.TV a feed or API to access your assets, IRIS.TV will ingest your video data into a secure account. Integration typically take takes less than one week.

Recommendations for Feed Pagination

If you are providing a content feed (rather than an API) for content ingestion, IRIS.TV recommends using pagination so that your full library can be ingested for contextual segmentation. IRIS.TV supports the following pagination methods:

  • 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.

...

  • Required – this data is necessary to create contextual segments for your assets.

  • Preferred – this data will likely improve the contextual segments segmentation for your assets.

  • Optional – this data will help IRIS.TV parse the publishers feed and understand the state of your assetscan improve the contextual segmentation for your assets with some data partners.

Excerpt

Required Meta Data

  • "id/GUID": (unique numeric identifier of asset)

  • "title/name": Asset title

  • "sourceURL": Media source URLlink to asset’s video file from either your CDN or CMS

Preferred Meta Data

  • "description": Asset description

  • "categories": Taxonomical structure 

  • "keywords/tags": Keywords or tags associated with the asset

  • "transcript": Either the transcript text or link to a transcript file for the videoasset

Optional Meta Data

  • "publishedDate": The date/time when the video asset record was first published on your web site.

  • "creationDate": The date/time when the video asset record was published. 

  • "lastModifiedDate": The date/time when the video asset record was last modified

  • "thumbnailURL": URL to a thumbnail or image that you want to represent your videoasset. For best results, image should be at least 300 pixels (width) with a 16:9 ratio.

  • "length": The duration of the video asset in milliseconds

Sample

...

Asset from a Publisher

Code Block
languagejson
{
  "id": 5331690110001,
  "name": "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
  "shortDescription": "Donec congue orci vel ante posuere consectetur. Vestibulum vel eros velit. In suscipit arcu nec lectus posuere sagittis.",
  "creationDate": 1487717574502,
  "publishedDate": 1487717955852,
  "lastModifiedDate": 1487717955969,
  "startDate": 1487717955969,
  "endDate": null,
  "tags": [
    "alex rodriguez",
    "new york yankees",
    "mlb"
  ],
  "videoStillURL": "http://xxx/2157889318001_5331738223001_5331690110001-vs.jpg?pubId=2157889318001",
  "thumbnailURL": "http://xxx/2157889318001_5331738224001_5331690110001-th.jpg?pubId=2157889318001",
  "length": 30805,
  "economics": "AD_SUPPORTED",
  "categories": [
    "Baseball"
  ],
  "itemState": "ACTIVE",
  "SourceURL": "http://xxx/2157889318001_5331740038001_5331690110001.mp4"
},

...