Overview

An asset is a video file that can be contained within a Franchise, Show, Season, Special, and Episode. Assets can be full length episodes, clips, or previews. Because video clips and previews (not full length episodes) can be considered "Extras" in their own section on PBS.org, Media Manager provides the ability to create Assets and Extras in two separate places in the console.

Episodes and Specials can contain only one full length episode but unlimited clips and previews. Once you have added a full length episode, you cannot add another to the same object. Franchises 

Media Manager optimizes the raw video file that you add to your asset and automatically generates several formats to adapt to a user's internet speed. So if a user with a slow internet connection clicks on your video, they will automatically be served the file size that accommodates their internet connection speed.  

The following table illustrates the relationship between objects and asset types. It shows which objects accept specific asset types.

 FranchiseShowSeasonSpecialEpisode
Full Length(error)(error)(error)(tick)(tick)
Preview(tick)(tick)(tick)(tick)(tick)
Clip(tick)(tick)(tick)(tick)(tick)

Video specifications


ElementStandard HD Mezzanine SpecHD 1080p Mezzanine Spec
File FormatMPEG-4 (.mp4)MPEG-4 (.mp4)
Total Stream BitRate5 Mbps15Mbps
Video Stream
CodecAVC (H.264)AVC (H.264)
Frame Size 16/91280 x 7201920 x 1080
Frame Size 4/3960 x 7201440 x 1080
Frame Rate30 fps30 fps
Scan TypeProgressiveProgressive
Video Stream BitRate4808 Kbps14808 Kbps
Video Stream BitRate ModeVBRVBR
Audio Stream
CodecAACAAC
Audio Stream BitRate192 Kbps192 Kbps
Audio Stream BitRate ModeCBRCBR
Number of Audio Channels2 (Stereo)2 (Stereo)
Audio Channel's PositionsL, RL, R
Sampling Rate48 KHz48 KHz

Bit Depth

16 bits16 bits

How to create a video asset

Field

Notes

Required for Create?

Required for Publish?
Core Data
Object TypeTypes include: Full Length, Preview, ClipYY
TitleTitle of the asset. 60 character limit, including spaces.Y (Full length assets inherit title from parent episode/special. Clips and previews require title.)Y
SlugAuto-generated unique identifierY (automatically generated from Title, and is editable only prior to initial save)Y
PBS Content IDAuto-generated unique identifier.Y (automatically generated; not editable)Y
Short Description90 characters or less, including spaces. Used primarily when space is limited, such as on apps and small screens.Y (Full length assets inherit Short Description from parent episode/special. Clips and previews require Short Description.)Y
Long Description400 characters or less, including spaces.Y (Full length assets inherit Long Description from parent episode/special. Clips and previews require Long Description)Y
Premiere DateOriginal on-air or online broadcast date.Y (pre-filled with current date; is editable)Y
Encore DateOn-air rebroadcast date.Y (pre-filled with current date; is editable)
Y
TagsUsed in the API and for advanced discoverability in a site search.N
Content Rating
N
CreatedThe date and time the asset is created.N/A
UpdatedThe date and time the asset was last updated.N/A
Additional Data
Exclude From DFPOn/Off. Determines whether or not sponsorship ads will be displayed for associated videos.Y (Inherits from parent show. Can only be changed to On, if parent show is set to Off.)Y
Funder MessageOptional field.N

Allow Topics

or

Topics

On/Off. Legacy field, no longer used by PBS front end. Asset value inherits from parent show.Y (Inherits from parent show)
Legacy TP Media ID

This is a legacy ID that should only be used for backwards compatibility, and not for new implementations. Transitioning to the PBS Content ID is strongly recommended.

We do not have plans to eliminate the TP Media ID at this time.

Y (Auto-generated; not editable)Y
Related Content
Episode LinksRepresented on pbs.org video pages (only) in the Episode Links section.N
Learn More PromosRepresented on pbs.org video pages (only) in the Learn More section.N
Availability
Passport

Assign date/time availability windows for:

Public Users

All Passport Members

Your Station's Passport Members (applies to local shows only)

YY
Geo AvailabilityIdentifies the countries in which the video is available. Inherited from the parent show, and can be overridden on the asset level.YY
Platform ManagementIdentifies the platforms on which the video is available. Inherited from the parent show, and can only be made more restrictive on the asset level.YY
Video
VideoVideo fileNY
Closed Captioning

