Versions Compared

Old Version 26

changes.mady.by.user Richie Hyden

Saved on

compared with

New Version 27

changes.mady.by.user Zachary Stockton

Saved on

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 the

...

Ingest

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

Accepted Methods for

...

Ingest

IRIS.TV supports the following feed formats for video data importingasset library ingest:

  • MRSS

  • RSS

  • XML

  • JSON

  • API

Once the publisher has sent IRIS.TV a content feed or API to access their video dataassets, IRIS.TV will ingest data into a secure account for the publisher. Content feed integrations Integrations typically take less than one week.

...

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

...

IRIS.TV recommends that feeds are ordered by a "updated_at" field on the assets. That ensures that all asset updates are imported ingested into the system.

Metadata Requirements

IRIS.TV has ranked metadata requirements in three sections:

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

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

  • Optional – this data will help IRIS.TV parse the publishers feed and understand the state of your assets.

Excerpt

Required Meta Data

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

  • "title/name": Video asset Asset title

  • "sourceURL": Media content source URL

Preferred Meta Data

  • "description": Video asset Asset description

  • "categories": Taxonomical structure 

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

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

Optional Meta Data

  • "startDate": The Availability start date. If null/omitted then the publishedDate will be used.

    • "endDate": The Availability end date. If omitted, then recency business rules will be used for content expiration.

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

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

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

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

    • "length": The duration of the video in milliseconds"itemState": ACTIVE - asset is available for recommendation with IRIS.TV // INACTIVE - asset is not available for recommendation with IRIS.TV

    Sample Video 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"
},

    After the Initial

    ...

    Ingest

    Once the initial import ingest is complete, IRIS.TV will provide you with credentials to start the Context Script or Context API integration. These credentials include:

    ...

    The integration will also require the use of a “platformplatform_id”id. The platform_id is mapped in from the unique ID field during the importingest. Once you have received the above credentials from IRIS.TV, please move to Retrieving Contextual Data.