The following explains how publishers can pass video meta-data to IRIS.TV via the JW Player CMS.
Data Ingestion Methods:
IRIS.TV can support ingesting video meta-data via any of the following methods:
- Content Feed
- JW Player API V1.0
- JW Player API V2.0
Note: Please ensure that a link to the video file is accessible via the feed or API regardless of the integration method chosen.
JW Player Content Feed
The JW Player RSS feed is generated from the Dynamic Playlist interface in the JWPlayer UI. The Dynamic Playlist interface can be found under "Curated Playlists" in the "Manage" header.
Step 1: Creating the Playlist
Requirements for the playlist:
- Sort by is set to "Most Recently Published"
- The "List Length" is set to 99 items available
Step 2: Providing the RSS Feed URL to IRIS.TV
Once you have completed the above steps, copy the feed URL to share with IRIS.TV. To do this following these steps:
- Go to the Developers tab in the JW Player UI
- Copy the RSS URL you created
- Email to IRIS.TV
Sample Asset from JW RSS Feed:
<item>
<title>1736779881001_2733255905001_Romelu-Lukaku-first-goal-for-Everton.mp4</title>
<link>https://cdn.jwplayer.com/previews/m2c4Pq4Z</link>
<description></description>
<pubDate>Tue, 17 May 2016 15:00:24 -0000</pubDate>
<guid isPermaLink="false">m2c4Pq4Z</guid>
<enclosure url="https://cdn.jwplayer.com/videos/m2c4Pq4Z-LIy5BfaA.mp4" type="video/mp4" length="51"/>
<jwplayer:feedid>WceTDaam</jwplayer:feedid>
<media:group>
<media:content url="https://cdn.jwplayer.com/manifests/m2c4Pq4Z.m3u8" type="application/vnd.apple.mpegurl" duration="51"/>
<media:content url="https://cdn.jwplayer.com/videos/m2c4Pq4Z-7OMnOmZH.mp4" type="video/mp4" duration="51" width="320" height="178" fileSize="2967378"/>
<media:content url="https://cdn.jwplayer.com/videos/m2c4Pq4Z-ZdvV7Lxe.mp4" type="video/mp4" duration="51" width="480" height="266" fileSize="4345394"/>
<media:content url="https://cdn.jwplayer.com/videos/m2c4Pq4Z-LIy5BfaA.mp4" type="video/mp4" duration="51" width="720" height="400" fileSize="6081923"/>
<media:content url="https://cdn.jwplayer.com/videos/m2c4Pq4Z-DTFfSgRk.m4a" type="audio/mp4" duration="51" fileSize="728933"/>
<media:thumbnail url="https://cdn.jwplayer.com/thumbs/m2c4Pq4Z-720.jpg" width="720" />
<media:keywords></media:keywords>
</media:group>
<jwplayer:track file="https://cdn.jwplayer.com/strips/m2c4Pq4Z-120.vtt" kind="thumbnails"/>
</item>
Once you have provided the URL to IRIS.TV we can begin ingesting video meta-data into the IRIS.TV Video Data Platform.
JW Player API V1.0
To utilize the JW Player API V1.0 please following the following instructions.
Step 1: Locate the JW Player API Credentials:
The JW Player API credentials can be located in the API Credentials screen in the "Account" section.
Screenshot of where API Credentials is located
Step 2: Show API Credentials:
From the API Credentials page, client "Show Credentials" to reveal the API key and secret for the client.
Note: These are the clients only API Credentials and cannot be modified or revoked
Screenshot of API Credentials page
Step 3: Send Credentials to IRIS.TV:
Once you have provided the API key and API secret to IRIS.TV we can begin ingesting video meta-data into the IRIS.TV Video Data Platform.
JW Player API V2.0
To utilize the JW Player API V1.0 please following the following instructions.
Step 1: Locate the JW Player API Credentials:
Follow the above steps and provide IRIS.TV the following:
-
Secret token for use in an authentication header (no expiration)
-
A site_id(s)
Note: Each publisher has at least one site_id. A site_id, sometimes called “property ID”, can be considered a sub-account of the publisher. Additionally, secrets can have their access restricted to a subset of site_ids, and even to a set of assets under a site_id.
Step 2: Send Credentials to IRIS.TV:
Once you have provided the above credentials to IRIS.TV we can begin ingesting video meta-data into the IRIS.TV Video Data Platform.