Page tree

Versions Compared

Key

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

...

Important: If you use <vmrss:metadata> to define categories, then in <media:category> you should use the string you used for the path attribute (in <vmrss:metadata>), as the user visible category name will be taken from the value of the label attribute of <vmrss:categoryData>.

Example:


 

Code Block
languagexml
 <vmrss:metadata>
    <!-- 1st category level. -->
    <vmrss:categoryData order="1" path="videos" label="Clips" description="Section with cool clips."/>
    <!-- 2nd category level. -->
    <vmrss:categoryData order="1" path="videos/fail" label="Fail Compilations" description="Fail compilations" thumbnail="http://domain.com/category55image.jpg" thumbwidth="256" thumbheight="144" />
    <vmrss:categoryData order="2" path="videos/cats" label="Cute Cats" description="All the cute cats in one place" thumbnail="http://domain.com/category55image.jpg" thumbwidth="256" thumbheight="144" />
    <!-- 3rd category level. -->
    <vmrss:categoryData order="1" path="videos/cats/black" label="Black Cats" description="Only black cats" />
    <vmrss:categoryData order="2" path="videos/cats/white" label="White Cats" description="Only white cats" thumbnail="http://domain.com/category55image.jpg" thumbwidth="256" thumbheight="144" />
</vmrss:metadata>

 


The Item tag

The following children of the <item> tag are required:

...

  • <pubDate> publication date of the video. It is used in different ways:

    • it is visible to the end user in the description of the video

    • it is used in the auto-generated Latest Videos category where videos are sorted by publication date

    • it is used when auto-generating categories based on publication date (for apps built on one MRSS feed without category information)

  • <media:description> if it exists it will be displayed as the description for the video.

  • <media:keywords> for content keywords. Keywords are indexed by an application and used for search purposes. Keywords can be also used instead of categories if this option was chosen during submission (field ‘Use keywords to define categories’ must be selected).

  • <media:subTitle> for specifying the subtitles as follows:

    • Must contain href or url attribute that points to the subtitle file in the WebVTT format. Other formats are not guaranteed to be supported on all devices.

    • Must contain lang attribute to define subtitle language based on the RFC 3066

    • More than one such tag per media element can be used e.g. once per language.

  • <vmrss:orderInCategory> is used to set the order of the item in the category. If an item is in many categories then it can have the order set to each category separately. It requires two attributes:

    • path with the same value as defined in the category

    • value as a number (ascending)

Item structure:


 

Code Block
languagexml
<item>
    <pubDate>Mon, 21 Mar 2016 11:00:01 GMT</pubDate>
    <media:title>
        Sam Smoothy Follows His Fathers
        Footsteps In The Andes | Lost…
    </media:title>
    <media:description>
        Many years ago, Sam Smoothy’s father
        climbed in the Andes mountains…
    </media:description>
    <media:category>Skiing</media:category>
    <media:category>Winter/Events</media:category>
    <vmrss:orderInCategory path="Winter/Events" value="12"/>
    <media:content url="video.mp4" type="video/mp4" bitrate="2200" duration="772"/>
    <media:thumbnail url="thumb.jpg" width="256" height="144"/>
</item>

Feeds availability

Since our server are distributed, in general we require feeds to be accessible. It is important that your MRSS feeds are available worldwide without any restrictions to e.g. location, IP addresses, User Agents or other. If any restriction is set then TV Snap servers may not be able to access and present your content.

In case it is a must have to limit access to your feeds by white-listing IP addresses then please use the below list. Please note that we recommend to not apply any restriction if not really needed though.

The following IP addresses must be allowed to access MRSS feeds:

107.167.100.112
107.167.100.113
185.26.182.90
185.26.182.94
35.165.86.48
217.17.35.152/29
157.22.251.128/29
91.203.97.128/25
185.217.214.0/24
185.217.212.0/24

Feed re-indexing rate

Feeds are indexed by our ad system on submission. After that, we periodically check of changes in the feed and update our index. The refresh rate is around 6 hours for now. This means that any change to your content availability (adding or removing videos or change of metadata) might take up to 6 hours to show up in the actual application.

In the case where feeds include URL that may expire (e.g. URL includes a token that needs to be refreshed periodically), then such URLs should remain valid within those 6 hours periods plus in addition few more hours longer to let this change be propagated on devices where the application is launched.

Best practices

The MRSS feeds structure (e.g. categories, collections, items structure, and nesting) and content can be changed after submission. We recommend updating the video content in feeds periodically and often (especially adding new content) as an incentive for end users to run the app regularly.Although, the content structure should not change that often. (e.g. categories, collections, items structure, and nesting).

...

The example above uses few MRSS feeds - one for each Lifestyle, Music, Movies and Kids sections. Type of apps is a category defined in one of the MRSS feed. Latest Videos and Today's picks categories are generated automatically by the Vewd Snap.  

 


Example of TV Snap player.

...