Video Central

Da guardare prima

Requisiti dei metadati del titolo

Watch this video for a quick walkthrough of the title metadata requirements at Prime Video.

Guarda questo video per una rapida panoramica dei requisiti dei metadati del titolo su Prime Video. Per saperne di più sulle nozioni di base dei metadati del titolo, consulta la guida riportata di seguito:

Metadati del titolo: panoramica

Quali metadati sono obbligatori per pubblicare un titolo su Prime Video

Standard di consegna MEC XML

Rispetta le seguenti regole per ogni consegna MEC XML.

Il file XML deve essere generato automaticamente. La creazione manuale può causare errori di consegna.
I file MEC devono rispettare le regole di denominazione dei file di Prime Video.
La definizione dello schema XML (XSD) e la relativa documentazione sono incluse nel pacchetto dei file di esempio.
I valori di ContentID e WorkType vengono fissati al primo invio. L’invio successivo di valori diversi provoca un errore di consegna.

Formato di ContentID

L’attributo @ContentID deve utilizzare il seguente formato URN. L’ID univoco (unique_ID), o Content ID (SKU), corrisponde al valore AltID/ALID previsto dalle specifiche MovieLabs.
Formato: md:cid:org:[partner_alias]:[unique_id]
Esempi:

Film: md:cid:org:wb:suicidesquadfeature
Serie: md:cid:org:amzn_studios_example:HighCastleSeries
Stagione: md:cid:org:amzn_studios_example:HighCastle1
Episodio: md:cid:org:amzn_studios_example:HighCastle1_1

Nel campo AltIdentifier/Identifier deve essere utilizzata esclusivamente la parte dell’ID. Ad esempio, utilizza HighCastle1_1, non l’URN completo.

Regole per gli aggiornamenti e gli invii parziali

Per aggiornare metadati già consegnati, utilizza esattamente lo stesso ContentID dell’invio originale.
La versione autorevole dei metadati è quella dell’invio più recente, determinato in base alla combinazione di lingua-locale e data e ora di consegna.
Gli aggiornamenti parziali sono supportati per gli attributi all’interno delle sezioni LocalizedInfo.
Gli aggiornamenti parziali non sono supportati per RatingSet e People. Includi sempre tutte le classificazioni e tutti i dati relativi al cast e alla troupe.
Se consegni due volte i metadati per la stessa combinazione di lingua-locale, il file più recente sostituisce quello precedente.

Struttura dei contenuti televisivi

MEC XML prevede specifiche regole strutturali per i contenuti TV.

Ogni episodio deve essere consegnato in un file MEC XML separato.
È possibile includere in un unico file MEC più varianti linguistiche dello stesso episodio.
Utilizza il campo ParentContentID per indicare la stagione di appartenenza dell’episodio.
Prime Video preferisce la consegna simultanea dei file XML relativi a serie, stagione ed episodio.
Se non è possibile effettuare una consegna simultanea, rispetta il seguente ordine: prima la serie, poi la stagione e infine l’episodio.

Requisiti per i riferimenti artwork

Tutte le tipologie di contenuto devono includere i riferimenti agli artwork nel file MEC.

Tipo di artwork	Valore @purpose	@resolution	Schema del nome del file
Artwork della copertina (4:3)	Artwork della copertina	3840x2160	[titolo]-[locale]-4x3.jpg
Artwork della copertina (16:9)	Artwork della copertina	3840x2160	[titolo]-[locale]-16x9.jpg
Artwork del riquadro (3:4)	Artwork del riquadro	1920x2560	[titolo]-[locale]-3x4.jpg
Artwork del poster (2:3)	Artwork del poster	2000x3000	[titolo]-[locale]-2x3.jpg

Entrambi gli attributi @resolution e @purpose sono obbligatori in ogni voce ArtReference. Tutte e quattro i tipi di artwork sono presenti nei modelli previsti per ogni tipo di contenuto.

Importante

