How to Create a Feed - Importing MRSS Feeds

Important! This article is not applicable to editorial content owners.

 

What Are MRSS Feeds?

MRSS feeds are a form of media syndication that allow you to mass upload your video content to the Portal. Our MRSS feeds allow you to apply customized metadata at the feed level that will be automatically attributed to all content videos uploaded using that feed.

MRSS feeds are constantly updated every 15 minutes, so whenever you have new videos, you can just post them to the URL that is used for the feed, e.g. YouTube or your CMS, and they will automatically be loaded into the system.

 

Feed Types

The Feed entity can be used to import videos using three types of MRSS imports:

  • MRSS - Link your externally hosted MRSS Feed to a Feed in our platform to import your videos.
  • MRSS Over FTP - Host your MRSS Feed and Video files on an FTP folder that we can provide you with to be imported into our system.

    Note: For further details, please see How to setup MRSS Over FTP Import.

  • FTP - Host individual Video and accompanying Metadata files on an FTP folder that we can provide you with to import them into the system.

    Note: For further details, please see How to setup FTP Import.

 

 

Create MRSS Feed

To create a new MRSS feed, perform the following steps:

  1. Log in to the Portal by clicking here.

    NUI_Create_MRSS_Feed_001.jpeg

  2. Hover over 'MEDIA' in the Portal menu and select 'FEEDS' from the drop down menu. The feeds page is displayed.

  3. Click on 'Add a New Feed'. The create feed page is displayed.

    NUI_Create_MRSS_Feed_002.jpeg

  4. Enter a name for your MRSS feed in the 'NAME' field.

  5. Go to the 'FEED TYPE' field to select the required media type according to the following options:

    Note: Selecting the feed type will change the display of other metadata fields on the page according to the selected feed type. This table explains all of the available fields. 

    • MRSS - When selected you may enter a URL address of an externally hosted MRSS Feed that will allow the system to ingest your videos. This is the most common option used to import videos using your externally hosted MRSS feed.

    • MRSS Over FTP - When selecting this option, you should contact the support team to provide you with an FTP folder location to which you can upload an MRSS .xml file and accompanying video files. For further details, please see How to setup MRSS Over FTP Import.

    • FTP - Your support team will provide you with an FTP folder location to which you can push your video and metadata files. All videos and metadata files will be ingested by the system via MRSS from that FTP folder URL. For further details see How to setup FTP Import.

      Important! Both 'MRSS Over FTP' and 'FTP' methods requires you contact our Support team after creating this Feed to request an FTP Folder setup. Please provide the current Feed ID and Company ID.


      Note: To ingest videos from YouTube please contact your support representative.

     

  6. Go to the 'URL' field and enter the URL of the MRSS data feed in .xml format.

    Note: All MRSS URLs must include a protocol declaration of http:// or https://.

    Note: Macros are supported, for example: START_DATE and END_DATE, in your feed. The system will access this URL every 15 minutes to check for new content in the feed.

  7. Optional: Click on 'TEST FEED' button to test which metadata fields your mapping data will point to when ingested.

  8. Go to the 'LOGIN' and 'PASSWORD' fields and enter your login credentials and password for your defined feed URL.

  9. Click on the 'Company' field and select the required company from the select company window to change the ownership of all the videos uploaded using this feed to one of your affiliates or back to your white label.

    NUI_Create_MRSS_Feed_003.jpeg

  10. Go to the 'VIDEO INFORMATION' tab to add additional metadata to be applied to the videos uploaded using this feed.

  11. Under the 'IAB CATEGORY' field, click on 'Add Category' and select a relevant IAB category vertical to be applied to the ingested videos. 

    Note: Selecting an IAB Category is a mandatory step to create a feed. For further details, please see How to Add an IAB Category to Your Video.

    NUI_Create_MRSS_Feed_004.jpeg

  12. Optional: Apply any additional optional metadata fields according to the field and description tables provided below:

    FEED INFORMATION

    The following table describes all the optional fields under the 'FEED INFORMATION' tab.

    Field Name Description
    ENABLED

    Selecting this check box will define this feed as active. Deselect this check box to suspend your MRSS feed.

    Note: You may wish to set up a feed, but hold off on actually imported the data until you have finalized the data at your feed URL. In this case, you can set up the feed on this page and keep the feed disabled until you are ready to begin the import. As soon as the feed is enabled, it will begin to import every 15 minutes.

    SUPPORT UPDATES

    Select this check box if you want the system to recheck for updates regarding content videos and metadata on all your videos. For example: when this check box is selected, and after the feed has been initiated, the feed will check for any changes in between the videos from the feed and the uploaded videos in the system. If a video or metadata has changed the system will update the files within it automatically.

    Note: This field is deselected as default.

    Note: The original video's Video ID must be implemented in each video's metadata file for this option to work. The reference check between the videos in your MRSS feed or FTP is based on the original Video ID parameter and value and not the Video ID that is for internal use in the system.

    Recommendation: Use this option only if you have a small number of videos to ingest and maintain. Changes in large feeds will weigh on the system's performance.

    Note: When selected the system checks for changes every 30 minutes.

    TRANSFORMATION URL

    Optional: Enter the URL of your custom ".xml Mapping" file in .xslt format.

    Note: This is required when you are using a custom feed that does not conform to our .xml feed format. This field will link to a custom mapping file that is used to interpret the feed URL you provided. 

    Note: This file is used to map elements within a single MRSS feed.

    Note: Please see also Requirements for MRSS Feed Transformation File.

    CATEGORY MAPPING Allows you to map one or more of your feed categories into a selected IAB category.
    STUDIO MAPPING Allows the system to identify multiple companies as the owners of each video. The XPath is used to map a video to each company.
    ENABLE TRANSCRIPT Selecting this check box will send each ingested content video to the automatic transcript service to create transcripts for it.
    CLASSIFY VIDEO Selecting this check box will enable the video classification service to automatically populate missing video metadata for each video ingested with this feed.
    VIDEOS REQUIRE APPROVAL Selecting this check box will send each of the videos to our curation team for validation and approval before they are made available for syndication.
    INDEXED TAGS Allows you to add custom metadata tags to your video. All tags in this field are indexed and are searchable.This field is not linked to any standardized keyword list and allow you to enter any word. Multiple keywords should be entered using comma separators.


    VIDEO INFORMATION

    The following table describes all the optional fields under the 'VIDEO INFORMATION' tab.

    Field Name     Description
    STORAGE TYPE Click on this field and select the required storage type according to the following options: 
    • Encoded - Selecting this option will display the 'Encoding profile' field. This will allow you to select an encoding profile for all you videos uploaded using this feed.  This option will then make use of that encoding profile to transcode the mezzanine file from the imported feed.  All videos "encoded" will also be delivered by our CDN.
    • External CDN - Selecting this option allows you to use your own CDN or have streaming files such as HLS and RTMP.

      Note: When this option is selected the 'Encoding profile' field will be hidden because no encoding is required if the content is being stored on an external CDN.

    • Copy to our CDN - Selecting this option will copy the content videos from your CDN to the system. This will allow you to select an encoding profile for all the duplicate videos uploaded and stored on the system and again all media will be delivered through the CDN.
    ENCODING PROFILE Click on this field to select the required encoding profile that will be applied to all videos uploaded using this feed.

    Note: If the 'External CDN' option is selected in the 'Storage type' field (see above) this field will be hidden.

    SELLER RULE Click on this field to select the required seller rule that will be applied to all videos uploaded using this feed.
    LANGUAGE Allows you to describe the spoken language of the video from a drop down menu.

    Note: Languages highlighted in black are the most common.
    RATING Allows you to select the appropriate video Parental guideline ratings (one or more) according to the following options:

    • Adults Only
    • Age 10 And Above.
    • Age 14 And Above.
    • Age 17 And Above.
    • Age 7 And Above.
    • For All Ages.
    • For All Children.
    • Not Rated.
    AUDIENCE AGE Allows you to select the appropriate audience age according to the following options:

    • Kids - The video is appropriate for kids up to the age of 9.
    • Tweens - The video is appropriate for kids nearing puberty, between the ages of 10-11.
    • Teens - The video is appropriate for teenagers, between the ages of 12-20.
    • Adults - The video is appropriate for adults, between the ages of 21-54.
    • Senior - The video is appropriate for seniors, aged 55 and older.
    DESCRIPTORS Allows you to assign selected descriptors according to the following options:
     
    • Fantasy Violence.
    • Age Restricted.
    • Sexual Content.
    • Suggestive Dialogue.
    • Violence.
    • Coarse Language.
    • No Descriptors.
    LOGO

    Allows you to upload a company logo that will be displayed as an overlay in the player to all of your uploaded videos using the feed.

    CONTENT LIFECYCLE

    Allows you to define the content of your uploaded videos as one of the following options:

    • Evergreen - The video content is always topical and not specific to any time period.
    • Fast-Breaking - For the latest news content.
    • Live - For live feeds.
    KEYWORDS Allows you to add custom keyword metadata to your video. This field is not linked to any standardized keyword list and allow you to enter any word. Multiple keywords should be entered using comma separators.
    CUSTOM ATTRIBUTES Allows you to add any custom attributes (parameters and values) using the 'Name' and 'Value' fields. These attributes can then be used to search for the video.


  13. Click on 'Save'. Your feed is ready for use.

    Note: The feed will take approximately 15 minutes to upload into the system. Once uploaded successfully, your feed will be displayed in the list on the Feeds page, and the Videos from the feed will be displayed on the Videos page. You can track the status of the feed on the Discovered videos page.
Have more questions? Submit a request