This topic specifies and defines the standard data attributes and the data quality required for live sports ad-hoc events published to Prime Video. These data attributes help customers find the events, and ensure that Prime Video provides a high-quality discovery experience across all live events. Low-quality metadata that is ambiguous or redundant across multiple events results in a poor customer experience, preventing customers from easily discovering and engaging with live sports content.
Customer experience with associate metadata
The following examples show how the provided live-event metadata that meet the quality requirements appears to customers in Prime Video carousels and detail pages.
Home page—Tentpole hero
The following image is an example of a tentpole hero for a live sports event.
Metadata quality requirements for tentpole hero:
- Title is easy to read and helps customers clearly understand what the broadcast covers. In this example, the title text is “Thursday Night Football: Jaguars vs. Jets”.
- Description provides additional context. This example mentions the teams’ playoff hopes, pregame coverage start time, an event sponsor, and the location of the game.
- Teams’ logos are included. The Jaguars and Jets logos appear under Continue watching.
- Graphic depicting event appears. Photos of a player from each team are shown in this example.
- Venue and event location appears. This information is part of the description text in this example.
- Background image is different than box art. In this example, bands of color appear behind the players’ graphic.
- Live badging (driven by broadcast schedule) appears. In this example, the badge is shown on top of the teams’ logos under Continue watching.
Live and upcoming events carousel
The following image is an example of a carousel for live and upcoming events.
Metadata quality requirements for carousel:
- Title is easy to read and helps customers clearly understand what the broadcast covers. Includes teams’ names and clarifies home versus away games. In this example, the title text is “Boston Celtics at Indiana Pacers”.
- Description provides additional context. This example promotes the NBA League Pass.
- Teams’ logos are included. In this example, the selected event shows the Celtics and Pacers logos.
- Background image depicting the event appears.
- Venue and event location appears.
- Event date and start time (driven by broadcast schedule) appears.
Glance view of detail page
The glance view (or carousel tile) of an event’s detail page appears when a customer hovers over the event in a carousel.
Metadata for carousel tiles:
- Image — team logos, team names, league logo. This example shows information for Man City versus Brentford.
- Live badging (driven by broadcast schedule).
- Entitlement. In this example, “Included with Prime”.
- Team names/event title.
- Event synopsis/team full names.
- Venue and event location.
- AMR rating (based on local regulatory authority).
Live event detail pages
The following image is an example of live event’s detail page.
Metadata for live event detail page:
- Background image.
- Live badging.
- Team names/event title. In this example, the title is “Manchester City v Brentford”.
- Customer reviews. This example shows a link where a customer can post a review.
- Event start date/time.
- Venue/event location.
- Event subtitles.
- Audio language.
Metadata categories
Metadata categories for live events are defined in the following table.
Category |
Definition |
Imagery |
Helps customers immediately recognize the live event, and enhances their discovery experience. Customers interact with images primarily when navigating through the live event carousels, and use them to decide what to watch. |
Event title |
Provides additional context about the live event. This enables customers to confirm that the live event is what they want to watch. |
Event description |
Provides additional context about the live event. This enables customers to confirm that the live event is what they want to watch. |
Event classifications |
Helps customers quickly discover the events or group of events they are interested in watching. Includes Sport, League, Tournament, Teams (for Team v Team Events) and Participants (for individual events). These classifications are required for live events to create theme-based collection pages and carousels. |
Location |
Indicates the host country, state, city, and venue for the live event. |
Broadcast schedule |
Indicates the month, day of the month, and the time in UTC that the live event is scheduled to start and end. |
Genre |
Indicates the genre of the live event (such as “sports”, “news”, or “concert”). |
Regulatory ratings |
Identifies programs with objectionable content and helps customers make more informed viewing choices. The ratings are made in accordance to local regulatory rating requirements. |
Broadcast audio languages |
Indicates the supported audio languages. Helps customers find events aired in the language that matters to them. |
Metadata locales |
Used to provide a consistent consumer experience, ensuring that discovery points (such as detail pages), text, and images are rendered in the proper language. |
Subtitles (closed captions) |
List of one or more subtitles/closed caption languages. Used to improve accessibility for hearing-impaired customers and for customers who do not speak the languages used in the audio track. |
Broadcast signal configuration |
Indicates the configuration of the live signal delivered by the partner. Includes bit rate, video resolution, frame rate, audio tracks, closed captions, feed identifier, and so on. |
Required data attributes and quality requirements
The following table lists the all the metadata attributes for live events, their quality standards for publishing, and whether they are required or optional:
- Required: The metadata attribute must be supplied to Prime Video Sports via the metadata ingest API and must meet the quality requirements.
- Optional: The metadata attribute is optional but must meet the quality requirements if supplied to Prime Video Sports via the metadata ingest API.
Importance |
Metadata category |
Sub category |
Data quality standardrequired for publishing |
Required |
(0) All categories |
All events |
Images, title, and description don’t contain broadcaster branding. |
Required |
(1) Imagery |
Box art—All events |
This helps customers immediately recognize the live event, and enhances their discovery experience. Customers interact with images primarily when navigating through the live event carousels, and use them to decide what to watch. 1920 x 1080 or 3840 x 2160 (preferred) image provided. |
Required |
(1) Imagery |
Box art—All events |
It’s important to have distinct images for each tile, and each image should accurately reflect the event to avoid customer confusion. Not all customers follow every sport. It’s key to use a distinguishing characteristic that helps customers recognize the sport, like a background picture of the field or court of play or the ball used. Distinct images for each event. Images are not repeating (for example, the same image for each tennis match in the tournament). Example:
|
Required |
(1) Imagery |
Box art—All events |
Image or graphic that depicts the event. Example: Contains likeness of team’s participants, field and/or court or ball specific to the sport. |
Required |
(1) Imagery |
Box art—Team v Team events |
For team vs. team sports, the event image must include the sport/league logo, team logos, players, flags, or graphics that represent both teams. Example: Liverpool and Manchester City logos. |
Optional |
(1) Imagery |
Box Art—All Events |
Includes league or competition logo. Example: Champions League logo. |
Required |
(1) Imagery |
Box Art—Player v Player Events |
For individual player vs. player events (such as tennis), the event image must include an image that orients the customer to the sport being played and who is playing (player headshot or player country flag). It might also include action shots of the players if available. Example: Images of Roger Federer and Rafael Nadal. |
Required |
(1) Imagery |
Box Art—Multi-sport events |
If there are multiple sports covered in the same broadcast, include the tournament/league logo and representation of the top sports covered in that stream. Example: Olympic coverage of skiing and snowboarding, reference to both sports included in image. |
Optional |
(1) Imagery |
Box Art—Multi-day Events |
For multi-game broadcasts, include the specific day of coverage as well as stadium/court to uniquely represent the stream. If coverage is limited to specific venues, include representation of venue in images. Example: |
Required |
(1) Imagery |
Box Art—All Events |
4x3 image with min resolution of 2560x1920. Example:
|
Required |
(1) Imagery |
Box Art—All Events |
A version of the image in the primary language of the distribution rights country is required. Example: If the event is being broadcast in France, any text on image is available in French. |
Optional |
(1) Imagery |
Box Art—All Events |
If the broadcast language is different from the primary language of the distribution rights country, a second broadcast language specific image is required. Example: Broadcast language is in Spanish, but if broadcast rights are in US, a second image must be provided with text in Spanish. |
Optional |
(1) Imagery |
Box Art—All Events |
Safe zone requirements Example:
|
Required |
(1) Imagery |
Background Image—All Events |
Image or graphic that depicts the event is required. Example:
|
Required |
(1) Imagery |
Background Image—All Events |
Image is different from box art. Example: Background images are required, but don’t have to be unique for each event. For example, you can use the same background for multiple events. |
Required |
(1) Imagery |
Background Image—All Events |
16x9 aspect ratio. 3840 x 2160 (preferred) or 1920 x 1080 resolution or better. |
Required |
(1) Imagery |
Background Image—All Events |
Safe zone requirements Example:
|
Optional |
(1) Imagery |
Tentpole Hero—All Events |
Two image sizes provided: 1920x1080 or 3840x2160. Example:
|
Optional |
(1) Imagery |
Poster Art—All Events |
Poster art provided for each event: 2000x3000. Example:
|
Optional |
(1) Imagery |
Standard Hero—All Events |
Standard hero provided in necessary sizes
Example:
|
Optional |
(1) Imagery |
Title Art—All Events |
3450x560 Example:
|
Optional |
(3) Event title |
Tournament/League Logo |
Logo representing the tournament or league the event is part of. Examples:
|
Required |
(3) Event title |
All events |
This should be easy to read and help customers clearly understand what the live event covers. Event titles should be distinct and specific to the underlying broadcast coverage. Example: Los Angeles Dodgers at Colorado Rockies |
Required |
(3) Event title |
All events |
Correct grammar and punctuation are required. |
Required |
(3) Event title |
All events |
Title is in the primary language of distribution rights country/region. |
Optional |
(3) Event title |
All events |
A second title may be provided in broadcast language if different from primary language of rights country/region. |
Optional |
(3) Event title |
All events |
English language title for one of the locale contributions. Example: En Español - Italy vs. England |
Optional |
(3) Event title |
All events |
The title length shall not exceed [X] character. |
Required |
(3) Event title |
Team v Team |
Title includes team names. Example: LA Galaxy, Seattle Sounders |
Optional |
(3) Event title |
Team v Team |
Title clarifies home versus away team. Example: Los Angeles Dodgers at Colorado Rockies |
Required |
(3) Event title |
Player v Player |
Title includes the player names. Example: Player 1 vs Player 2 |
Required |
(3) Event title |
One v Many |
Title includes the competition name. Example: Tour de France, The Masters |
Required |
(3) Event title |
Multi-game |
Title includes the competition name and day (if multiple days) or round. Example: Roland Garros Day 1, Roland Garros Round 1 |
Required |
(3) Event title |
Multi-game |
Title includes include the specific sport/stadium/court/day/player names to uniquely represent the stream when applicable. The ideal experience is to update the player names dynamically in real time to reflect the current game in progress. Example: Roland Garros Day 1 multiple streams includes titles for Roland Garros Day 1 R. Nadal vs. A. Murray, Roland Garros Day 1 Court 1 |
Required |
(3) Event title |
Multi-sport |
Title includes description of top sports covered in stream. Example: Olympic coverage of downhill skiing and snowboarding, reference to both sports included in title. |
Optional |
(3) Event title |
Multi-game |
Real-time titles updates to reflect the current game in progress. Example: Include “game delay” in the title |
Required |
(4) Event description |
All events |
This provides additional context about the live event. It enables customers to confirm that the live event is what they want to watch. Example: With AFC Playoff on the line, watch the Jaguars take on the Jets at the MetLife stadium |
Required |
(4) Event description |
All events |
In primary language of distribution rights country/region. |
Optional |
(4) Event description |
All events |
Description is in broadcast language if different from primary language of rights country/region. |
Optional |
(4) Event description |
All events |
Description includes event tournament/league name. Example: US Tennis Open 2023, English Premiere League |
Optional |
(4) Event description |
All events |
Description includes event venue/stadium/court info. Example: Emirate Stadium, Roland Garros Court Philippe Chatrier |
Optional |
(4) Event description |
All events |
Description includes the event location. Example: Paris, France |
Optional |
(4) Event description |
All events |
Description includes specific stage of the league/tournament. Examples: “Round 2” for tennis, “Roland Garros Quarter Final,” or “NBA Regular Season” |
Optional |
(4) Event description |
All events |
Description includes a headline significant of the event if available (call out popular players, highlight news, and so on). Example: With AFC playoff hopes on the line, the Jaguars face the Jets on TNF. Pregame coverage at 7pm ET with TNF Tonight live from MetLife stadium |
Optional |
(4) Event description |
Multi-sport |
Description includes description of sports covered in broadcast. Example: Wintersports: coverage of Snowboard, Freestyle Big Air, Moguls |
Required |
(5) Event classifications |
All events |
Sport. Classification is required for live events to create collection pages. Each game has a sport classification. Examples: Football, Tennis, Golf |
Required |
(5) Event classifications |
All events |
League/Entity. Classification is required for live events to create collection pages. Each game has a league classification. Examples: English Premiere League, Tour de France, UEFA Champions League |
Required |
(5) Event classifications |
All events |
Tournament/Competition. Classification is required for live events to create collection pages. Each game has a tournament classification. Examples: Roland Garros, Regular Season |
Required |
(5) Event classifications |
Team v Team |
Team. Classification is required for live events to create collection pages. Each game has a team classification. Example: Paris Saint Germain |
Required |
(5) Event classifications |
Player v Player |
Player. Classification is required for live events to create collection pages. Each game has a tournament classification. Includes the player first and last names. Example: Novak Djokovic, Casper Rudd |
Optional |
(5) Event classifications |
All events |
Gender. Examples: Mens, Women, Mixed, and so on |
Optional |
(5) Event classifications |
All events |
Round. Examples: Round of 32, 16, and so on |
Optional |
(5) Event classifications |
All events |
Format. Examples: Doubles, Singles, Legends |
Optional |
(6) Location |
All events |
Venue name. Indicates the stadium name where the event takes place. When a tournament happens in multiple locations, include specific details about the location. For streams covering multiple events happening at different locations, include the venue city name. Example: Aus Open Rod Laver Arena, Aus Open Court |
Optional |
(6) Location |
All events |
Venue country. Indicates the host country/region for the live event. Example: France |
Optional |
(6) Location |
All events |
Venue city. Indicates the host city for the live event. Example: Paris |
Optional |
(6) Location |
All events |
Venue state/province. Indicates the host state for the live event. Example: Levis Stadium, Santa Clara, California |
Required |
(7) Broadcast schedule |
All events |
Event start date time indicates the month and day of month and the time in UTC that the live event is scheduled to start. Event end date time indicates the month and day of month and the time in UTC that the live event is scheduled to end. Example: 2024-06-01T00:00:00Z |
Required |
(8) Genre |
All events |
Genre for the live event. Example: “Sport,” “Concert,” and so on. Should always be set to “sports” for live sports events. |
Optional |
(9) Regulatory ratings |
All events |
Content ratings in accordance to local regulatory rating requirements. Default will be all ages. Examples: Possible US values include G, PG, PG13, R, NR, and UR. |
Required |
(10) Broadcast audio languages |
All events |
List of one or more audio track languages. Examples: English, French, Spanish |
Required |
(11) Metadata languages |
All events |
Event metadata must be provided in the primary language of the country/region and (if different from primary country/region language) the language of the broadcast itself. Example: Events in the US must have metadata provided in English, Spanish in Mexico, and English and Spanish for Spanish language broadcasts in the US. |
Required |
(12) Subtitle (closed captions) languages |
All events |
List of one or more audio track languages (value may also be null). |
Required |
(13) Broadcast signal configuration |
All events |
Must include: video bit rate, video resolution, video frame rate, scan mode, dynamic range (SDR, HDR), audio tracks attributes, closed caption/subtitles attributes. |