Il titolo riportato nell’artwork deve corrispondere esattamente al valore TitleDisplayUnlimited nei metadati. Usa il valore per la lingua e l’area geografica specificate nel campo LocalizedInfo. I metadati costituiscono la fonte di riferimento ufficiale. Ad esempio, se nei metadati il titolo per es-ES è Night, anche l’artwork deve riportare Night. Non deve usare una traduzione alternativa come Noche, indipendentemente dalle scelte creative. Qualsiasi discrepanza comporta il mancato superamento dei controlli di qualità sulla localizzazione e la richiesta di correzione dei materiali. Per modificare il titolo riportato nell’artwork, aggiorna prima il valore di TitleDisplayUnlimited nei metadati. Quindi invia nuovamente l’artwork con il titolo corrispondente.

Formato dei generi

I generi devono utilizzare i codici ID specifici di Amazon nell’attributo @id. È possibile indicare fino a tre generi per ciascuna sezione LocalizedInfo. I primi due generi vengono visualizzati nella vetrina, il terzo viene utilizzato dagli algoritmi di reperibilità.
Formato: <md:Genre @id="[genre_code]">
Esempi di codici genere:

av_genre_action
av_genre_drama
av_genre_science_fiction

La prima voce relativa al genere deve includere l’attributo @source, che rimanda all’elenco dei generi di Amazon.

Campi obbligatori per tipologia di contenuto

Le tabelle seguenti riportano lo stato dei campi per ciascuna tipologia di contenuto, in base alla versione MEC 2.6. A causa del numero di tipologie di contenuto, le tabelle sono suddivise nelle sezioni seguenti.

Tabella Gruppo A: Film, episodio e stagione

Campo	Descrizione	Film	Episodio	Stagione
@ContentID	ID univoco dei metadati. Deve rispettare le best practice MovieLabs.	Obbligatorio	Obbligatorio	Obbligatorio
LocalizedInfo	Blocco di elementi localizzabili. È obbligatorio almeno un blocco.	Obbligatorio	Obbligatorio	Obbligatorio
@Language	Codice della lingua dall’elenco delle lingue consentite di Prime Video.	Obbligatorio	Obbligatorio	Obbligatorio
TitleDisplayUnlimited	Titolo del display. 250 caratteri max. Usato da Amazon.	Obbligatorio	Obbligatorio	Obbligatorio
TitleDisplay60	Titolo breve. 60 caratteri max.	Migliorativo	Migliorativo	Obbligatorio
ArtReference	Riferimenti ai file artwork con attributi relativi a risoluzione e finalità.	Migliorativo	Migliorativo	Migliorativo
Summary190	Sinossi breve. 190 caratteri max.	Obbligatorio	Obbligatorio	Obbligatorio
Summary400	Sinossi media. 400 caratteri max.	Obbligatorio	Obbligatorio	Obbligatorio
Summary4000	Sinossi estesa. 4.000 caratteri max.	Migliorativo	Migliorativo	Migliorativo
Genre	Almeno un genere Prime Video. Fino a 3 per LocalizedInfo.	Obbligatorio	Obbligatorio	Obbligatorio
ReleaseYear	Anno di prima uscita in un territorio.	Obbligatorio	Obbligatorio	Obbligatorio
ReleaseDate	Data di uscita specifica. Formato: AAAA-MM-GG.	Obbligatorio	Obbligatorio	Migliorativo
ReleaseHistory	Dati storici sulle uscite, con indicazione del territorio e dell’organizzazione.	Migliorativo	Ignorato	Migliorativo
WorkType	Classificazione dei contenuti: film, episodio, stagione ecc.	Obbligatorio	Obbligatorio	Obbligatorio
WorkTypeDetail	Classificazione aggiuntiva. Utilizzato per definire l’ordine all’interno di una serie.	Ignorato	Ignorato	Ignorato
AltIdentifier (Namespace + identificatore)	ID esterno: EIDR, ISAN, IMDB o ORG.	Obbligatorio	Obbligatorio	Obbligatorio
RatingSet	Classificazione ufficiale dei contenuti. Fornisci tutte le valutazioni disponibili.	Obbligatorio	Obbligatorio	Obbligatorio
People	Voci relative ai membri del cast e della troupe.	Obbligatorio	Obbligatorio	Obbligatorio
OriginalLanguage	Lingua della produzione originale.	Obbligatorio	Ignorato	Obbligatorio
AssociatedOrg (@role=licensor)	Organizzazione che concede le licenze con ID e ruolo.	Obbligatorio	Ignorato	Obbligatorio
SequenceInfo/Number	Numero dell’episodio o della stagione della serie.	Ignorato	Obbligatorio	Obbligatorio
Parent/ParentContentID	Collega episodio a stagione o stagione a serie.	Ignorato	Obbligatorio	Obbligatorio
CompanyDisplayCredit	Nome dello studio o dell’azienda mostrato ai clienti. 250 caratteri max.	Obbligatorio	Obbligatorio	Obbligatorio

