This topic outlines how to deliver TV trailer and bonus value-added material (VAM). (For guidance on movie trailer delivery, see Movie value-added material (VAM).)
Trailers and bonus content for TV are delivered and displayed on the storefront on a season level. Similar to episode delivery, VAM titles are treated as children of a season. Each VAM content asset requires:
- A unique identifier/SKU
- Dedicated metadata (MEC)
- Dedicated manifest (MMC)
- Avails (EMA)
- Component-based playable package with a semi-textless mezzanine and discrete timed text and secondary audio.
- Artwork
Supported VAM types
Prime Video supports delivery of trailer and bonus content. These are differentiated upon metadata delivery: you must provide a “promotion” value for trailers and a “supplemental” value for bonus content. Categorizing these correctly is essential, because it drives the storefront experiences by accurately placing each VAM in the appropriate spot on the title display page.
- Trailers
Main trailer, teaser, 30-second trailer, title announcement, and so on. - Bonus
Behind the scenes, bloopers, making of, and so on.
Storefront experience
VAM content is shown on a title’s display page in two unique placements:
1. Trailer button
2. Extras tab
The Extras tab appears only when:
- More than a single trailer is provided (for example, a teaser and a main trailer are delivered)
- Trailer(s) and bonus content are provided
- Only bonus content is provided
Titles delivered with a “promotion” WorkType in the MEC appear under Trailers. Titles delivered with a “supplemental” WorkType in the MEC appear under Bonus.
VAM is ordered according to the latest start date submitted in the Avails. Prime Video reserves the right to re-order VAM content to provide the best customer experience.
Metadata (MEC) references
MEC delivery for TV VAM is nearly identical to a TV episode as all required fields for episodes are also required for VAM. To successfully ingest VAM metadata, make sure parent level metadata (series and season) are submitted first.
The following table lists VAM-relevant fields in MEC title metadata:
| Field name | Definition and notes | Accepted values | Prime Video usage |
TitleDisplayUnlimited | The title that will be displayed on the storefront. It’s recommended to only include the VAM type, and exclude the main title of the Parent. Localized values are expected when localized metadata for the Parent is provided. | Suggested title examples:
| Required |
WorkType | Type of the work.
| promotional | Required |
Parent | Identifies the parent (season) title. | Required for WorkType “promotion” and “supplemental” | |
@relationshipType | Type of the work.
|
| Required for Parent |
ParentContentID | ContentID of the season metadata | Required | |
SequenceInfo | Sequence information for VAM. Required for ingestion, but not currently used to determine storefront order priority. | Integer | Required for WorkType “promotion” and “supplemental” |
Number | Sequence number that will be used to identify the display order of VAM. Order priority is determined by the highest sequence number provided. The highest number appears first. | Integer | Required for WorkType “promotion” and “supplemental” |
Manifest (MMC) references
MMC delivery for VAM content is almost identical to an episode or movie MMC delivery. The only
differences are the values expected under the Experiences section of the MMC. Please be sure to correctly identify the SubType in your VAM MMC delivery, as shown in the following examples.
Warning: Failure to provide this information will lead to a playback error on the detail page. Therefore, it’s critical to provide the following information in the VAM MMC file.
Trailers:<manifest:Type>Main</manifest:Type> <manifest:SubType>Trailer</manifest:SubType>
Bonus:<manifest:Type>Main</manifest:Type> <manifest:SubType>Bonus</manifest:SubType>
Note: These requirements are in addition to the MMC requirements found in the MMC asset manifest.
Content rights (EMA Avails)
Avail delivery is required to publish TV VAM content for all business lines avails that are submitted. VAM avails can be delivered along with your episode avails, or separately on a dedicated VAM tab. Please reference the samples available on this page for more information. Note that not all license types can be used for VAM content.
- Trailers
All trailers (delivered with a promotion value in the MEC) must be submitted as FVOD. This ensures that customers can sample content without being logged in, making a purchase, or subscribing to a channel. - Bonus
Bonus content (delivered with a supplemental value in the MEC) can be submitted as FVOD or SVOD. Use FVOD if the content is intended to be available to all customers. Use SVOD if the content is intended to be available only to customers who have a valid channel subscription.
The following table lists VAM-relevant fields in EMA avails.
| Field name | Definition and notes | Accepted values | Prime Video usage |
|---|---|---|---|
| WorkType | Type of the work. Trailers and bonus: supplemental | supplemental | Required |
| LicenseType | Trailer: FVOD Bonus: FVOD, SVOD | FVOD, SVOD | Required |
Artwork
Trailer and bonus art is 16:9 artwork that captures the context for the trailer or bonus content. Similar to episodic art, this is usually a still from the trailer or bonus content, and must be free of any text elements unless it’s a part of the overall image (for example, a sign behind the protagonist with text on it). The accepted value for Purpose in the manifest delivery is “cover”. If artwork is not provided for trailer and bonus content, Prime Video will fall back to the season content.
Samples
The following sample files provide commented code and field examples that you can edit to reflect your own information. Right-click a link and select Save link as to save the file to your computer. You can then make changes in Excel and/or XML editors.
MEC trailer sample file
MEC bonus sample file
MMC trailer sample file
MMC bonus sample file
Avails bonus and trailer sample file