Caption file

Caption requirement inherits from the parent show.

Captions can be included for assets that do not have a caption requirement.

NDepends, if captions are required for the parent show.
Auto Publish

On/Off. When set to "On", the asset will publish after all required-for-publish fields are complete.

Default=Off

N
Allow Viral Player Embed

On/Off. The setting inherits from the parent show.

The viral player provides up to 20 minutes of a video. When set to "On", this displays an embed icon with the video player, and allows site users to embed the viral player on their own site.

Y
Partner PlayerThe partner player provides the full video, and the embed code for it is available to users with access to this published video asset.

N/A

Partner Player code is provided for published video assets.


Images
ImageVarious profile types available.NY
Chapters & Mid-Roll
ChaptersAssign chapter marks, which are also used to insert mid-roll sponsorships.N
Preview Video
Status & PreviewView asset status, and preview successfully ingested video files.N/A

Learn how to access Extras

  • From an Episode or Special, click the Assets tab (Figure 1.1).
  • Click Create Asset located on the right side of the screen (Figure 1.2).

Figure 1

  • Click the Object type dropdown menu and select Full EpisodePreview, or Clip (Figure 2). 

If Full Episode is not available, the object probably already contains a full episode.

Figure 2

  • The selected object type displays (Figure 3.1).
  • In the Title textbox, type the title of your video asset containing no more than 60 characters, including spaces (Figure 3.2).
  • The slug is automatically created for you based on the title (Figure 3.3). 
  • Click Save (Figure 3.4).

If you receive an error message (500) when saving your file, check the Title field to be sure your character count has not surpassed 60 characters. If you have copied and pasted your title from another source such as Microsoft Word, some special characters, such as apostrophes, quotes, and commas may count as multiple character spaces and put your title over 60 characters. Try manually typing your title into the Title textbox.

Figure 3

  • A message confirming that your asset has saved appears in a green bar at the top of the page (Figure 4.1).
  • A persistent status bar appears at the top of the page and provides a quick view of the asset's status, including its published status, availability, and completion of required fields (Figure 4.2).  Now you can begin filling out the rest of the metadata and add your video and caption files.

Figure 4

Core Data

  • If the asset contains a full length episode, the Title, Object type, Short and Long Descriptions are all carried over from the previous screen (Figure 1.1). Previews and Clips do not inherit the descriptions of the episode and must be added at the asset level.
    • The Object type can be modified at the asset level, however, the Short and Long Descriptions are pulled from the Episode page and must be modified at the episode level (Figure 1.2). Short Description has a limit of 90 characters, including spaces. Long Description has a limit of 400 characters, including spaces. You cannot change the short and long descriptions of a full episode, only clips and previews. You must go back to the episode page and change the descriptions there.
  • Click the Premiere and Encore Date textboxes to modify the dates (Figure 1.3). The Premiere is the original online or on-air date of the video, Encore is the date the video is rebroadcast on-air. 
  • In the Tags textbox, type keywords that will help viewers find your asset (Figure 1.4). Tap the Enter key on your keyboard to enter each word or phrase. Click the x in the upper right side of each tag to remove a tag.
  • Click the Content rating dropdown menu and select a rating for this asset (Figure 1.5). View ratings *NR = No rating
  • Click the Content rating descriptor dropdown menu and click the descriptor that is appropriate for your asset (Figure 1.6). Each chosen descriptor appears in the textbox and can be removed by clicking the x on the left side of each entry. This field only displays after you have selected a Content rating.
  • The date, time, and author of the asset creation and last update displays (Figure 1.7). 
  • When finished, click Save (Figure 1.8).

Figure 1

Additional Data

  • Click the Additional Data tab (Figure 1).

Figure 1

  • Click the Exclude from DFP toggle to allow or prevent DFP pre- and mid-roll from displaying on your video asset (Figure 2.1). When the toggle displays ON, content is excluded. When the toggle displays OFF, DFP content will be shown during your video. 
  • In the Funder Message textbox, type any acknowledgments associated with your show (Figure 2.2). Maximum length: 500 characters, including spaces. 