Tabella Gruppo B: Serie, trailer, bonus e raccolta

Vedi Tabella Gruppo A per le descrizioni dei campi. Le stesse definizioni dei campi si applicano qui.

Campo	Serie	Trailer	Bonus	Raccolta
@ContentID	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
LocalizedInfo	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
@Language	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
TitleDisplayUnlimited	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
TitleDisplay60	Migliorativo	Migliorativo	Migliorativo	Obbligatorio
ArtReference	Migliorativo	Migliorativo	Migliorativo	Migliorativo
Summary190	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
Summary400	Ignorato	Ignorato	Obbligatorio	Obbligatorio
Summary4000	Migliorativo	Ignorato	Ignorato	Migliorativo
Genre	Obbligatorio	Ignorato	Ignorato	Obbligatorio
ReleaseYear	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
ReleaseDate	Migliorativo	Ignorato	Ignorato	Migliorativo
ReleaseHistory	Ignorato	Ignorato	Ignorato	Ignorato
WorkType	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
WorkTypeDetail	Migliorativo	Ignorato	Ignorato	Obbligatorio
AltIdentifier	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
RatingSet	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio
People	Ignorato	Ignorato	Ignorato	Ignorato
OriginalLanguage	Ignorato	Ignorato	Ignorato	Ignorato
AssociatedOrg (@role=licensor)	Ignorato	Ignorato	Ignorato	Ignorato
SequenceInfo/Number	Ignorato	Obbligatorio	Obbligatorio	Ignorato
Parent/ParentContentID	Ignorato	Ignorato	Obbligatorio	Ignorato
CompanyDisplayCredit	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio

Suggerimento rapido

Per indicazioni dettagliate sulla consegna di trailer e contenuti bonus, consulta la guida Materiale a valore aggiunto (VAM).

Dettaglio dei campi migliorativi

Le tabelle seguenti descrivono i sottocampi degli elementi principali migliorativi. Utilizzali per fornire metadati più completi e migliorare la reperibilità dei contenuti.

Sottocampi relativi alle persone

Sottocampo	Descrizione	Film	Episodio	Stagione
Job	La qualifica professionale della persona (ad esempio, attore, regista).	Obbligatorio	Migliorativo	Obbligatorio
JobFunction	Ruolo funzionale: regista, produttore, attore, scrittore o creator.	Obbligatorio	Migliorativo	Obbligatorio
BillingBlockOrder	Controlla l’ordine di visualizzazione del cast nella pagina dei dettagli.	Migliorativo	Migliorativo	Migliorativo
Character	Nome del personaggio interpretato dal membro del cast.	Migliorativo	Migliorativo	Migliorativo
Guest	Segnala le partecipazioni di ospiti per migliorarne la reperibilità.	Migliorativo	Migliorativo	Migliorativo
Name/DisplayName	Nome visualizzato completo della persona.	Obbligatorio	Obbligatorio	Obbligatorio
Name/SortName	Nome utilizzata per l’ordinamento alfabetico.	Migliorativo	Migliorativo	Migliorativo
Gender	Sesso della persona. Supporta consigli personalizzati.	Migliorativo	Migliorativo	Migliorativo

