Nota: Questa documentazione si applica esclusivamente all’utilizzo della consegna tramite file in blocco.
Per esaminare i requisiti delle risorse grafiche, consulta i Requisiti per i contenuti grafici. Per distribuire 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 di scopo
I riferimenti di scopo vengono utilizzati in MEC e MMC per identificare il tipo di immagini inviate. Lo scopo dell’immagine è supportato in modo diverso in base al tipo di livello del titolo (ad esempio episodio, film o stagione). Consulta la seguente tabella per le indicazioni sull’uso dello scopo.
Grafica di copertina |
16:9 |
Film e stagioni |
copertina |
Grafica della confezione |
4:3 |
Stagioni |
grafica di copertina |
Grafica della confezione |
3:4 |
Film |
boxart |
Grafica della locandina |
2:3 |
Film e stagioni |
poster |
Grafica hero (sfondo) |
16:9 |
Film e stagioni |
hero |
Carosello hero |
8:3 |
Film e stagioni |
carouselhero |
Grafica del titolo |
Flessibile |
Film e stagioni |
titolo |
Grafica per episodi |
16:9 |
Episodi |
copertina |
Grafica trailer e bonus |
16:9 |
Trailer e bonus |
copertina |
Requisito grafico globale (senza regione)
Questo è il requisito standard di consegna. La consegna globale delle grafiche include la lingua-LOCALE, ma non la regione. Con una grafica globale, ai clienti può essere offerta un’esperienza personalizzata basata sulle preferenze linguistiche dell’interfaccia utente. Ad esempio, un cliente che vive in Canada con lo spagnolo impostato come lingua dell’interfaccia utente vedrebbe la grafica in spagnolo, perché è stata consegnata in spagnolo nella lingua-LOCALE e senza un valore per la regione.
Eccezione grafica specifica per regione
Questa è un’eccezione di consegna destinata solo a casi d’uso specifici. La consegna delle grafiche specifiche per regione include sia la lingua-LOCALE che la regione. Sebbene sia supportato l’invio specifico per regione, richiediamo anche la l’invio di almeno una grafica Global per tipo di immagine (grafica della confezione, della copertina e della locandina) per Stagioni e Film. I casi d’uso accettati sono:
- Versioni conformi, come l’omissione delle sigarette in India.
- Branding degli originali specifica per regione (se consentito).
Tutti gli altri casi d’uso, inclusi, a titolo esemplificativo ma non esaustivo, testo aggiuntivo specifico per regione, inviti all’azione o messaggi di marketing, non sono accettati.
Comportamento in base alla lingua-LOCALE e alla regione
- Lingua-LOCALE: Questo campo è obbligatorio per tutti i riferimenti grafici. Identifica la lingua della grafica inviata. Ad esempio, se una grafica viene inviata con pt-BR significa 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 sulla 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é su quello sinistro. Se stai consegnando una grafica hero da destra a sinistra (RTL) in ebraico o arabo, utilizza he-IL e ar-AE come codice standard per tutte le consegne in lingua araba, perché il codice della lingua ar-001 è obsoleto. Sebbene ar-AE sia il codice preferito per l’arabo, sono accettati anche i codici locali della lingua alternativa 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-YE |
|
ar-QA |
|
ar-IQ |
|
ar-SA |
|
ar-BH |
|
ar-JO |
|
ar-OM |
|
ar-TD |
|
ar-DJ |
|
ar-KZ |
|
ar-MR |
|
ar-PS |
|
ar-SS |
|
ar-ER |
|
ar-SO |
|
ar-IL |
|
ar-EH |
|
ar-SD |
|
ar-KM |
Per ulteriori informazioni sui requisiti della grafica RTL e LTR, consulta la sezione Linee guida in Specifiche della grafica.
Riferimenti MMC
MMC è il metodo preferito per inviare riferimenti grafici. È più semplice fare riferimento a contenuti grafici localizzati e, a differenza di MEC, non fa affidamento sui metadati del titolo. MMC può essere utilizzato per importare file di grafica in lingua originale e localizzati se si forniscono valori relativi a scopo, lingua e area geografica.
La tabella seguente elenca i campi relativi alla grafica nel manifesto delle risorse di MMC.
Campo |
Definizione e note |
Valori accettati |
Utilizzo |
Inventario |
Identifica tutte le singole risorse inviate come parte del pacchetto (ad esempio, file master compressi, testi sincronizzati, audio e così via), insieme a metadati specifici delle risorse. |
Obbligatorio |
|
Immagine |
manifest:Image |
||
@ImageID |
ID usato come riferimento all’immagine nel MMC. |
Obbligatorio per l’invio di immagini |
|
Scopo |
Identifica il tipo di grafica inviata e determina il posizionamento. |
grafica confezione, copertina, hero, titolo |
Obbligatorio |
Lingua |
Identifica la lingua della grafica inviata. |
Obbligatorio |
|
Larghezza |
Larghezza, in pixel, dell’immagine che viene inviata. |
Stringa (ad esempio, 1920) |
Opzionale |
Altezza |
Altezza, in pixel, dell’immagine che viene inviata. |
Stringa (ad esempio, 1080) |
Opzionale |
AssetIntent |
Identifica la grafica specifica di una regione e che non deve essere visualizzata altrove, ad esempio le versioni conformi. Le grafiche non incluse sono considerate idonee per essere visualizzate in tutte le regioni. |
Opzionale |
|
Tipo |
Identifica la grafica specifica di una regione e che non deve essere visualizzata altrove, come le versioni conformi. Le grafiche non incluse sono considerate idonee per essere visualizzate in tutte le regioni. |
Regione |
Opzionale |
Sottotipo |
Identifica la grafica specifica di una regione e che non deve essere visualizzata altrove, come le versioni conformi. Le grafiche non incluse sono considerate idonee per essere visualizzate in tutte le regioni. |
Codici Paesi |
|
PictureGroups |
Un elenco di gruppi di immagini. Selezione di immagini associate a un titolo o a una serie. |
Obbligatorio |
|
PictureGroup |
Un unico gruppo di immagini. Selezione di immagini associate a un titolo o a una serie. |
||
@PictureGroupID |
L’ID del gruppo di immagini che si riferisce all’ID del contenuto principale (film, episodio o serie). md:picturegroupid: [schema]: [SSID]. |
Obbligatorio per l’invio di immagini |
|
Immagine |
Descrive una singola immagine, incluso il modo in cui si relaziona con le altre immagini quando viene messa in sequenza all’interno di una Galleria. |
Obbligatorio |
|
PictureID |
Richiesto dall’XSD. Non usato da Prime Video. |
Il valore viene ignorato; può essere vuoto |
Non usato, ma obbligatorio |
ImageID |
ID usato come riferimento all’immagine nel MMC. |
Obbligatorio per l’invio di immagini |
|
Esperienze |
La sezione Esperienza di MMC raggruppa le presentazioni e/o le sequenze riproducibili con i gruppi di immagini per definire l’esperienza cliente. |
Obbligatorio |
|
Esperienza |
L’elemento Esperienza che definisce il titolo e le gallerie applicabili. |
||
@ExperienceID |
ID usato come riferimento dell’esperienza nel MMC. |
Obbligatorio |
|
ContentID |
Non usato da Prime Video. I file sono associati tra loro usando UniqueID. |
Non usato |
|
PictureGroupID |
Riferimenti a PictureGroups. |
||
ALIDExperienceMaps |
Collega gli ALID alle esperienze associate a quel contenuto. |
Obbligatorio |
|
ALIDExperienceMap |
Le esperienze possono essere localizzate, quindi un unico ALID può essere associato a una sola esperienza. |
Obbligatorio |
|
ALID |
Un ID risorsa logico (ALID) è utilizzato per identificare un set di contenuti (come risorsa logica) associato ad avail in un invio EMA Avails. |
Obbligatorio |
|
ExperienceID |
Obbligatorio |
||
Presentazioni |
Un’istanza presentazione è richiesta per ogni serie di tracce conformi. Non obbligatorio per gli invii parziali tramite MMC che includono solo i riferimenti ai contenuti grafici. |
Richiesto da AudioVisual |
Per un elenco completo di tutti i campi supportati da MMC, consulta il manifesto delle risorse MMC.
Invio parziale delle immagini MMC
È possibile fare riferimento ai file di grafica indipendentemente da altri file o nell’ambito di un pacchetto completo di risorse MMC.
- Gli MMC parziali devono contenere solo oggetti di inventario per i file inclusi nel pacchetto aggiornato. Non è necessario dichiarare l’inventario per le risorse precedentemente inviate a Prime Video.
- Dichiara 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 da 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 alle risorse grafiche:
<?xml version="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> |
<!-- Grafica di copertina di un film in inglese senza regione da visualizzare a livello globale --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:cover.art.en"> |
<md:Purpose>cover</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>cover_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- Grafica confezione di un film in inglese senza regione da visualizzare a livello globale --> |
<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>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>box_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- Grafica hero di un film in inglese senza regione da visualizzare a livello globale --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:hero.art.en"> |
<md:Purpose>hero</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>hero_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- Grafica del titolo di un film in inglese senza regione da visualizzare a livello globale --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:title.art.en"> |
<md:Purpose>title</md:Purpose> |
<md:Width>3450</md:Width> |
<md:Height>560</md:Height> |
<md:Encoding>png</md:Encoding> |
<md:Language>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>title_art.png</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- Grafica confezione di un film in inglese con regione, da visualizzare solo in US e CA --> |
<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>en-US</md:Language> |
<md:AssetIntent> |
<md:Type>Region</md:Type> |
<md:SubType>US</md:SubType> |
</md:AssetIntent> |
<md:AssetIntent> |
<md:Type>Region</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> |
<!-- PictureID è richiesto dall’XSD, ma non è necessario per Amazon --> |
<manifest:PictureID></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> |
<!-- Root Experience --> |
<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> |
Riferimenti MEC
Sebbene MEC venga utilizzato principalmente per fornire i metadati dei titoli (sinossi, attori, classificazioni, ecc.), può essere utilizzato anche per comunicare riferimenti grafici.
Quando si utilizza MEC per l’invio delle grafiche, deve essere presente una sezione ArtReference all’interno della sezione LocalizedInfo. Ciò consente di fare riferimento a più elementi grafici per un singolo titolo e di comunicare elementi di metadati sulla grafica, come risoluzione, scopo e lingua.
Lingua, nome del file e scopo devono essere inclusi in ogni sezioneLocalizedInfo. La lingua e le impostazioni locali per la grafica devono essere allineate ai metadati del titolo localizzato in una data sezione LocalizedInfo.
Quando invii un MEC completo che contiene i metadati del titolo e i riferimenti grafici, questi ultimi verranno etichettati con la lingua inserita per il blocco LocalizedInfo corrispondente. Assicurati che la grafica inviata corrisponda alla lingua inviata. Se è necessario inviare la grafica in una lingua che non corrisponde alla lingua principale dei metadati fornita, è necessario inserire un secondo blocco LocalizedInfo, che deve includere i campi di metadati obbligatori (TitleDisplayUnlimited e Summary400) con i riferimenti grafici ArtReference corrispondenti. Per un esempio di questo caso d’uso, consulta i file di esempio .xml nella sezione Esempi MMC e MEC più avanti in questo argomento.
Nella tabella seguente sono elencati i campi relativi alla grafica nei metadati del titolo MEC.
LocalizedInfo |
Include elementi che possono essere localizzati. |
Obbligatorio |
|
@Language |
Identifica la lingua della grafica inviata. |
Obbligatorio |
|
@Region |
Identifica la grafica specifica di una regione e che non deve essere visualizzata altrove, ad esempio le versioni conformi. Le grafiche non incluse sono considerate idonee per essere visualizzate in tutte le regioni. |
Codici Paesi |
Opzionale |
ArtReference |
Quando si fa riferimento a una grafica, è richiesta almeno una ArtReference per titolo. |
Obbligatorio |
|
@Resolution |
Risoluzione della grafica inviata. |
Stringa nel formato colXrow |
Opzionale |
@Purpose |
Identifica il tipo di grafica inviata e determina il posizionamento. |
grafica confezione, copertina, hero, titolo |
Obbligatorio |
Invio parziale delle immagini MEC
Il MEC può essere utilizzato per inviare grafica indipendente di metadati del titolo con un md:Profile aggiunto che facilita le convalide dell’analisi.
Di seguito è riportato un esempio di MEC parziale per il titolo di un film che fa riferimento solo alle risorse grafiche.
<?xml version="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-v2.9.xsd"> |
<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à alcun metadato del titolo dal file quando viene fornito questo profilo --> |
<md:Profile>CM-IMAGE-1</md:Profile> |
</mdmec:Compatibility> |
<mdmec:Basic ContentID="md:cid:org:partneralias:titlesku"> |
<!-- Grafica in inglese con regione, da visualizzare solo negli Stati Uniti --> |
<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>US</md:country> |
</md:Region> |
</md:LocalizedInfo> |
<!-- Grafica in inglese senza regione da usare a livello globale--> |
<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> |
<!-- Grafica in portoghese brasiliano senza regione da usare a livello globale--> |
<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 si consegna con CM-IMAGE-1, Amazon ignorerà questi valori. --> |
<md:ReleaseYear>2018</md:ReleaseYear> |
<md:WorkType>movie</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 grafiche classiche tramite MMC
Prime Video può ora supportare la consegna e/o la sostituzione delle grafiche per i titoli precedentemente distribuiti nei Marketplace classici (USA, DE, JP e GB) sfruttando le attuali specifiche MMC, come spiegato nei riferimenti MMC sopra riportati. Tieni presente che i riferimenti alle grafiche MEC non sono supportati per questo caso d’uso specifico (titoli classici).
Tipi di grafica supportati (tutti)
Scopo nel MMC |
Tipo |
Film |
A livello di serie |
A livello di stagione |
A livello di episodio |
Trailer e bonus |
boxart |
Grafica della confezione |
X |
X |
|||
copertina |
Grafica di copertina |
X |
X |
|||
poster |
Grafica della locandina |
X |
X |
|||
hero |
Grafica hero |
X |
X |
|||
titolo |
Grafica del titolo |
X |
X |
|||
copertina |
Grafica per episodi |
X |
||||
copertina |
Trailer e grafica bonus |
X |
Specifiche di consegna
Assicurati di utilizzare lo stesso alias partner e lo stesso SKU utilizzati quando il titolo classico è stato inizialmente creato. Le specifiche sono identiche alle specifiche MMC globali; sono supportati tutti i tipi di grafica, le lingue locali e le aree geografiche.
Domande frequenti sulla consegna delle grafiche classiche
Errori dello schema MEC
Messaggio di errore |
Causa |
È stata specificata più di un’istanza di LocalizedInfo per la stessa lingua. |
Sono presenti blocchi LocalizedInfo duplicati (per tipo e area geografica). |
Se si forniscono i valori Regione, un elemento LocalizedInfo per quella lingua deve essere applicato a tutti i territori (nessuna eccezione per Regione). |
Non è presente un blocco senza regione. |