If funder text is set at the Show level and you want the same text to display on your assets, leave this blank.

 See where funder text displays

 

  • Click the Language dropdown menu and click the primary language in which your video is presented (Figure 2.3).
  • The ability to add topics is assigned in the Additional Data tab of the show to which the asset belongs. Please file a support ticket to enable, disable, and assign Topics at the show level. If Topics are enabled, click the Topics dropdown menu and select a topic from the list provided (Figure 2.4). 
  • The Legacy TP Media ID is a legacy feature that is auto-populated and can be ignored (Figure 2.5).

Figure 2

Related Content

Use the related content section to add up to eight (8) remote assets to your video page. Remote assets, also known as Related Content, are plain links and rich promos that include titles, images, and descriptions and are related to the main content of your video. You can add up to four (4) Episode Links and four (4) Learn More Promos. Related Content is optional. Learn how to create a Remote Asset

  • Learn More Promos contain a title, URL, description, and image
  • Episode Links contain only a title and URL


 Click here to see where Remote Assets appear on a video asset

  • Click the Related Content tab (Figure 1.1).
  • To add an Episode Link that already exists in Media Manager, click the green Add Existing button in the Episode Links section or click Create New to create an entirely new remote asset (Figure 1.2). 
  • To add a Learn More Promo that already exists in Media Manager, click the green Add Existing button in the Learn More Promos section or Create New to create an entirely new remote asset (Figure 1.3). 

You can create a remote asset from this page by clicking Create New but we recommend creating your remote assets in the Remote Assets section of the Media Manager console.

Figure 1

Learn how to create a Remote Asset

  • To search for a remote asset by keyword, type search criteria in the search textbox on the right side of the page and tap Enter on your keyboard or click the magnifying glass icon (Figure 1.1).
  • To browse remote assets, use the filters along the top of the page (Figure 1.2): 
    • Click the All Franchises dropdown menu to browse within a particular franchise
    • Click the All Shows dropdown menu and click the show you want to browse
    • Click the Asset type dropdown menu and click the type of asset you want to add
  • If enough assets are returned in the results, pagination will appear in the bottom right side of the page (Figure 1.3). 
  • In the Select column on the far left side of the page, next to the episode link you want to add, click Add (Figure 1.4).

Figure 1

  • After you've added up to four (4) episode links, they appear in a list at the bottom of the page (Figure 2.1).
  • Click Save to add them to your video asset (Figure 2.2).

Figure 2

  • Once you have added a total of four episode links to your assets, the green Add Existing and Create New buttons no longer appear. The only way to modify your list is to delete one of your current selections. When you do that, the buttons display and you can select a new episode link. To delete a link, click the trashcan icon on the right side of the link you wish to delete (Figure 3).

Figure 3

Add Learn More Promos

The steps for adding Learn More Promos are the same as adding Episode Links so please follow the steps listed above.

Availability

Availability determines the access viewers will have to your video by checking a user's Passport status (learn more about Passport - this link takes you to the MVault documentation).

User types and permissions are defined as follows:

User typeDefinition
PublicUsers who are not Passport members (general public), or are not logged in.
All Passport MembersAll Passport members across all stations.
Your Station's Passport Members

Passport members belonging to one or more stations. Station assignment is determined in Audience section of the Core Data tab in a show. Please contact PBS to modify the Audience field

You can vary programming windows depending on the User Type.

 This user type only displays for station programs; national programs have no station component.

Availability TypeDefinition

Not Available

Never allowed to view the video.
Always AvailableAlways allowed to view the video.
Custom Time FrameAllowed to view the video for a specific time frame.
  • Click the Availability tab (Figure 1).

Figure 1

  • Each type of user/member is listed on the left side of the page (Figure 2.1) with their corresponding availability assignment on the right side.
  • Click the dropdown menu to the right of each user/member type to set a unique availability (Figure 2.2).
  • To assign Passport users the same viewing permissions as non-members, click the checkbox next to Apply "Public Users" availability setting for Passport Members (Figure 2.3). When this is checked, Passport member options are grayed out.

Figure 2

  • Click the Availability Setting next to the user type whose availability rules you want to modify (Figure 3).