Sottocampi RatingSet

I sottocampi RatingSet riportati di seguito si applicano a tutti i tipi di contenuto.

Sottocampo	Descrizione	Film	Episodio	Stagione
Classificazione	Il blocco di classificazione dei contenuti.	Obbligatorio	Obbligatorio	Obbligatorio
Region	Area geografica in cui si applica la classificazione.	Obbligatorio	Obbligatorio	Obbligatorio
Country	Codice ISO del Paese a cui si applica la classificazione.	Obbligatorio	Obbligatorio	Obbligatorio
System	Sistema di classificazione utilizzato (ad esempio, MPAA, BBFC).	Obbligatorio	Obbligatorio	Obbligatorio
Value	Il valore della classificazione (ad esempio, PG-13, 12A).	Obbligatorio	Obbligatorio	Obbligatorio
Reason	Descrizione della classificazione mostrata nella pagina dei dettagli del titolo.	Migliorativo	Migliorativo	Migliorativo
NotRated	Usare quando non esiste una classificazione ufficiale in nessun territorio.	Obbligatorio	Obbligatorio	Obbligatorio
IsAdult	Contrassegna i contenuti per adulti per la classificazione e il filtraggio.	Migliorativo	Migliorativo	Migliorativo

Sottocampi ReleaseHistory (film e stagione)

Sottocampo	Descrizione	Film	Stagione
DistrTerritory	Codice del Paese per il territorio di distribuzione.	Migliorativo	Migliorativo
ReleaseOrg	Organizzazione coinvolta nella distribuzione del titolo.	Migliorativo	Migliorativo
@organizationID	Identificativo univoco dell’organizzazione che distribuisce il titolo.	Migliorativo	Migliorativo
@idType	Tipo di ID dell’organizzazione utilizzato.	Migliorativo	Migliorativo
@role	Ruolo svolto dall’organizzazione nell’ambito dell’uscita.	Migliorativo	Migliorativo
DisplayName	Nome visualizzato dell’organizzazione che distribuisce il titolo.	Migliorativo	Migliorativo
SortName	Nome dell’organizzazione utilizzata per l’ordinamento.	Migliorativo	Migliorativo

Sottocampi di AssociatedOrg (film e stagioni)

Sottocampo	Descrizione	Film	Stagione
@organizationID	Identificativo univoco dell’organizzazione che concede la licenza.	Obbligatorio	Obbligatorio
@role	Deve essere “licensor”.	Obbligatorio	Obbligatorio
DisplayName	Nome visualizzato del licenziante.	Migliorativo	Migliorativo
SortName	Nome utilizzata per l’ordinamento alfabetico.	Migliorativo	Migliorativo
AlternateName	Nome alternativo per il licenziante.	Migliorativo	Migliorativo

Sottocampi migliorativi di LocalizedInfo

Sottocampo	Descrizione	Film	Episodio	Stagione
Region	Area geografica per i metadati localizzati.	Migliorativo	Migliorativo	Migliorativo
Country	Codice del Paese per i metadati localizzati.	Migliorativo	Migliorativo	Migliorativo
OriginalTitle	Titolo in lingua originale. Migliora la ricerca di contenuti internazionali.	Migliorativo	Migliorativo	Migliorativo
PeopleLocal	Nomi localizzati del cast e della troupe per agevolare la ricerca nella regione di riferimento.	Migliorativo	Migliorativo	Migliorativo

Altri campi migliorativi

