Uploading content using RSS
From ThirdPresence Wiki
ThirdPresence supports a ThirdPresence RSS format for automatizing the content fetching from the customers' web sites. Usually any content management system (CMS) is able to provide RSS feeds of the content and it is easy to configure the feeds to contain certain fields on certain formats.
For doing the RSS integration to ThirdPresence, following steps need to be taken:
1. Configure your CMS to output correctly defined XML format (see RSS feed example below) - should take very little time to complete with most CMSes. You can validate feed with W3C validator http://validator.w3.org
2. Notify us about the feed URL or create a new category using API and add the RSS feed URL as the category's source
3. RSS feed is now integrated to ThirdPresence and the system is automatically polling the feed
High-level structure of the RSS feed
If required, RSS format provides extensive support for e.g. advertising and DRM, but it can used in a simple form for simply defining the new video files for publishing. The high-level structure of the RSS feed is following:
<feed>
Define information about the feed:
<basic information about the feed/>
<ad platform details/>
<category-specfic information for publishing/>
<DRM protection details/>
Define Video files:
<first video entry/>
...
<last video entry/>
</feed>
For a simple integration, specifying all the meta-information about the feed can be omitted and simply listing all the video entries inside <feed> tag is required. For simple integration, see Video entry's XML tags and RSS feed example.
RSS feed example
Simple example of a standard RSS feed, showing how easily you can get started with the RSS integration:
<feed>
<entry>
<link rel="alternate" href="http://str.thirdpresence.com/show/movies/elephantsdream-480-h264-st-aac.mov"/>
<title>Elephants Dream</title>
<description>Elephants Dream is the story of two strange characters exploring a capricious and seemingly infinite machine.</description>
<pubDate>10.8.2009 07:06:15</pubDate>
</entry>
<entry>
<link rel="alternate" href="http://str.thirdpresence.com/show/movies/BigBuckBunny_640x360.avi"/>
<title>Big Buck Bunny</title>
<description>Big Buck Bunny | (c) copyright Blender Foundation | www.bigbuckbunny.org</description>
<pubDate>10.8.2009 07:49:09</pubDate>
</entry>
</feed>
Feed information XML tags
The XML fields for feed information part are divided to multiple sections.
Basic information about the feed
<title>[Feed title]</title>
<link rel="alternate" href="[Link to feed publisher homepage]" />
<subtitle>[Feed subtitle if required]</subtitle>
<thirdpresence:author>[Author's name]</thirdpresence:author>
<thirdpresence:owner>
<thirdpresence:name>[Owner name]</thirdpresence:name>
</thirdpresence:owner>
| Tag | Description |
| <title> | Optional: Feed title |
| <subtitle> | Optional: Additional title descirpition of the feed |
| <thirdpresence:author> | Optional: Feed author name |
| <thirdpresence:owner> | Optional: Aggregate for content owner information |
| <thirdpresence:name> | Optional: Content owner name |
Ad platform details
<thirdpresence:adplatform>[Used ad platform's name]</thirdpresence:adplatform>
| Tag | Description |
| <thirdpresence:adplatform> | Optional: Ad platform's name. Note: The ad platform must be integrated to ThirdPresence for the ads to work |
Category-specfic information for publishing
<thirdpresence:category>
<thirdpresence:categorytitle>[Category title]</thirdpresence:categorytitle>
<thirdpresence:iconurl size="small">[Absolute URL to category icon]</thirdpresence:iconurl>
<thirdpresence:iconurl size="large">[Absolute URL to category icon]</thirdpresence:iconurl>
</thirdpresence:category>
| Tag | Description |
| <thirdpresence:category> | Optional: Aggregate for category-specific information |
| <thirdpresence:categorytitle> | Optional: Title of the category (used in white-label publishing) |
| <thirdpresence:iconurl> | Optional: Define two entries with size attribute (small, large) that point to absolute URL containing the category icons (used in white-label publishing) |
DRM and Geo-IP protection details
<thirdpresence:protection>
<thirdpresence:accessRestrict>[Countries from which access is provided]</thirdpresence:accessRestrict>
</thirdpresence:protection>
| Tag | Description |
| <thirdpresence:protection> | Optional: Aggregate for digital rights management information |
| <thirdpresence:accessRestrict> | Optional: Two-character country codes separated with commas |
Video entry's XML tags
The XML fields for video entries are following:
<entry>
<link rel="alternate" href="[Absolute URL to source video file]"/>
<title>[Video title]</title>
<description>[Longer description of video file]</description>
<pubDate>dd.MM.yyyy hh:mm:ss</pubDate>
<thirdpresence:referenceId>[providerId]</thirdpresence:referenceId>
<thirdpresence:releaseDate>dd.MM.yyyy hh:mm:ss</thirdpresence:releaseDate>
<thirdpresence:expiryDate>dd.MM.yyyy hh:mm:ss</thirdpresence:expiryDate>
<thirdpresence:thumbnail>[Thumbnail URI]</thirdpresence:thumbnail>
<thirdpresence:addata startpos="[startpos in seconds]">[Advertisement data (absolute URL)]</thirdpresence:addata>
<thirdpresence:price>[e.g. 1.00]</thirdpresence:price>
<thirdpresence:currency>[Short name of the currency]</thirdpresence:currency>
</entry>
| Tag | Description |
| <entry> | Mandatory: Identifier tag for video file |
| <link> | Mandatory: Defines the absolute URL to source file file (note, add rel="alternate" as an attribute) |
| <title> | Mandatory: Title of the video file |
| <description> | Mandatory: Longer description about the video file |
| <pubDate> | Mandatory: The publishing date for the video (If set to current time, the video file will be published ASAP). Supported format for date & time is dd.MM.yyyy hh:mm:ss |
| <thirdpresence:referenceId> | Optional: Add provider specific static id for the content item |
| <thirdpresence:releaseDate> | Optional: Duplicate to pubDate |
| <thirdpresence:expiryDate> | Optional: Time and date for expiring the content (If not defined, then the video file will never expire). Supported format for date & time is dd.MM.yyyy hh:mm:ss |
| <thirdpresence:thumbnail> | Optional: Absolute URL for thumbnail image. ThirdPresence automatically creates thumbnail for video file, defining this parameter bypasses the thumbnail creation operation |
| <thirdpresence:addata> | Optional: Absolute URL for static advertisement video that will be tied with the source video. Define the insertion position of the static ad using startpos attribute. You can define multiple static advertisements for doing pre-rolls, post-rolls and interstitial ads |
| <thirdpresence:price> | Optional: End user price for the video. Note: Requires PPV integration |
| <thirdpresence:currency> | Optional: Used currency (Valid are at the moment: EUR / USD / GBP) Note: Requires PPV integration |
Complete RSS feed example
This example shows full RSS feed with feed information tags included:
<?xml version="1.0"?> <feed xmlns:thirdpresence="http://www.thirdpresence.com/ns/" xmlns="http://www.w3.org/2005/Atom"> <title>Title</title> <link rel="alternate" href="http://www.example.com/" /> <subtitle>Video</subtitle> <thirdpresence:author>Customer</thirdpresence:author> <thirdpresence:adplatform>Adplatform/Demo</thirdpresence:adplatform> <thirdpresence:owner> <thirdpresence:name>Content Owner</thirdpresence:name> </thirdpresence:owner> <thirdpresence:category> <thirdpresence:categorytitle>Show videos</thirdpresence:categorytitle> <thirdpresence:iconurl size="small">http://www.thirdpresence.fi/img/icon_small.png</thirdpresence:iconurl> <thirdpresence:iconurl size="large">http://www.thirdpresence.com/img/icon_big.png</thirdpresence:iconurl> </thirdpresence:category> <thirdpresence:protection> <thirdpresence:accessRestrict>fi</thirdpresence:accessRestrict> </thirdpresence:protection> <entry> <link rel="alternate" href="http://str.thirdpresence.com/show/movies/elephantsdream-480-h264-st-aac.mov"/> <title>Elephants Dream</title> <description>Elephants Dream is the story of two strange characters exploring a capricious and seemingly infinite machine.</description> <pubDate>10.8.2009 07:06:15</pubDate> </entry> <entry> <link rel="alternate" href="http://str.thirdpresence.com/show/movies/BigBuckBunny_640x360.avi"/> <title>Big Buck Bunny</title> <description>Big Buck Bunny | (c) copyright Blender Foundation | www.bigbuckbunny.org</description> <pubDate>10.8.2009 07:49:09</pubDate> </entry> </feed>This page was last modified on 29 November 2010, at 05:37.