Figure 3

  • On the right side of the page, click on the following options: 
    • Not Available to never allow this type of user to see the video, 
    • Always Available to allow the user to always view the video, or 
    • Custom Time Frame to assign customized dates and times (Figure 4.1). (info) In the following example we are applying Custom Time Frames.
  • When the two calendars appear, on the calendar on the left click the day you want the video to become available (Figure 4.2) and on the calendar on the right, the day you want the video to become unavailable (Figure 4.3). 
  • The corresponding time, in hours and minutes, is beneath each calendar (Figure 4.4). Click each dropdown menu to assign a beginning time and ending time. All times are Eastern Standard Time (EST).
  • When finished, your assignments appear in the FROM and TO textboxes (Figure 4.5).
  • If you are satisfied with the dates and times, click Apply (Figure 4.6).

Figure 4

  • The new parameters are recorded and display in the dropdown menu (Figure 5.1).
  • You can return the user to the original assignments by clicking the Set to the Show's default setting: (Always Available) link located beneath the dropdown menu (Figure 5.2).

User types are listed in descending order from basic to advanced permissions.  You cannot grant a "lesser" role more permissions than an advanced role. Each user type and permissions can only increase over the role above it. For instance, you cannot make an asset available to everyone (Public) but restrict it from Passport members.

For national programs, only Standard and All Passport Members are displayed, as there is no station component.

 

Figure 5

  • Click the Geo Availability dropdown menu and click the the region or country in which your asset is available for viewing (Figure 6.1).
  • When finished, click Save (Figure 6.2).

All assets inherit geo restrictions that are assigned at the show level. Individual assets can only be made more restrictive, not less restrictive. For instance, if restrictions at the show level are set to US and Canada, you cannot set your asset's restrictions to include US, Canada, and Mexico.

Figure 6

Notes on Availability

When viewing your list of Assets and Extras, the Availability column displays green checkmarks and red x's. These serve as a quick way of determining the availability assigned to a specific asset or extra. The order of the icons, from left to right, is as follows:

  • Public users
  • All Passport members
  • Your Station's Passport members

So in the following example, the Dublin Castle asset is not available to public users and all Passport members, however, your Station's Passport members can see the asset.

The Platform Management section allows you to choose which platforms you want your asset to be available on. If no platforms are selected, your asset will not appear on any platforms and can only be accessed by the direct URL to the object.

  • From the selectbox on the left side, click the platform through which you want to have your asset accessible. Click All Platforms to select all available platforms. 
  • The asset appears in the box on the right side, indicating it has been selected.
  • Click the platform name to deselect it or click Remove All to deselect all selections.

Figure 7

Video

 View video file specifications
ElementStandard HD Mezzanine SpecHD 1080p Mezzanine Spec
File FormatMPEG-4 (.mp4)MPEG-4 (.mp4)
Total Stream BitRate5 Mbps15Mbps
Video Stream
CodecAVC (H.264)AVC (H.264)
Frame Size 16/91280 x 7201920 x 1080
Frame Size 4/3960 x 7201440 x 1080
Frame Rate30 fps30 fps
Scan TypeProgressiveProgressive
Video Stream BitRate4808 Kbps4808 Kbps
Video Stream BitRate ModeVBRVBR
Audio Stream
CodecAACAAC
Audio Stream BitRate192 Kbps192 Kbps
Audio Stream BitRate ModeCBRCBR
Number of Audio Channels2 (Stereo)2 (Stereo)
Audio Channel's PositionsL, RL, R
Sampling Rate48 KHz48 KHz

Bit Depth

16 bits16 bits
  • Click the Video tab (Figure 1).