Campo	Descrizione	Film	Episodio	Stagione
CountryOfOrigin	Paese in cui è stato prodotto il titolo.	Migliorativo	Migliorativo	Migliorativo
PrimarySpokenLanguage	Lingua principale parlata nel contenuto.	Migliorativo	Migliorativo	Migliorativo
VersionLanguage	Lingua della specifica voce di metadati.	Migliorativo	Migliorativo	Migliorativo
RunLength	Durata del titolo. Visualizzata nella pagina di dettaglio.	Migliorativo	Migliorativo	Ignorato
Location	Dati geografici utilizzati per garantire l’accuratezza dei metadati.	Migliorativo	Migliorativo	Migliorativo

Valori delle relazioni gerarchiche

Tipo di contenuto	@relationshipType	ParentContentID` identifica
Episodio	isepisodeof	ContentID della stagione
Stagione	isseasonof	ContentID della serie
Trailer	ispromotionfor	ContentID del film o della stagione
Bonus	issupplementalto	ContentID del film o della stagione

Ordinamento di stagioni ed episodi

Puoi personalizzare l’ordine di visualizzazione di stagioni ed episodi per i clienti utilizzando WorkTypeDetail a livello di serie.

Value	Comportamento	Ideale per
StartAtLatestSeasonFirstEpisode	Mostra prima l’ultima stagione, a partire dall’episodio 1.	Serie antologiche, notizie, sport, talk show, game show
StartAtLatestSeasonLatestEpisode	Mostra prima l’ultima stagione e l’ultimo episodio.	Notizie, sport e talk show in cui i contenuti più recenti sono più pertinenti
Chronological	Ordine cronologico standard.	Serie tradizionali in cui l’ordine di visione è importante
(Nessun valore impostato)	Ordinamento automatico in base al tipo di contenuto.	Comportamento predefinito

Imposta questo valore solo per il MEC a livello di serie. Si applica automaticamente a tutte le stagioni.
Questo campo si applica solo alle serie TV. Non applicabile a film o VAM.
Puoi aggiornare questo valore in qualsiasi momento. Le modifiche diventano effettive dopo l’elaborazione del MEC.
Per le tipologie di contenuto supportate (notizie, sport, talk shows e game show), l’ordinamento inverso viene applicato automaticamente.

Supporto multilingue

Il modello per gli episodi disponibile nel repository dei file di esempio mostra come includere più lingue in un unico file MEC. Inserisci un blocco LocalizedInfo separato per ogni combinazione di lingua e locale.

Esempio di struttura:

Primo blocco LocalizedInfo: @language="en-US”, con titolo, artwork, sinossi e generi
Secondo blocco LocalizedInfo: @language="es-419", con titolo localizzato, artwork, sinossi e generi

Ogni blocco LocalizedInfo deve contenere i propri campi TitleDisplayUnlimited, voci ArtReference, Summary190, Summary400 e voci Genre.

Campi MEC XML non utilizzati

I seguenti campi sono accettati dallo schema XSD MEC, ma non vengono utilizzati da Prime Video. Puoi includerli per garantire la conformità allo schema XSD, ma non producono alcun effetto.

UpdateNum
LocalizedInfo @Default
TitleSort (è possibile utilizzare tag vuoti per garantire la conformità allo schema XSD)
Keyword
AlternateTitle
PictureColorType
PictureFormat
AspectRatio
DistributionNumber
HouseSequence
CountryRegion (in LocalizedInfo e RatingSet)

Codifica dei caratteri speciali

I caratteri speciali nei campi della sinossi possono causare errori di pubblicazione se non vengono codificati correttamente. Utilizza i riferimenti alle entità XML previsti per questi caratteri.

Simbolo	Inserisci come
<	<
>	>
&	&
'	'
"	"

I seguenti simboli possono essere utilizzati senza codifica: barra verticale (|), punto (.), cancelletto (#), barra obliqua (/) e punto esclamativo (!).

Contenuti di Materiale a valore aggiunto (VAM) nel file MEC XML

I trailer e i contenuti bonus sono trattati come entità di contenuto distinte. Per indicazioni dettagliate sulla consegna di trailer e contenuti bonus, consulta la guida Materiale a valore aggiunto (VAM). Si applica la maggior parte dei valori MEC standard. Requisiti principali per la consegna:

Utilizza WorkType = “promotion” per i trailer.
Utilizza WorkType = “supplemental” per i contenuti bonus.
Il tipo di relazione gerarchica deve essere “ispromotionfor” oppure “issupplementalto”.
I blocchi SequenceInfo e Parent sono obbligatori.

Requisiti di localizzazione

I metadati possono essere consegnati in più lingue.
Ogni versione localizzata deve specificare il relativo codice lingua.
Gli aggiornamenti parziali sono supportati per i campi localizzati, come il titolo e la sinossi.
Gli aggiornamenti parziali NON sono supportati per le classificazioni e i dati relativi al cast e alla troupe. Includi sempre tutti i dati disponibili.
Per una determinata lingua, la versione autorevole è quella dell’invio più recente, in base alla data e all’ora di consegna.

Da sapere prima di iniziare

Genera automaticamente il file MEC XML. La creazione manuale può causare errori.

Utilizza il formato URN completo (md:cid:org:[partner_alias]:[id]) per @ContentID e ParentContentID.

Nel campo AltIdentifier/Identifier, utilizza esclusivamente la stringa dell’ID, senza il formato URN.

Includi tutte e quattro le voci ArtReference per ogni tipologia di contenuto, salvo che gli artwork vengano referenziati nel file MMC. Il file MMC è il metodo di consegna degli artwork preferito da Amazon.

Il file MEC a livello di serie non richiede i campi People o ReleaseDate. Non includerli.

Il file MEC a livello di stagione non richiede ReleaseDate o ReleaseHistory. È sufficiente ReleaseYear.

Includi sempre tutte le classificazioni e tutti i dati relativi al cast e alla troupe in ogni consegna. Non sono supportati aggiornamenti parziali per questi campi.

Ogni episodio deve avere un proprio file MEC. Non raggruppare più episodi in un unico file XML.

Codifica correttamente i caratteri speciali nei campi della sinossi per evitare errori di pubblicazione.

Imposta WorkTypeDetail esclusivamente a livello di serie. Il valore viene ereditato da tutte le stagioni.

Suggerimento rapido

Le consegne MEC non conformi comportano richieste di nuovo invio dei materiali, con conseguenti ritardi nella pubblicazione del titolo. Le cause più comuni sono ID ContentID non corrispondenti, relazioni gerarchiche con il titolo principale mancanti, formattazione errata dei riferimenti ArtReference e caratteri speciali non codificati correttamente.

Una rapida convalida rispetto allo schema XSD prima dell’invio può evitare giorni di verifiche e successive correzioni.

Hai domande? Prima di aprire un ticket di assistenza tramite Contattaci, prova a consultare il Support Assistant oppure contatta il tuo referente Prime Video.

Metadati del titolo: MovieLabs MEC XML

Da guardare prima

Requisiti dei metadati del titolo

Standard di consegna MEC XML

Formato di ContentID

Regole per gli aggiornamenti e gli invii parziali

Struttura dei contenuti televisivi

Requisiti per i riferimenti artwork

Formato dei generi

Campi obbligatori per tipologia di contenuto

Dettaglio dei campi migliorativi

Sottocampi relativi alle persone

Sottocampi RatingSet

Sottocampi ReleaseHistory (film e stagione)

Sottocampi di AssociatedOrg (film e stagioni)

Sottocampi migliorativi di LocalizedInfo

Altri campi migliorativi

Valori delle relazioni gerarchiche

Ordinamento di stagioni ed episodi

Supporto multilingue

Campi MEC XML non utilizzati

Codifica dei caratteri speciali

Contenuti di Materiale a valore aggiunto (VAM) nel file MEC XML

Requisiti di localizzazione

Da sapere prima di iniziare

In questa guida