MRSS feed elements for Video Solutions

This is the new version of the MRSS feed specification for Video Solutions.
This version simplifies the ingestion of MRSS content sources, and allows for improved error handling and syncing. The table lists all of the fields that Video Solutions recognizes (and in some cases, expects) in your XML feed. Only these elements are recognized.

The content ID is now case sensitive. A content ID with both uppercase and lowercase letters is considered separate from the same ID with only lowercase letters. This is reflected in your Ad Manager reports.

Required elements

Element

Child element of

Requirement

<atom:link>

<channel>

Required

DescriptionIdentifies the feed's paging information. Ad Manager reads this element for two attributes: rel and href.

rel indicates how the URL in the href attribute relates to the feed's result set.

rel='next': Indicates that the href URL points to the next page of the feed's result set. If the feed contains an <atom:link> tag with rel='next', this indicates that there's another page of results. Otherwise, the current page is the last page in the result set.

href specifies a URL that identifies the resource in the <atom:link> tag.

DescriptionStored as the CMS content ID in Ad Manager, this is an important request parameter, formed as a part of the ad request to identify which ads Ad Manager can serve against the corresponding video. This value can be used for the vid parameter on a video ad request. It can be numeric or alphanumeric, and is case sensitive.

You can add up to three thirdPartyContentId elements per video. This may be necessary if you syndicate the video to multiple third-party CMSes, so you can link them to the <dfpvideo:contentId> from your MRSS feed and define the necessary metadata only in one place (the MRSS feed). The video IDs from each CMS are unique globally. For example, two YouTube videos can never have the same ID.

This element has attributes that provide useful metadata information, such as the source URL and duration. It is an optional sub-element of <item>.

Ad Manager can read the following attributes of the <media:content> element:

"duration" attribute: Ad Manager only recognizes one duration entry per <item>. If more than one is specified, the duration is chosen from an entry at random, which may be unexpected. This attribute is required to deliver mid-roll ads.

The duration value should be in seconds (whole numbers, no decimals).

"url" attribute: The direct URL of the video resource, used only to show a link in the content details within the Ad Manager interface.

DescriptionDetermines whether the video is marked as active, deleted, or inactive in Ad Manager. If this element is absent, the default status is active. Values are case insensitive and may include the following state:

active (marked "Active" in Ad Manager)

deleted (marked "Archived" in Ad Manager; new "deleted" videos are not ingested)

blocked (marked "Inactive" in Ad Manager)

If a user changes the status for a video within Ad Manager, any subsequent status changes from the feed are ignored. A user can remove the override by clicking "Use source setting" in the Ad Manager interface, after which Ad Manager will resume using status updates from the feed.

DescriptionAllows the thumbnail of the video to appear in the Ad Manager interface. Ad Manager currently only needs the URL attribute of this element, but you can provide additional attributes if desired: height, width, and time (the offset at which the frame shown in the thumbnail appears in the video).

The Ad Manager interface never displays a thumbnail larger than 280 pixels wide and 190 pixels high. If the url links to a larger image, Ad Manager links to the original version but visually scales the image with inline CSS for display in the UI.

A unique 14-character alphanumeric ID for premium TV content, like TV shows and movies, used to relate the program to TV schedules or movie showtimes. These ID are specific to a program's title, description language, and version. They are used for recognizing and synchronizing entertainment assets.

The value for a tmsId should begin with EP (episode), MV (movie), or SP (sports).

Node for specifying the video ingest URL to the master m3u8 file used for conditioning and playlist generation.

"type" attribute: should be set to HLS (application/x-mpegURL) or DASH (application/dash+xml).

"preconditioned" attribute: should be set to true or false to indicate if the ingestURL for this content is already conditioned for mid-roll ads, which means that your segments are already split at the time of ad breaks. This attribute defaults to false if not explicitly set.

Content is considered conditioned if the video segments in your stream are timed precisely for cue points to insert ads. If so, there should be a #EXT-X-PLACEMENT-OPPORTUNITY marker in the HLS stream to indicate to Ad Manager that an ad break should be inserted at this point in the video content.

Node for specifying the URL to the closed caption/subtitle file. All available closed captions files should be provided in the feed as multiple closedCaptionUrl elements -- one caption file per language.

The formats supported are TTML/DXFP (application/ttaf+xml) and WebVTT (text/vtt).

"language" attribute: should be set to the language of the caption file. This attribute is used similar to the xml:lang attribute detailed in the XML.

"type" attribute: should be set to the MIME type of the caption files.