This document describes the rules and configurations of the MPX Data Source plugin, serving the content generated on MPX (which is Comcast's Video management system).
More information on MPX can be found here.
The Plugin -
- The plugin to be used, is called "MPX Datasource"
- The plugin version to be used is Version 1.2 and above, which supports both:
- Media Feeds
- Entertainment Feeds
- Note: Lower plugin versions, support Only Entertainment Feeds
List of Parameters (AKA as "Handlers"), supported by the MPX Data source provider:
The MPX DSP, supports 4 parameters:
- Movies (Available only with the Entertainment Feeds)
All handlers support the same parameters, as described in the table below:
|limit||optional. If specified limits the number of items in response payload||Number||
URL Example 1:
Manifestation in DSP:
URL Example 2 (with Limit Parameter):
Manifestation in DSP:
Configuring the Feed in the MPX platform:
Enter the Comcast MPX Video management system, via the following link:
Once logged-in you can locate the feed that interests you, by:
i- Entering the relevant section for you (for example "Entertainment --> Series"):
ii- Selecting the Video of interest.
eg: "Curb Your Enthusiasm (Season 4 Episode 10)"
--> A new screen will open with the video information.
iii- Under the "Metadata" tab, you will find the "Public URL" (which then goes in the UI Builder)
This is the URL to be extracted from the MPX platform, and inserted in the Feeds section in the UI Builder, as the Input for the Data Source Provider.
ERA Restriction -
Please make sure that when under the "Metadata" section of the feed, to select the "Restriction" field as "ERA: Free Content". Otherwise, the content will simply not be playable.
MPX Flow -
It's important to remember the following Flow of Events in the MPX system:
1) Create your videos and upload them to MPX
2) Create Feeds out of those videos [similar to playlists]
You can define Tags for the feeds, and then filter them according to different features that are supported in the MPX system.
Appearance and Promotion of the Feeds in the UI Builder -
Episodes/Movies: The feed of an Episodes, will be converted into a Flat Feed in the UI builder after being parsed by the MPX DSP (using the "Episodes" type in the DSP)
Series/Seasons: The Feed of a list of Series and/or Seasons, will be converted in to a Feed of Feeds in the UI builder after being parsed by the MPX DSP (using the "Series"/"Seasons" type in the DSP)
i- Create a Feed called "Drama Movies" which contains a list of Movies, and is classified as a feed of Type "Movies"
*Note: If the FEED has already been created, it can be found under the "Feed" section
ii- From here, we can open the relevant feed and extract the "Public URL" which will serve as the input for the data in the DSP.
Take the "Public URL" that is generated in the feed:
iii- Create a Feed in the UI Builder "feeds" section and insert there the Public URL:
*Note: It's important to make sure that when inserting the URL in the UI builder, that it has either a Media Feed prefix or an Entertainment Feed prefix as a hostname:
Media Feed prefix - feed.media.theplatform.com
Entertainment Feed prefix - feed.entertainment.tv.theplatform.com
iv- Select the MPX DSP Data Type, as Movies:
This is how the Original Feed opens:
This is how the Parsed Feed opens (in the format of an Atom-JSON file):
Media feeds & additional Form Parameters
There is a structural difference between "Media feeds" and "Entertainment feeds":
- In order to use Media feeds, additional
formparameter must be added to the url. The
formparameter can have one of the following values:
- (the form to be used, is defined anda configured in MPX)
The Media parser uses some custom fields that must be set in the feed. When defining the Media object with custom fields, you must declare the appropriate namespace. Namespaces are separated with
$from title of the custom field. More about custom fields can be found here.
Custom fields, that should be included:
|Custom field name||Description||Type||Example|
|showTitle||Title of the show||String||
You can see that in Media Feeds, the concept of "Series" and "Seasons", is embedded within the Episode's list.
You can see that the Entries below (eg: Ashlee and Evan Ross), are Episodes.
But the way for us to retrieve the Seasons and the Show Name from that episode, is by the parameter that it has.
Bottom Line: The feed needs to be constructed in such a way that will allow us to extract the information, which we need to use in order to populate the UI.
If the custom fields are Not used correctly, they won't be able to display, for example, the Show Name that the episode belongs to.
- title (on a Feed level, and on an Entry level)
Supported Image Keys:
Github Repo "zapp-pipes-provider-mpx":
For more technical information, feel free to access and consult the Github Repository for MPX
- (available Only for Internal Applicaster Users):