Figure 1

  • In the Video File textbox, type the full URL of your video file and click the Select Video Profile dropdown menu to select the correct profile of your video (Figure 2.1). (info)  You need to host the file on a server and add the full URL to the video file (example: http://s3.amazonaws.com/media/help/my-video-file.mp4). Most videos are HD Mezzanine 16x9. 
  • In the Caption File textbox, type the full URL of your closed caption file (Figure 2.2).
    • If you are not including a closed caption file, click the checkbox next to Or, provide valid caption justification and select a reason from the options provided why you do not need to ingest a caption file (Figure 2.3). If none of the listed options fits your needs, click Other and in the textbox provided, manually type the reason for not ingesting a caption file.
  • To auto-publish your video file, click the Auto publish toggle so that it displays ON (Figure 2.3). When toggle is set to ON, your asset will publish automatically when all files have successfully ingested.
 Learn more about auto-publish

What is auto-publish?

The auto-publish feature ensures that once all necessary files have been successfully ingested, your asset will automatically publish. This means that you can upload your video file (and caption file if applicable) and walk away during the ingestion process to do other things. You must check back in on the process in case any errors occur during ingestion. If errors occur, the process will stop and your asset will not publish until the errors are corrected.

What if I leave and my asset encounters an error?

It's very important to remember that when you are using the auto-publish feature, you must be diligent about checking the ingestion status.  If ingestion fails, an error message appears in the console and your asset does not publish. You need to manually fix the errors and republish the asset by clicking the Publish button.  Refer to the publish status to see if everything successfully ingested and published. 

  • Click the Allow Viral Player Embed toggle so that it displays ON if you want third party websites to be able to embed this asset on their website (Figure 2.5). Learn more about the Viral Player
  • The Partner Player code enables PBS producers to embed your asset (Figure 2.6). Learn more about the Partner Player
  • When finished, click Save (Figure 2.7).

Figure 2

  • After a few moments, refresh the page to view the ingestion status. When ingestion is complete (Figure 3.1), click Output Files in the Closed Captioning section (Figure 3.2) to view all transcoded files.
  • Click Output Files in the Video section to view transcoded files for each user type (Figure 3.3).

If ingestion fails, please try re-saving the asset.

Figure 3

  • After clicking Output files in the Video section, all available user types appear. Click the user type for which you want to see the transcoded files (Figure 4).

If there are no output files after a minute or so, refresh the page.

Figure 4

  • All transcoded files for that user type are displayed (Figure 5).

Figure 5

Images

The images section holds your video asset image which appears at the top of your asset page.

Image guidelines

Media Manager requires the ingestion of one mezzanine quality jpg, gif, or png image file per asset.  A mezzanine image is defined as an image with a 16:9 ratio that is at least 1920 pixels wide by 1080 pixels high. Only one image profile per asset is allowed. 

 Learn more about mezzanine images

A mezzanine image is defined as an image that is at least 1920 pixels wide by 1080 pixels high with a 16:9 aspect ratio.

A 1920x1080 resolution image is necessary for editorial and evergreen purposes. Having an image this large will ensure that Media Manager can generate all the different images sizes needed in order to properly display across all platforms on which it might be published or promoted (iPad/iPhone apps, Mobile Web, xBox, Roku, PBS.org homepage, etc.).  

The image aspect ratio must be 16:9. Media Manager does not check to make sure this is the case so if the image you ingest does not have a 16:9 aspect ratio it will be distorted when it is displayed in various devices and interfaces.

How to add your image file

  • Click the Images tab (Figure 1).

Figure 1

  • Click the blue Choose button to browse for an image file on your computer (Figure 2.1).
  • Once you've found the image you want to use, add it (Figure 2.2).
  • Click the Select Profile dropdown menu and click the profile that is associated with your image (Figure 2.3). 
  • When finished, click Save (Figure 2.3).

Figure 2

  • To change your image, click the pencil icon under the Action column on the right side of the page (Figure 3.1).

Figure 3

  • Your current image information displays (Figure 4).

Figure 4

  • Click the blue Change button or anywhere in the textbox to select another image and click the profile dropdown menu to select the associated profile (Figure 5.1).
  • Click Save (Figure 5.2).

Figure 5

  • Your new image displays (Figure 6.1).
  • To delete the image, click the trashcan icon located in the Actions column on the right side of the page (Figure 6.2).

The trashcan icon deletes your image only while the red Delete button in the lower right side of the page deletes your entire asset. Be careful!

Figure 6

  • Click Yes, I'm sure to complete the deletion (Figure 7.1).
  • Click No, take me back if you want to keep the image (Figure 7.2).

Figure 7

  • Your image has been deleted and you can add another by following the same steps listed above (Figure 8).

Figure 8

Chapters & Mid-Roll

What are chapters?

Chapters are short descriptions of individual segments throughout the duration of a video. When a user hovers the mouse over the tickmarks aligned along the chapter timeline at the bottom of the video screen, the title of each chapter appears, giving the user an idea of what is included in each particular short segment, or chapter.  These chapter titles help the viewer track the progression of the video and enable them to skip to a particular chapter of interest by clicking a tickmark. 

Chapters also determine where sponsorship messages (midroll) appear throughout your video. If you have no designated chapters, you cannot add mid-roll to your video. Chapters and mid-roll are designated by a small dot on the scrubber bar when a user hovers over the video. 

 Take a look

 

Admin screenDefinitions and Examples 

Field name

Definition

Title

  • Title is the title of your chapter. It appears when you hover over the chapter tickmarks located on the scrub bar of the main video.
  • Your title should not exceed 32 characters (spaces and line breaks included).

Start Time

  • Start time is the moment in your video when a chapter begins or a the spot at which a mid-roll ad is shown.
  • To assign the start time, click the Start Time textbox.
  • When more than one chapter is added, the end time of the previous chapter must match the start time of the next chapter so there are no gaps. You will encounter an error message if there is a time gap between the end and beginning of chapters.
  • Chapter format is: H:M:S:MS (Hour:Minute:Second:Millisecond). 

End Time

  • End time is the moment in your video when the chapter ends or when your mid-roll ad has finished. 
  • To assign the end time, click the End Time textbox. 
  • When more than one chapter is added, the end time of the previous chapter must match the start time of the next chapter so there are no gaps. You will encounter an error message if there is a time gap between the end and beginning of chapters.
  • Chapter format is: H:M:S:MS (Hour:Minute:Second:Millisecond). 

What is Mid-roll?

  • Mid-roll refers to an advertisement that is placed at various spots throughout your video.

  • In addition to mid-roll ads, the video player will carry a standard pre-roll message for streaming video that is 3 minutes in length or longer. This is not dependent on chapters.

  • Each mid-roll message can be up to 30 seconds in length.  
  • All in-stream message delivery is managed by PBS. All required sponsorship will be served using PBS-provided ad serving and tracking code.
  • Mid-rolls are also inserted into long-form programming at select chapter breaks. 

  • For chapterized videos longer than 20 minutes, there is a mid-roll ad slot at the first chapter break between 8-15 minutes. The mid-roll ad slot has space for two 30-second (:30) spots. 

  • For chapterized videos longer than 40 minutes, a second mid-roll ad slot at the first chapter break between 20-27 minutes is inserted.  

  • If there are no chapter breaks identified within these windows, then no mid-roll will be displayed.  

Preview

Click the Preview tab to view the status of different parts of your asset. You can see what has been successfully ingested, which files are missing, and review your asset's metadata. In the Preview Video section, click the play button on the image to view the video as it will display when it is live.

The Preview tab is particularly helpful if you encounter difficulties when publishing your asset. Review to see if crucial elements are missing and preventing you from successfully publishing your asset. The following are some notes about the Preview tab:

  • The Title section contains a clickable link only after the asset has been published.
  • The Preview Video feature is only available after you have successfully added a video file to your asset.
  • The Publish button in the upper right corner is only clickable when all required elements have been added to your asset. 
  • You can find some of the same information in the persistent status bar. 
 View the preview tab for a successfully published asset

Click image to enlarge

Extras

An Extra is a type of Video Asset that can be associated with a FranchiseShow, or Season. Extras can be Clips or Previews only (no Full Length Episodes) and have no associated ads. These assets appear on PBS.org by scrolling down a show page to the Clips and Previews or Extras sections. After you have clicked the Extras tab, the steps for creating a preview or clip exactly mirror the steps involved when creating a preview or clip from the Assets tab. 

  • From a Franchise, Show, or Season page, click the Extras tab (Figure 1).

Figure 1

FranchiseShowSeason

  • Click Create Extra (Figure 2).

Figure 2

  • Click the Object Type dropdown menu and click Preview or Clip (Figure 3).

Figure 3

  • The Title and Slug are prefilled from the Franchise, Show, or Season (Figure 4.1). You can change the title and the slug will automatically reformat to fit the new title.
  • Click Save (Figure 4.2).

From this point, create your Extra in the same way an Asset is created.

FranchiseShowSeason

How to delete an asset

You can delete an asset from the Media Manager dashboard by using the dropdown features that expose layers of objects. 

  • Click the right-facing arrow to the left of the title of the season that holds the asset you want to delete.
  • Click the plus sign next to the title of the episode that holds the asset you want to delete. 
  • Click the trashcan icon to the right of the title of the asset you want to delete.
  • Click Yes, I'm sure to confirm deletion.
  • The asset has been deleted.

Figure 1
(click image to enlarge)