Nota: questa documentazione si applica solo all’uso della consegna di file in blocco.
Per esaminare i requisiti relativi alle risorse grafiche, consulta Requisiti per le risorse grafiche. Per inviare correttamente le risorse grafiche a Prime Video, i file di grafica (.jpg, .png) devono essere caricati su Aspera o S3 e i riferimenti devono essere inclusi in Media Entertainment Core (MEC) o Media Manifest Core (MMC).
Riferimenti agli scopi
I riferimenti allo scopo vengono utilizzati in MEC e MMC per identificare il tipo di immagini fornite. Lo scopo dell’immagine è supportato in modo diverso a seconda del tipo di titolo (ad esempio episodio, film o stagione). Per indicazioni sull’utilizzo dello scopo, consulta la tabella seguente.
Copertina |
16:9 |
Film e stagioni |
copertina |
Cofanetto |
4:3 |
Stagioni |
boxart |
Cofanetto |
3:4 |
Film |
boxart |
Poster art |
2:3 |
Film e stagioni |
locandina |
Arte eroica (sullo sfondo) |
16:9 |
Film e stagioni |
eroe |
Titolo art |
Flessibile |
Film e stagioni |
titolo |
Arte episodica |
16:9 |
Episodi |
copertina |
Trailer e illustrazioni bonus |
16:9 |
Trailer e bonus |
copertina |
Requisiti grafici globali (senza regione)
Questo è il requisito di consegna standard. La consegna globale della grafica include Language-locale, ma non include la regione. Con la grafica globale, ai clienti può essere offerta un’esperienza personalizzata basata sulla preferenza della lingua dell’interfaccia utente. Ad esempio, un cliente che vive in Canada con lo spagnolo impostato come lingua dell’interfaccia utente vedrà la grafica in spagnolo, perché è stata consegnata con lo spagnolo nella lingua locale e senza un valore regionale.
Eccezione grafica specifica per regione
Si tratta di un’eccezione di consegna destinata esclusivamente a casi d’uso specifici. La consegna di grafica specifica per regione include sia Language-locale che Region. Sebbene sia supportata la spedizione specifica per regione, richiediamo anche la spedizione di almeno una grafica globale per tipo di immagine (cofanetto, copertina e poster) per Seasons and Movies. I casi d’uso accettati sono:
- Versioni conformi, ad esempio l’omissione delle sigarette in India.
- Marchio originale specifico per regione (se consentito).
Tutti gli altri casi d’uso, inclusi, a titolo esemplificativo ma non esaustivo, testo estraneo specifico dell’area geografica, inviti all’azione o callout di marketing, non sono accettati.
Comportamento delle impostazioni locali e della regione
- Language-locale: Questo campo è obbligatorio per tutti i riferimenti alla grafica. Identifica la lingua dell’opera d’arte consegnata. Ad esempio, la grafica consegnata con pt-BR indica che è stata localizzata nella lingua portoghese brasiliana.
- Regione: questo campo è facoltativo e identifica un territorio specifico in cui verrà visualizzata la grafica specifica della regione anziché la grafica globale. Se viene fornito il campo Regione, bloccherà la grafica globale in quella regione. Se non viene fornito alcun campo Regione, la grafica è idonea per essere utilizzata in vetrina a livello globale.
Requisiti linguistici da destra a sinistra
Poiché l’arabo e l’ebraico vengono letti da destra a sinistra, i clienti con la lingua dell’interfaccia utente impostata su arabo o ebraico vedranno i metadati/testo sovrapposti sul lato destro della pagina di visualizzazione anziché a sinistra. Se stai consegnando immagini eroiche scritte da destra a sinistra (RTL) per l’ebraico o l’arabo, utilizza he-il e ar-AE come codice standard per tutte le consegne in lingua araba, poiché il codice in lingua ar-001 è obsoleto. Sebbene ar-AE sia il codice preferito per l’arabo, sono accettati anche i codici di lingua locale alternativi mostrati nella tabella seguente. Tutti gli altri codici linguistici verranno considerati da sinistra a destra (LTR).
ebraico |
He-il |
arabo |
Ar-Dz |
AR-EG |
|
Ar-ma |
|
ar-ae (preferito) |
|
AR-kW |
|
Ar-Sy |
|
Ar-LB |
|
Ar-TN |
|
Ar-ly |
|
Ar-sì |
|
Ar-qa |
|
Ar-IQ |
|
Ar-sa |
|
Ar-BH |
|
Ar-jo |
|
Ar-Tom |
|
Ar-TD |
|
Ar-DJ |
|
Ar-Kz |
|
Ar-Mr |
|
AR-PS |
|
Ar-SS |
|
Ar-R |
|
Ar-così |
|
Ar-il |
|
Ar-eh |
|
Ar-SD |
|
AR-km |
Riferimenti MMC
MMC è il metodo preferito per inviare riferimenti grafici. In MMC è più semplice fare riferimento a opere d’arte localizzate e, a differenza di MEC, non si basa sui metadati dei titoli. MMC può essere utilizzato per importare file di grafica localizzati e in lingua originale se fornite valori relativi allo scopo, alla lingua e alla regione.
La tabella seguente elenca i campi rilevanti per la grafica nel manifesto degli asset MMC.
Campo |
Definizione e note |
Valori accettati |
Utilizzo |
Inventario |
Identifica tutte le singole risorse fornite come parte del pacchetto (ad esempio file mezzanine, testo temporizzato, audio e così via) insieme ai metadati specifici della risorsa. |
Richiesto |
|
Immagine |
Manifesto: immagine |
||
@ImageID |
ID utilizzato per fare riferimento all’immagine in tutta la MMC. |
Necessario per la consegna delle immagini |
|
Scopo |
Identifica il tipo di grafica da consegnare e determina il posizionamento. |
boxart, copertina, eroe, poster, titolo |
Richiesto |
Lingua |
Identifica la lingua dell’opera d’arte consegnata. |
Richiesto |
|
Larghezza |
Larghezza, in pixel, dell’immagine consegnata. |
String (ad esempio 1920) |
Facoltativo |
Altezza |
Altezza, in pixel, dell’immagine consegnata. |
Stringa (ad esempio, 1080) |
Facoltativo |
Asset Intent |
Identifica la grafica specifica di una regione e che non deve essere esposta altrove, ad esempio nelle versioni conformi. Se non inclusa, la grafica sarà considerata idonea per essere esposta in tutte le regioni. |
Opzionale |
|
Tipo |
Identifica la grafica specifica di un’area geografica e che non dovrebbe essere esposta altrove, come le versioni conformi. Se non inclusa, la grafica sarà considerata idonea per essere esposta in tutte le regioni. |
Regione |
Opzionale |
Sottotipo |
Identifica la grafica specifica di un’area geografica e che non dovrebbe essere esposta altrove, come le versioni conformi. Se non inclusa, la grafica sarà considerata idonea per essere esposta in tutte le regioni. |
Codici dei paesi |
|
Gruppi di immagini |
Un elenco di gruppi di immagini. Selezione di immagini associate a un titolo o a una serie. |
Richiesto |
|
Gruppo di immagini |
Un singolo gruppo di immagini. Selezione di immagini associate a un titolo o a una serie. |
||
@PictureGroupID |
L’ID del gruppo di immagini che si riferisce al Content ID principale (film, episodio o serie). md:picturegroupid: [scheme]: [SSID]. |
Necessario per la consegna delle immagini |
|
Immagine |
Descrive una singola immagine, incluso il modo in cui si relaziona con altre immagini quando vengono sequenziate all’interno di una Galleria. |
Richiesto |
|
ID immagine |
Richiesto dall’XSD. Non utilizzato da Prime Video. |
Il valore viene ignorato; può essere vuoto |
Non utilizzato, ma obbligatorio |
ImageID |
ID utilizzato per fare riferimento all’immagine in tutta la MMC. |
Necessario per la consegna delle immagini |
|
Esperienze |
La sezione Esperienza di MMC raggruppa presentazioni e/o sequenze riproducibili insieme a gruppi di immagini per definire l’esperienza del cliente. |
Richiesto |
|
Esperienza |
L’elemento Experience che definisce il titolo e le gallerie applicabili. |
||
@ExperienceID |
ID utilizzato per fare riferimento all’esperienza in tutta MMC. |
Richiesto |
|
ContentID |
Non utilizzato da Prime Video. La corrispondenza si basa su UniqueID. |
Non usato |
|
PictureGroupID |
Riferimenti a PictureGroups. |
||
Mappe delle esperienze Alide |
Collega gli ALID alle esperienze associate a quel contenuto. |
Richiesto |
|
Una mappa dell’esperienza LIDE |
Le esperienze possono essere localizzate, quindi un singolo ALID può essere mappato solo su un’esperienza. |
Richiesto |
|
VALIDO |
Un Logical Asset ID (ALID) utilizzato per identificare un set di contenuti (ad esempio un asset logico) associato agli avail in un invio di Informazioni sulla disponibilità di EMA. |
Richiesto |
|
ID esperienza |
Richiesto |
||
Presentazioni |
È necessaria un’istanza di Presentation per ogni set di tracce conformi. Non richiesto solo per la consegna parziale in MMC, inclusi i riferimenti alla grafica. |
Richiesto da AudioVisual |
Per un elenco completo di tutti i campi supportati da MMC, vedere MMC Asset Manifest.
Distribuzione parziale di immagini MMC
È possibile fare riferimento ai file di grafica indipendentemente da altre risorse o come parte del pacchetto completo di risorse MMC.
- Le MMC parziali devono contenere solo oggetti di inventario per le risorse incluse nel pacchetto aggiornato. Non è necessario dichiarare Inventory per le risorse che erano state precedentemente fornite a Prime Video.
- Dichiarate le presentazioni solo quando contengono risorse presenti nell’inventario MMC e nel pacchetto.
Quando si fa riferimento solo a risorse grafiche, è necessario escludere le presentazioni dalla MMC.
- L’ALID è l’unico ID che deve corrispondere tra un pacchetto iniziale e un pacchetto aggiornato che contiene nuove risorse.
Di seguito è riportato un esempio di MMC parziale per il titolo di un film che fa riferimento solo a risorse grafiche:
<? versione xml ="1.0" encoding="UTF-8"? > |
<manifest:MediaManifest xmlns:manifest="http://www.movielabs.com/schema/manifest/v1.5/manifest” xmlns:md="http://www.movielabs.com/schema/md/v2.4/md” xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” xsi:schemaLocation="http://www.movielabs.com/schema/manifest/v1.5/manifest manifest-v1.5.xsd"> |
<manifest:Compatibility> |
<manifest:SpecVersion>1.5</manifest:SpecVersion> |
<manifest:Profile>MMC-1</manifest:Profile> |
</manifest:Compatibility> |
<manifest:Inventory> |
<! |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:cover.art.en"> |
<md:Purpose>copertura</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>it-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>cover_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:box.art.en"> |
<md:Purpose>boxart</md:Purpose> |
<md:Width>1200</md:Width> |
<md:Height>1600</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>it-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>box_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:hero.art.en"> |
<md:Purpose>eroe</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>it-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>hero_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:title.art.en"> |
<md:Purpose>titolo</md:Purpose> |
<md:Width>3450</md:Width> |
<md:Height>560</md:Height> |
<md:Encoding>png</md:Encoding> |
<md:Language>it-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>title_art.png</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:box.art.en"> |
<md:Purpose>boxart</md:Purpose> |
<md:Width>1200</md:Width> |
<md:Height>1600</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>it-US</md:Language> |
<md:AssetIntent> |
<md:Type>Regione</md:Type> |
<md:SubType>U.S</md:SubType> |
</md:AssetIntent> |
<md:AssetIntent> |
<md:Type>Regione</md:Type> |
<md:SubType>CA</md:SubType> |
</md:AssetIntent> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>box_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
</manifest:Inventory> |
<manifest:PictureGroups> |
<manifest:PictureGroup PictureGroupID="md:picturegroup:org:partneralias:title_SKU:picturegroup"> |
<manifest:Picture> |
<! |
<manifest:PictureID> |
<manifest:ImageID>MD:imageid:org:partnerAlias:title_SKU:cover.art.en</manifest:ImageID> |
<manifest:ImageID>MD:imageid:org:partnerAlias:title_SKU:box.art.en</manifest:ImageID> |
<manifest:ImageID>MD: Imageid:org:PartnerAlias:title_SKU:hero.art.en</manifest:ImageID> |
<manifest:ImageID>MD:imageid:org:partnerAlias:title_SKU:title.art.en</manifest:ImageID> |
<manifest:ImageID>MD: imageid:org: PartnerAlias: title_SKU:box.art.en.ca.us</manifest:ImageID> |
</manifest:Picture> |
</manifest:PictureGroup> |
</manifest:PictureGroups> |
<! |
<manifest:Experiences> |
<manifest:Experience ExperienceID="md:picturegroup:org:partneralias:title_SKU:picturegroup:experience” version="1.0"> |
<manifest:ContentID>md:cid:org:PartnerAlias:title_SKU</manifest:ContentID> |
<manifest:PictureGroupID>MD:PictureGroup:org: PartnerAlias:title_SKU:PictureGroup</manifest:PictureGroupID> |
</manifest:Experience> |
</manifest:Experiences> |
<manifest:ALIDExperienceMaps> |
<manifest:ALIDExperienceMap> |
<manifest:ALID>md:alid:org:partnerAlias:title_SKU</manifest:ALID> |
<manifest:ExperienceID>MD:PictureGroup:org: PartnerAlias:title_SKU:PictureGroup: Experience</manifest:ExperienceID> |
</manifest:ALIDExperienceMap> |
</manifest:ALIDExperienceMaps> |
</manifest:MediaManifest> |
Referenze MEC
Sebbene MEC venga utilizzato principalmente per fornire i metadati dei titoli (sinossi, attori, valutazioni e così via), può essere utilizzato anche per comunicare riferimenti alle opere d’arte.
Quando si utilizza MEC per la consegna di opere d’arte, deve essere presente un campo ArtReference all’interno della sezione LocalizedInfo. Ciò consente di fare riferimento a più opere d’arte per un singolo titolo e di comunicare elementi di metadati sull’opera d’arte, come risoluzione, scopo e lingua.
Lingua, nome del file e scopo devono essere inclusi in ogni sezione LocalizedInfo. La lingua locale della grafica deve essere allineata ai metadati localizzati del titolo forniti in una determinata sezione LocalizedInfo.
Quando invii un MEC completo che contiene i metadati del titolo e i riferimenti alla grafica, i riferimenti alla grafica verranno etichettati con la lingua inserita per il blocco LocalizedInfo corrispondente. Assicurati che l’opera d’arte consegnata corrisponda alla lingua inviata. Se devi inviare un’opera d’arte in una lingua che non corrisponde alla lingua principale dei metadati fornita, devi inserire un secondo blocco LocalizedInfo e includere i campi di metadati obbligatori (TitleDisplayUnlimited e Summary400) con i riferimenti artReference corrispondenti alla grafica ArtReference. Per un esempio di questo caso d’uso, consultate i file di esempio.xml nella sezione Esempi MMC e MEC più avanti in questo argomento.
La tabella seguente elenca i campi rilevanti per la grafica nei metadati dei titoli MEC.
Informazioni localizzate |
Include elementi che possono essere localizzati. |
Richiesto |
|
@Language |
Identifica la lingua dell’opera d’arte consegnata. |
Richiesto |
|
@Region |
Identifica la grafica specifica di una regione e che non deve essere esposta altrove, come le versioni conformi. Se non inclusa, la grafica sarà considerata idonea per essere esposta in tutte le regioni. |
Codici dei paesi |
Facoltativo |
Art Reference |
Per fare riferimento a un’opera d’arte è necessario almeno un ArtReference per titolo. |
Richiesto |
|
@Resolution |
Risoluzione dell’opera d’arte da consegnare. |
Stringa nel formato colxRow |
Facoltativo |
@Purpose |
Identifica il tipo di grafica da consegnare e determina il posizionamento. |
bozzetto, copertina, eroe, poster, titolo |
Richiesto |
Consegna parziale dell’immagine MEC
MEC può essere sfruttato per fornire opere d’arte indipendentemente dai metadati del titolo, con un MD:Profile aggiunto che semplifica le convalide di analisi.
Di seguito è riportato un esempio di MEC parziale per il titolo di un film che fa riferimento solo alle risorse grafiche.
<? versione xml ="1.0" encoding="UTF-8"? > |
<mdmec:coreMetadata xmlns:mdmec=» http://www.movielabs.com/schema/mdmec/v2.9 “xmlns:md=» http://www.movielabs.com/schema/md/v2.9/md “xmlns:xsi=» http://www.w3.org/2001/XMLSchema-instance “XSI:schemaLocation=» http://www.movielabs.com/schema/mdmec/v2.9.. |
<mdmec:Compatibility> |
<md:SpecVersion>2.9</md:SpecVersion> |
<! -- Il profilo CM-IMAGE-1 indica che questo file è conforme al profilo di sola immagine. Amazon non analizzerà i metadati del titolo dal file quando viene fornito questo profilo --> |
<md:Profile>CM-IMMAGINE-1</md:Profile> |
</mdmec:Compatibility> |
<mdmec:Basic ContentID="md:cid:org:partneralias:titlesku"> |
<! |
<md:LocalizedInfo language="en-US"> |
<md:ArtReference purpose="boxart">box_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="hero">hero_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_US.jpg</md:ArtReference> |
<md:Region> |
<md:country>U.S</md:country> |
</md:Region> |
</md:LocalizedInfo> |
<! |
<md:LocalizedInfo language="en-US"> |
<md:ArtReference purpose="boxart">box_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="hero">hero_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="title">title_art_en_global.png</md:ArtReference> |
</md:LocalizedInfo> |
<! |
<md:LocalizedInfo language="pt-BR"> |
<md:ArtReference purpose="boxart">box_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="title">title_art_pt_br_global.png</md:ArtReference> |
</md:LocalizedInfo> |
<! -- Le specifiche MEC richiedono ReleaseYear e WorkType. Quando effettua consegne con CM-IMAGE-1, Amazon ignorerà questi valori. --> |
<md:ReleaseYear>2018</md:ReleaseYear> |
<md:WorkType>film</md:WorkType> |
<md:AltIdentifier> |
<md:Namespace>ORG</md:Namespace> |
<md:Identifier>titlesku</md:Identifier> |
</md:AltIdentifier> |
<md:AssociatedOrg organizationID="partneralias” role="licensor” /> |
</mdmec:Basic> |
Consegne di opere d’arte classiche tramite MMC
Prime Video ora può supportare la consegna e/o la sostituzione di grafica per i titoli che in precedenza venivano distribuiti ai Marketplace classici (Stati Uniti, Germania, Giappone e GB) sfruttando le attuali specifiche MMC, come spiegato nei riferimenti MMC sopra riportati. Tieni presente che i riferimenti alla grafica MEC non sono supportati per questo caso d’uso specifico (Titoli classici).
Tipi di grafica supportati (tutti)
Scopo nella MMC |
Tipo |
Film |
Livello di Serie |
Livello di Stagione |
Livello dell’episodio |
Trailer e bonus |
boxart |
Cofanetto |
X |
X |
|||
copertura |
Copertina |
X |
X |
|||
locandina |
Poster art |
X |
X |
|||
eroe |
Arte eroica |
X |
X |
|||
titolo |
Titolo art |
X |
X |
|||
copertura |
Arte episodica |
X |
||||
copertura |
Trailer e illustrazioni bonus |
X |
Specifiche di consegna
Assicurati di utilizzare lo stesso alias partner e lo stesso SKU utilizzati quando il titolo Classic è stato inizialmente creato. Le specifiche sono identiche a quelle di MMC Global; sono supportati tutti i tipi di grafica, le lingue locali e le aree geografiche.
Domande frequenti sulla consegna di opere d’arte classiche
Errori dello schema MEC
Messaggio di errore |
Causa |
Sono disponibili più istanze di LocalizedInfo per la stessa lingua. |
Esistono blocchi LocalizedInfo duplicati (per tipo e regione). |
Se si forniscono valori Region, un elemento LocalizedInfo per quella lingua deve essere valido per tutti i territori (nessuna eccezione per Region). |
Non esiste un blocco senza regioni. |
