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.
Franchise | Show | Season | Special | Episode | |
---|---|---|---|---|---|
Full Length | |||||
Preview | |||||
Clip |
Video specifications
Element | Standard HD Mezzanine Spec | HD 1080p Mezzanine Spec |
---|---|---|
File Format | MPEG-4 (.mp4) | MPEG-4 (.mp4) |
Total Stream BitRate | 5 Mbps | 15Mbps |
Video Stream | ||
Codec | AVC (H.264) | AVC (H.264) |
Frame Size 16/9 | 1280 x 720 | 1920 x 1080 |
Frame Size 4/3 | 960 x 720 | 1440 x 1080 |
Frame Rate | 29.97 fps (or original frame rate) Note: 23.98 fps and 60 fps source files are adapted to 29.97 fps during the transcode process, due to some client-side support limitations affecting playback.
Until we are able to support multiple frame rates, or if frame duplication causes quality issues, it's recommended that producers convert to 29.97 fps prior to uploading in Media Manager. | 29.97 fps (or original frame rate) Note: 23.98 fps and 60 fps source files are adapted to 29.97 fps during the transcode process, due to some client-side support limitations affecting playback.
Until we are able to support multiple frame rates, or if frame duplication causes quality issues, it's recommended that producers convert to 29.97 fps prior to uploading in Media Manager. |
Frame Rate Mode | Constant (not Variable) | Constant (not Variable) |
Scan Type | Progressive | Progressive |
Video Stream BitRate | 4808 Kbps | 14808 Kbps |
Video Stream BitRate Mode | VBR | VBR |
Audio Stream/s | ||
Codec | AAC
| AAC
|
Audio Stream BitRate | 192 Kbps | 192 Kbps |
Audio Stream BitRate Mode | CBR | CBR |
Audio Channels Supported | Mono, Stereo
| Mono, Stereo
|
Number of Audio Tracks Supported | Unlimited (See Media Manager File Specs for Multiple Audio Tracks below) | Unlimited (See Media Manager File Specs for Multiple Audio Tracks below) |
Track Order (for multiple audio tracks) | See Media Manager File Specs for Multiple Audio Tracks below | See Media Manager File Specs for Multiple Audio Tracks below |
Sampling Rate | 48 KHz | 48 KHz |
Bit Depth | 16 bits | 16 bits |
How to create a video asset
Field | Notes | Required for Create? | Required for Publish? |
---|---|---|---|
Core Data | |||
Object Type | Types include: Full Length, Preview, Clip | Y | Y |
Title | Title of the asset. 60 character limit, including spaces. When users search for videos, the content of this field is searched. | Y (Full length assets inherit title from parent episode/special. Clips and previews require title.) | Y |
Slug | Auto-generated unique identifier | Y (automatically generated from Title, and is editable only prior to initial save) | Y |
PBS Content ID | Auto-generated unique identifier | Y (automatically generated; not editable) | Y |
Short Description | 90 characters or less, including spaces. Used primarily when space is limited, such as on apps and small screens. When users search for videos, the content of this field is searched. | Y (Full length assets inherit Short Description from parent episode/special. Clips and previews require Short Description.) | Y |
Long Description | 400 characters or less, including spaces. When users search for videos, the content of this field is searched. | Y (Full length assets inherit Long Description from parent episode/special. Clips and previews require Long Description) | Y |
Premiere Date | Original on-air or online broadcast date | Y (pre-filled with current date; is editable) | Y |
Encore Date | On-air rebroadcast date | Y (pre-filled with current date; is editable) | Y |
Tags | Used in the API and for advanced discoverability in a site search | N | |
Content Rating | N | ||
Created | The date and time the asset is created | N/A | |
Updated | The date and time the asset was last updated | N/A | |
Additional Data | |||
Exclude From DFP | On/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 Message | Optional 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 Links | Represented on pbs.org video pages (only) in the Episode Links section | N | |
Learn More Promos | Represented 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) | Y | Y |
Geo Availability | Identifies the countries in which the video is available. Inherited from the parent show, and can be overridden on the asset level. | Y | Y |
Platform Management | Identifies the platforms on which the video is available. Inherited from the parent show, and can only be made more restrictive on the asset level. | Y | Y |
Video | |||
Video | Video file Can be replaced at any time without disrupting viewer experience | N | Y |
Closed Captioning | Caption file Caption requirement inherits from the parent show Captions can be included for assets that do not have a caption requirement Can be replaced at any time without disrupting viewer experience | N | Depends, 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 Player | The 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 | |||
Image | Various profile types available Can be replaced at any time without disrupting viewer experience | N | Y |
Chapters & Mid-Roll | |||
Chapters | Assign chapter marks, which are also used to insert mid-roll sponsorships | N | |
Preview Video | |||
Status & Preview | View asset status, and preview successfully ingested video files | N/A |
- 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 Episode, Preview, 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.
- 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.1). Learn more about the Viral Player
- Click the Language dropdown menu and click the primary language in which your video is presented (Figure 2.4).
- 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.5).
- The Legacy TP Media ID is a legacy feature that is auto-populated and can be ignored (Figure 2.6).
- Click Save (Figure 2.7).
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 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
Add Episode Links
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 have to your video and the platforms on which your video is available.
Passport availability
Use the Passport Availability section to assign what type of users can access your content and the geo location of those users who should have access. Can all users access your content from anywhere in the world or should only those with a Passport membership have access? Learn more about Passport (This link takes you to the MVault documentation).
User types and permissions are defined as follows:
User type | Definition |
---|---|
Public | Users who are not Passport members (general public), or are not logged in. |
All Passport Members | All 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. |
Geo Availability | Definition |
Countries | The countries in which the asset is available for viewing. 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. |
General Availability | Definition |
Not Available | Never allowed to view the video. |
Always Available | Always allowed to view the video. |
Custom Time Frame | Allowed to view the video for a specific time frame. |
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.
How to assign availability
- Click the Availability tab (Figure 1).
Availability settings for Public users are listed first. Click the calendar icon on the right side to set the availability status or assign a custom time frame (Figure 1.1).
- Click the Geo Availability dropdown menu to select the countries in which the asset should be viewable (Figure 1.2).
- If you wish to customize the countries, click the checkbox next to Edit selected countries (Figure 1.3). This brings up a country selector that allows you to select individual countries.
- The selectbox on the left contains all available countries (see each country's corresponding code). To search for a specific country, type the country code in the textbox provided (Figure 1.4) or click each individual country that should have viewing permissions (Figure 1.5). Each time you click a country code, the country automatically moves to the selectbox on the right, indicating it has been selected.
- Select all countries by clicking Add All (Figure 1.6).
- Selected countries display in the selectbox on the right (Figure 1.7). Click each country code to remove it from the selected list.
- To remove all countries, click Remove All (Figure 1.8).
Figure 1
- To assign Passport users the same viewing permissions as Public users, click the checkbox next to Apply "Public Users" availability setting for Passport Members (Figure 2). When this is checked, Passport member options are grayed out and Passport members have the same availability permissions as the public. If these settings should be different from Public users, follow the steps in Figure 1.
Figure 2
- The new parameters are recorded and display in the dropdown menu. At any time you can return the asset to its original settings by clicking the Set to the Show's default setting: (Always Available) link located beneath each dropdown menu (Figure 3).
Figure 3
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.
Platform Management
The Platform Management section allows you to choose the platforms on which you want your asset to be available. If no platforms are selected, your asset will not appear anywhere and can only be accessed by the direct URL to the object.
- To search for a specific platform, type the platform name in the textbox provided (Figure 1.1) or click each individual platform (Figure 1.2).
- Click Add All to select all platforms (Figure 1.3).
- Each time you click a platform, it automatically moves to the selectbox on the right, indicating it has been selected (Figure 1.4).
- To remove all platforms, click Remove All (Figure 1.5). To remove a single platform, click the platform name and it will move back to the box on the left side.
- When finished, click Save (Figure 1.6).
Figure 1
Video and caption files
The video section is where you can add your video and closed captioning files. Add only one video file and one caption file per asset. The video and closed captioning files can be replaced at any time without disrupting the viewer experience. Learn more about replacing files
View closed captioning specifications
How to add your video and closed captioning files
- Click the Video tab (Figure 1).
Figure 1
Uploading media files
Many stations and producers use the direct file upload method (described below) to ingest video and caption files in Media Manager, or have a hosting service to generate upload URLs. While either of these methods is preferred, PBS can provide a temporary S3 hosting solution, if necessary.
The PBS S3 ingest bucket should only be used to generate temporary URLs for video and caption file ingestion in Media Manager, and should not be used for other purposes, or for long-term storage.
In an effort to minimize storage costs, beginning Jan. 4, 2021, files in the PBS S3 ingest buckets that are older than 30 days will be removed automatically. As a reminder, files successfully ingested in Media Manager are stored in a separate archive bucket, so the 30-day clean-up for source files in the ingest bucket does not affect availability. In other words, the ingest bucket is only used for the source file ingestion process.
Please contact PBS Support with questions or access requests.
- Add your video and caption files in one of the following ways (add only one video file and one caption file per asset):
- Type the full URL of the corresponding video or caption file in the first textbox of both the Video and Caption section (Figure 2.1). If choosing this option, the file must be hosted on a server and the full URL of the video file must be provided (example URL: http://s3.amazonaws.com/media/help/my-video-file.mp4).
- Click Choose to the right of the second textbox in each section to select a video or caption file from your computer (Figure 2.2).
- If you are not required to include 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 checkbox to the left of the Save button (Figure 2.4). When toggle is set to ON, your asset will publish automatically when all files have successfully ingested. See below to learn more about the auto-publish feature.
Click Save (Figure 2.5).
- If you choose to upload a video file directly from your machine, you must remain on the tab while the "Uploading" status is in progress (Helpful alert messaging will warn you). If you navigate away, the upload will be cancelled. Subsequent ingestion status states are not affected.
- As the video ingests and the proper profile is being detected by the system, a status displaying the label "Detecting" appears. In the case that auto-detection fails, an informational error message is displayed, along with the video profile select box. Manually select a video profile from the profile select box and proceed with the ingestion.
Figure 2
- The Status column updates with a percentage of completion as the file ingests (Figure 4.1).
- To cancel ingestion, click the icon to the right of the information icon under the Actions column (Figure 4.2). This feature is available for videos only since the ingestion process for caption files is typically very quick.
- When the files have fully ingested, the Status column displays Ingestion Complete (Figure 4.3).
Figure 4
- When the Status column displays Ingestion Complete for both your video and caption files (Figure 5.1), you can view the transcoded files.
- Click the information ( ) icon in both sections (Figure 5.2) to view all associated transcoded files.
If the Status column does not display Ingestion Complete after a few moments, refresh the page. If ingestion fails, save the asset again.
Figure 5
- In the Output Files section, click the user type associated with the transcoded files you want to view to expand the list (Figure 6).
- Public - files that display as videos available to everyone for an allotted period of time.
- All Passport Members - files that display as videos available for a specific window of time and available only to PBS Passport members.
- Your Station's Passport Members - files that display as videos available for a specific window of time and available only to the station(s) Passport members.
- Trick Play - files generated to surface preview thumbnail images when users scrub forward/backward within a video. For now, the files generated are supported by Roku only. Learn more
- Notes about Trick Play files: Only assets that have been created (or have had their video files re-ingested) since February 13, 2020 will have trick play files generated. Trick play output files are generated and displayed in the console after video ingestion has fully completed. Older videos will display a "No output files yet!" message in the Trick Play section of the output files. PBS is working to generate trick play files for older content. Furthermore, the trick play feature is not yet enabled on Roku devices, but should be shortly. No action is required by you.
If there are no output files after a minute or so, refresh the page.
Figure 6
- All transcoded files for the selected user type display (Figure 7.1). Click the profile type again to contract the results.
- Click the X in the upper right side of the page to close the menu (Figure 7.2).
Figure 7
How to replace video and closed captioning files
Live replace is a feature that enables you to replace a video and/or caption file without disrupting the viewing experience. While the file replace is in progress, viewers continue to access the video and captions that are currently live and can do so until the their cache has cleared or they begin a new session. For users who keep the original video screen open, or have paused playback for a period of time, the original file remains available for up to a day after the replacement is complete.
- To begin replacing your files, click the pencil icon to surface the fields where you can add a new file (Figure 1).
Figure 1
- Add the file URL in the textbox or click Choose to select a file from your computer (Figure 2.1).
- Click Save (Figure 2.2).
You can replace video and caption files simultaneously.
Figure 2
- While the file replace is in progress, information for both the original and new files displays. When the new file has fully ingested, a message indicating so displays at the top of the page (Figure 3.1) and Ingestion Complete displays to the right of the new file name (Figure 3.2).
- Refresh the page to remove the old file from view so that only details for the new file display (Figure 3.3).
If a replaced file fails ingestion for any reason, you will be prompted to cancel the replace (returning to the original file), or re-try the ingestion.
- Click Cancel to cancel the entire operation
- Click Try Again to try adding a new file again
Figure 3
Support for Audio Description and Secondary Languages
Media Manager supports video source files which include one or more audio tracks. (See Full Specs.)
For example, the video source file may have English as the primary audio track, and there could be additional tracks included for English Audio Description (AD), and other languages such as Spanish, French, etc.
What is Audio Description (AD): Additional audio content, inserted as a narrative between the dialogue and other program sounds, which describes visual aspects of the video that may not be accessible to some visually-impaired users. Audio Description is provided as a separate track, and users can choose to turn it on in addition to the primary audio track.
At this time, not all PBS platform players can support audio track selection, but this will be improved over time. See Full Specs to get more information about player support.)
Detected audio details are displayed for videos ingested on/after April 12, 2021 (when the support for multiple audio tracks was introduced). This can be found in the expandable Details area for the video file on an asset's Video tab.
- Note: For videos ingested prior to the feature release, the audio details will not be displayed in the console. In the future, we will determine how to handle populating the audio details for pre-existing video files. Stay tuned.
At this time, Media Manager only supports uploading a single closed captioning file, regardless of the number of audio tracks.
Get the Full Specs and learn more about uploading video files containing multiple audio tracks.
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.
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.
Admin screen | Definitions and Examples | ||||||||
---|---|---|---|---|---|---|---|---|---|
|
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 and access the Partner Player code. 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.
- Click Get Player Embed Code to access the Partner Player code. This code enables PBS producers to embed your asset. Learn more about the Partner Player
- 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.
Extras
An Extra is a type of Video Asset that can be associated with a Franchise, Show, 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.
Want to use your asset as the preview for your show on PBS.org? Click here to learn how
- From a Franchise, Show, or Season page, click the Extras tab (Figure 1).
Figure 1
Franchise | Show | Season |
---|---|---|
- 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.
Franchise | Show | Season |
---|---|---|
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)
How to reingest a video file
In some cases where, for example, an older video is lacking some of the modern output encodings, or if an output encoding fails to get generated during the initial transcode process, you can reingest the existing video file. Only video files that have an associated archive file available at its S3 location can be reingested. If the archived video file is glacierized in S3, the reingestion process takes about 5-12 hours to complete. The process is automated and video playback is not disrupted during the reingestion process.
Reingesting a video file is not intended for general troubleshooting or for bulk tasks. Please check the following before reingesting a file:
View the video on multiple devices and browsers
Check your internet connection to see if you have a slow connection
Verify that the video is published
Verify that the caption files are correctly ingested
Verify that the output files have been generated
The steps below illustrate how to reingest a video file in Media Manager.
- In the Media Manager console, go to the episode of the show that holds the video file you want to reingest and click the Video tab (Figure 1.1).
- In the Video section, under the Actions column on the right side of the page, click the orange circular left-facing arrow (Figure 1.2).
Figure 1
- To confirm that you want to initiate the ingestion process, click Yes, I'm sure in the bottom right side of the page (Figure 2).
Figure 2
- In the bottom right side of the screen, click Save (Figure 3.1).
- The status column reflects the state of the ingestion process (Figure 3.2).
Figure 3
- Once the video has completed ingestion, an Ingestion Complete confirmation label displays (Figure 4.1).
- Another confirmation indicating that the file has been reingested displays in a green bar and you are instructed to refresh your browser to update the page (Figure 4.2).
Figure 4
- Depending on your browser, you can refresh the page a couple different ways. The example below shows refreshing the page in a Chrome browser by right clicking your mouse and clicking Reload (Figure 5.1) or clicking the refresh button in the upper left side of the browser (Figure 5.2).
Figure 5
- After the page has been refreshed, the Status column displays Ingestion Complete, indicating that the video has been successfully reingested and can be played on PBS apps (Figure 6).
Figure 6