Componenti del pacchetto in sintesi
Un pacchetto completo è composto da cinque componenti:
1. EMA Avails
2. Metadati MEC
3. Manifest MMC
4. Risorse multimediali riproducibili
5. Risorse artwork globali
Importante
Nella tabella seguente viene fornita una panoramica dei cinque componenti di un pacchetto MovieLabs.
Tutti i file XML devono essere generati automaticamente. La creazione manuale non è accettata. Consegna i pacchetti tramite Consegna di file in blocco (XML) o Invio standard (Aspera on Cloud o AWS S3).
Componente |
Requisito |
Perché è importante |
Metodi di consegna |
Formato |
EMA Avails |
Obbligatorio (TVOD, canali, SVOD CPH) |
Definisce i diritti relativi ai contenuti: territorio, tipo di licenza, durata e prezzo |
Consegna di file in blocco |
XLS (EMA da v1.6 a v1.9) |
Metadati del titolo (MEC) |
Obbligatorio |
Descrive il titolo: nome, sinossi, cast, classificazioni e genere |
Consegna di file in blocco |
XML (MEC v2.6) |
Risorse riproducibili |
Obbligatorio |
Video, audio, sottotitoli, sottotitoli forzati e schede di doppiaggio |
Consegna standard (Aspera o S3) |
File multimediali (secondo le specifiche PV) |
Artwork globale |
Obbligatorio |
Artwork della copertina, artwork per episodi, artwork del riquadro, artwork del poster e artwork principale |
Consegna standard (Aspera o S3) |
JPEG o PNG (RGB) |
Manifest delle risorse (MMC) |
Obbligatorio |
Associa tutte le risorse al titolo e alla relativa finestra dei diritti |
Consegna di file in blocco |
XML (MMC v1.5) |
Come sono collegati i componenti
Ogni componente del pacchetto è collegato tramite un unico identificatore condiviso.
- In EMA v1.7 e versioni successive, questo identificatore è il Logical Asset ID (ALID)
- In EMA v1.6, questo identificatore è l’AltID
Considera l’ALID o l’AltID come il “filo conduttore” che attraversa l’intero pacchetto. Prime Video utilizza questo ID per associare i diritti ai corretti metadati del titolo e ai file multimediali.
Questo identificatore deve comparire in modo identico in tre punti:
1.EMA Avail: L’EMA Avail indica a Prime Video dove e quando un titolo può essere offerto e a quale prezzo.
2.File MEC: Il file MEC descrive tutte le informazioni sul titolo visualizzate dai clienti. Include nome, descrizione, cast e genere.
3.Manifest MMC: Il manifest MMC associa ogni file multimediale al titolo e alla relativa finestra dei diritti. Comprende video, audio, testo sincronizzato e artwork.
EMA Avails
Il file EMA Avails fornisce a Prime Video i diritti di sfruttamento del contenuto. Prime Video supporta le versioni da 1.6 a 1.9 degli EMA XLS Avails. La dimensione massima è di 60.000 righe per invio.
Importante
Tipi di voce
Sono accettati solo due tipi di voce: Full Extract e Full Delete.
- Full Extract: Sostituisce tutte le voci Avail attuali e future all’interno dello stesso ambito. L’ambito è costituito dalla combinazione univoca di sei elementi: licensor, unique ID, GroupIdentity, quality, territory e rights model. Ogni volta che invii un Full Extract per un determinato ambito, le voci precedenti vengono sostituite.
- Full Delete: Viene utilizzato esclusivamente per rimuovere file Avail errati. Si applica solo ai contenuti che non hanno ancora ricevuto metadati corrispondenti. Per far scadere contenuti attivi, invia invece un Full Extract con una data di fine appropriata.
Campi relativi alla lingua
I campi relativi alla lingua utilizzano i codici lingua RFC 5646. Puoi aggiungere suffissi di localizzazione per specificare il tipo di risorsa.
Ad esempio, es-419:sub si applica esclusivamente ai sottotitoli in spagnolo latinoamericano. Non si applica all’audio doppiato. Puoi includere più lingue nello stesso campo, separandole con virgole.
Suffisso |
Significato |
:sub |
Solo risorse di sottotitoli |
:dub |
Solo risorse audio doppiate |
:subdub |
Sia sottotitoli sia risorse doppiate |
:any |
Qualsiasi tipo di localizzazione per quella lingua |
Campi obbligatori principali
Campo |
Note sui requisiti |
DisplayName |
Il Prime Video PartnerAlias che ti è stato assegnato. Utilizzato per associare i diritti ai pacchetti di risorse. |
Territory |
Codice territorio ISO 3166-1 per il quale vengono concessi i diritti. |
WorkType |
Film, Stagione, Episodio o Supplemental. |
EntryType |
Solo Full Extract o Full Delete. |
LicenseType |
EST, VOD, SVOD, AVOD, POEST, FVOD. |
FormatProfile |
HD, SD, 4K o UHD. Per SVOD, specifica la risoluzione massima. |
Start |
Inizio del periodo di validità della licenza. Utilizza il formato AAAA-MM-GG o ISO 8601. È sempre obbligatorio. |
PriceType / PriceValue |
Obbligatori per tutti i diritti TVOD. PriceType accetta WSP, Tier o Category. |
PriceCurrency |
Codice valuta ISO 4217. Obbligatorio quando PriceType è WSP o quando viene fornito SRP. |
ALID (v1.7+) / AltID (v1.6) |
Deve essere identico al ContentID nel MEC e all’ALID nel MMC. |
Metadati del titolo: MEC
Il file MEC è un documento XML che contiene il nome visualizzato, la sinossi, il genere, il cast, la troupe, le classificazioni e l’anno di uscita. Il MEC segue la specifica MovieLabs MEC v2.6. Deve essere generato automaticamente. La creazione manuale non è accettata. Come l’EMA Avail, il MEC viene consegnato tramite Consegna di file in blocco mediante Aspera on Cloud o AWS S3.
Regole del ContentID
Ogni file MEC è associato a un ContentID. Questo ID viene fissato al primo invio. Una volta stabilito, deve rimanere invariato per tutti gli aggiornamenti futuri del titolo. I ContentID devono corrispondere all’ALID o all’AltID presenti nell’EMA Avail e nel manifest MMC. Possono contenere fino a 50 caratteri. Sono consentiti esclusivamente caratteri alfanumerici, trattini e trattini bassi.
Localizzazione
Puoi fornire più blocchi LocalizedInfo in un singolo file MEC. Ogni blocco è associato a una lingua diversa. È obbligatorio avere almeno un blocco LocalizedInfo. Deve essere contrassegnato come predefinito, ovvero come lingua originale della produzione. Tutte le informazioni descrittive sul titolo devono provenire dal file MEC. Questo include classificazioni, regista e cast. Non inserire queste informazioni nell’EMA Avail.
Esempi di lingua originale e lingua localizzata
Gli esempi seguenti mostrano come le risorse del pacchetto corrispondono a ciò che i clienti visualizzano per un determinato titolo su Prime Video.
- Metadati del titolo, tra cui il nome del film, la descrizione, il regista, gli interpreti e il genere, vengono visualizzati a sinistra.
- A destra viene visualizzata un’immagine del film (artwork globale).
- Le risorse riproducibili disponibili per il cliente includono sottotitoli per non udenti o ipoudenti in inglese, audio in inglese e audiodescrizione, oltre al pulsante Guarda ora.
- Gli Avails visualizzati dal cliente in questo esempio includono il pulsante Guarda ora e il pulsante Download.
Campi obbligatori in sintesi
Campo |
Note sui requisiti |
ContentID |
Fisso al primo invio. Massimo 50 caratteri. Solo caratteri alfanumerici, trattini e trattini bassi. Deve corrispondere ad ALID/AltID. |
TitleDisplayUnlimited |
Titolo visualizzato da Prime Video. Massimo 250 caratteri. Obbligatorio. |
Summary190 |
Sinossi ridotta. Massimo 150 caratteri (limite Prime Video). Obbligatorio. |
Summary400 |
Sinossi intera. Massimo 400 caratteri. Obbligatorio. |
Genre |
È richiesto almeno un genere Prime Video. Sono consentiti fino a tre generi distinti per titolo. |
ReleaseYear |
Primo anno in cui l’opera è stata distribuita in un qualsiasi territorio. Obbligatorio. |
ReleaseDate |
Data della prima uscita nelle sale o della première, nel formato AAAA-MM-GG. Obbligatorio. |
RatingSet |
Classificazione del contenuto. Il sistema e il valore devono provenire dall’elenco delle classificazioni MovieLabs. Obbligatorio. |
People (Director) |
Per i film è richiesta almeno una voce Director. |
AssociatedOrg |
È richiesta una voce con il tuo Prime Video PartnerAlias e il ruolo = “licensor”. |
Struttura dei contenuti TV
Ogni episodio richiede un proprio file XML MEC. Gli episodi sono collegati alla stagione parent tramite un ParentContentID. Le stagioni sono collegate alla serie parent nello stesso modo. Segui questa gerarchia per la consegna: Serie → Stagione → Episodio. Ogni livello deve contenere il SequenceInfo corretto (campo Number). Questo garantisce che episodi e stagioni vengano visualizzati nell’ordine corretto.
Per tipi di contenuto speciali, come notiziari, programmi sportivi, talk show e game show, utilizza il campo WorkTypeDetail. Questo consente a Prime Video di applicare la corretta logica di ordinamento e visualizzazione.
Per la specifica completa dei campi MEC e i file di esempio, consulta: Metadati del titolo MEC e File di esempio MEC
Manifest delle risorse: MMC
Il file MMC è il documento centrale di organizzazione del pacchetto. Associa ogni file multimediale al titolo, alla relativa presentazione e alla finestra dei diritti. Senza un MMC valido, Prime Video non può associare le risorse al titolo corretto. L’MMC è un file XML generato automaticamente e consegnato tramite Consegna di file in blocco. Deve essere conforme alla specifica MovieLabs MMC v1.5.
L’MMC comprende cinque sezioni:
Sezione MMC |
Funzione |
Inventory |
Elenca ogni risorsa con i relativi metadati tecnici (codec, checksum, lingua, parametri HDR). |
Presentations |
Raggruppa le tracce sincronizzate video, audio e testo sincronizzato. Una per ciascun set di tracce. |
Playable Sequences |
Definisce l’ordine di riproduzione, inclusi contenuti pre-roll e post-roll. Associa le schede di doppiaggio. |
Experiences |
Raggruppa sequenze e artwork in un’unità di visualizzazione per territorio o lingua. |
ALID-Experience Mapping |
Collega i diritti EMA (tramite l’ALID) alla Experience corretta. |
Consegna parziale del pacchetto
È supportata la consegna parziale dell’MMC. Quando aggiorni un sottoinsieme di risorse, includi solo le risorse aggiornate. Non è necessario consegnare nuovamente l’intero pacchetto. L’ALID deve corrispondere tra il pacchetto iniziale e qualsiasi pacchetto di aggiornamento.
Struttura degli identificatori delle risorse
Gli URI utilizzati come identificatori delle risorse all’interno dell’MMC seguono una struttura specifica:
<namespace>:<type>:<scheme>:<SSID>:<AdditionalInfo>
Questi URI devono essere coerenti in tutto l’MMC. I valori namespace e SSID vengono stabiliti durante l’onboarding.
Per la specifica completa dell’MMC e i file di esempio, consulta: Manifest delle risorse MMC e Repository di file di esempio
Risorse riproducibili
Le risorse riproducibili sono i file multimediali che i clienti guardano quando premono il pulsante di riproduzione. Un set completo comprende un video master, l’audio nella lingua originale, le tracce audio doppiate, i file di testo sincronizzato e le schede di doppiaggio.
Tutte le risorse devono essere conformi alle specifiche tecniche di Prime Video. Devono inoltre essere referenziati nel manifest MMC.
Tipo di risorsa |
Cosa devi sapere |
Video |
Deve essere parzialmente senza testo, senza sottotitoli impressi. È consentito il testo creativo originale (titoli di coda, titoli, indicazioni di luoghi). I sottotitoli forzati devono essere forniti come file di testo sincronizzato separati. La traccia audio originale deve essere muxata nel file mezzanine insieme al video. Per maggiori informazioni consulta: Requisiti per i video |
Audio alternativo |
Un file separato per ogni lingua doppiata. Ogni file deve essere conforme al video mezzanine. Include l’audiodescrizione per le persone con disabilità visive. Per maggiori informazioni consulta: Requisiti audio |
Sottotitoli forzati |
Traducono il testo visualizzato sullo schermo o i dialoghi in lingua straniera non presenti nell’audio principale. Sono obbligatori per ogni lingua audio alternativa fornita. Per maggiori informazioni consulta: Sottotitoli per le risorse riproducibili |
Sottotitoli completi |
Trascrizione completa di tutti i dialoghi. Devono includere tutti i contenuti dei sottotitoli forzati. Vengono forniti come file di testo sincronizzato separati. Per maggiori informazioni consulta: Sottotitoli per le risorse riproducibili |
Schede di doppiaggio |
Crediti dei doppiatori per le tracce doppiate. Devono essere file video con audio incorporato. Le immagini statiche non sono accettate. Per maggiori informazioni consulta: Requisiti per le schede di doppiaggio |
Acquisizione e consegna
Prime Video supporta due modalità di consegna per i pacchetti MovieLabs. La modalità viene stabilita durante l’onboarding con il tuo Account Manager.
Percorso di consegna |
Dettagli |
Aspera |
Portale preferito da Prime Video. Supporta il caricamento di file multimediali e la consegna di file in blocco XML. |
AWS S3 |
Caricamento diretto su un endpoint AWS S3 designato. I nomi dei file devono rispettare la Prime Video Standard Naming Convention. |
Regole di instradamento (per entrambe le modalità):
- EMA Avails, metadati MEC e manifest MMC vengono inviati tramite Consegna di file in blocco.
- I file multimediali riproducibili (video, audio e testo temporizzato) vengono inviati tramite Consegna standard (Aspera o S3).
- Anche i file artwork vengono inviati tramite Consegna standard. Fai riferimento a questi file nel MEC o nell’MMC.
- Tutti i nomi dei file devono rispettare la Prime Video Standard Naming Convention.
Da sapere prima di iniziare
I partner che inviano pacchetti completi e accurati possono pubblicare i contenuti più rapidamente e raggiungere un numero maggiore di clienti. Un rapido controllo prima dell’invio può farti risparmiare giorni di risoluzione dei problemi.
ID non corrispondenti:Verifica che l’ALID o l’AltID sia identico nell’EMA Avail, nel ContentID del MEC e nel mapping MMC.
XML creato manualmente:Tutti gli XML devono essere generati automaticamente. I file creati manualmente vengono rifiutati.
Sottotitoli incorporati:Il video deve essere parzialmente senza testo. I sottotitoli forzati devono essere forniti come file di testo sincronizzato separati.
Coppia POEST + EST mancante:Invia sempre entrambi nello stesso file.
Episode 0:Non è valido. Usa invece WorkType = “Promotion”.
Più di 60.000 righe EMA:Suddividi i file di grandi dimensioni in più invii.
Prezzi TVOD mancanti:PriceType, PriceValue e PriceCurrency sono tutti obbligatori.
Sottotitoli forzati mancanti:Sono obbligatori per ogni lingua audio alternativa fornita.
Schede di doppiaggio come immagini:Devono essere file video con audio incorporato. Le immagini statiche non sono accettate.