Les métadonnées MEC (Media Entertainment Core) sont utilisées si vous choisissez de publier via la spécification MovieLabs. Si vous utilisez le téléchargement d’un titre unique ou des mRSS, les métadonnées MEC ne s’appliquent pas à vous.
Les fichiers MEC doivent respecter la spécification du MEC de MovieLabs v2.6 avec des exigences spécifiques à Amazon. En cas de conflit, les exigences de Prime Video sont prioritaires. Consultez nos fichiers MEC d’exemples dans notre référentiel de fichiers d’exemples.
Normes de livraison de MEC XML
Suivez ces règles pour chaque soumission de MEC XML.
- Votre fichier XML doit être généré automatiquement. La création manuelle de fichiers XML entraînera des erreurs de livraison.
- Les soumissions de fichiers MEC doivent respecter les règles de dénomination des fichiers Prime Video.
- La définition du schéma XML (XSD) et la documentation se trouvent dans le package de fichiers d’exemples.
- Les valeurs ContentID et WorkType sont fixées lors de la première soumission. Une nouvelle soumission avec des valeurs différentes entraîne une erreur de livraison.
Format du champ ContentID
Votre ContentID doit suivre ce format URN dans l’attribut @ContentID. Le unique_ID, ou ID de contenu (SKU), est l’AltID/ALID indiqué dans la spécification de MovieLabs.
Format : md:cid:org:[partner_alias]:[unique_id]
Exemples :
- Film : md:cid:org:wb:suicidesquadfeature
- Série : md:cid:org:amzn_studios_example:HighCastleSeries
- Saison : md:cid:org:amzn_studios_example:HighCastle1
- Épisode : md:cid:org:amzn_studios_example:HighCastle1_1
Le champ AltIdentifier/Identifier utilise uniquement la partie de la chaîne d’identification. Par exemple, utilisez HighCastle1_1, et non l’URN complet.
Règles de mise à jour et de soumission partielle
- Pour mettre à jour les métadonnées fournies précédemment, utilisez exactement le même ContentID que pour les initiales.
- Votre soumission la plus récente (par paramètre régional et horodatage de livraison) est votre version officielle.
- Les mises à jour partielles SONT prises en charge pour les attributs des sections LocalizedInfo.
- Les mises à jour partielles ne sont PAS prises en charge pour RatingSet et People. Incluez toujours toutes les classifications des âges et tous les acteurs et membres de l’équipe.
- Si vous fournissez deux fois des métadonnées pour le même paramètre régional, le dernier fichier remplace le précédent.
Structure du contenu télévisuel
Le fichier MEC XML possède des règles structurelles spécifiques pour le contenu télévisuel.
- Chaque épisode doit être diffusé dans son propre fichier MEC XML.
- Plusieurs variantes linguistiques du même épisode peuvent être combinées dans un fichier MEC individuel.
- Utilisez le champ ParentContentID pour indiquer la saison d’un épisode.
- Prime Video préfère la diffusion simultanée des fichiers XML des séries, des saisons et des épisodes.
- Si la livraison simultanée n’est pas possible, distribuez de manière séquentielle : La série d’abord, puis la saison, puis l’épisode.
Exigences relatives à la référence artistique
Tous les types de contenu doivent inclure des références artistiques dans le fichier MEC.
Type d’illustration |
Valeur @purpose |
@resolution |
Modèle de nom de fichier |
Illustration de couverture (4:3) |
Illustration de couverture |
3840 x 2160 |
[title]-[locale]-4x3.jpg |
Illustration de couverture (16:9) |
Illustration de couverture |
3840 x 2160 |
[title]-[locale]-16x9.jpg |
Illustration de boîtier (3:4) |
Illustration de boîtier |
1920 x 2560 |
[title]-[locale]-3x4.jpg |
Illustration de l’affiche (2:3) |
Illustration de l’affiche |
2000 x 3000. |
[title]-[locale]-2x3.jpg |
Les attributs @resolution et @purpose sont obligatoires pour chaque entrée ArtReference. Les quatre types d’illustrations apparaissent dans chaque modèle de type de contenu.
![[ICON] Important](https://cdn.bsp.partner-portal.pv.amazon.dev/d6/b7/1bc515f940a9b8e27ca63c3a70d7/callout-important.svg)
Important
Format de genre
Les genres doivent utiliser des codes d’identification de genre spécifiques à Amazon dans l’attribut @id. Jusqu’à trois genres sont autorisés par section LocalizedInfo. Deux genres sont présentés sur la page d’accueil du Store ; le troisième alimente les algorithmes de disponibilité.
Format : <md:Genre @id="[genre_code]">
Exemples de codes de genre :
- av_genre_action
- av_genre_drama
- av_genre_science_fiction
L’entrée du premier genre doit inclure l’attribut @source pointant vers la liste des genres Amazon.
Champs obligatoires par type de contenu
Les tableaux suivants présentent l’état des champs pour chaque type de contenu sur la base de MEC v2.6. En raison du nombre de types de contenu, les tableaux sont regroupés ci-dessous.
Groupe de tableaux A : film, épisode et saison
Champ |
Description |
Film |
Épisode |
Saison |
@ContentID |
ID de métadonnées unique. Doit suivre les meilleures pratiques de MovieLabs. |
Obligatoire |
Obligatoire |
Obligatoire |
LocalizedInfo |
Bloc d’éléments localisables. Au moins un élément est obligatoire. |
Obligatoire |
Obligatoire |
Obligatoire |
@Language |
Code de langue de la liste d’autorisation de Prime Video. |
Obligatoire |
Obligatoire |
Obligatoire |
TitleDisplayUnlimited |
Affiche le titre. 250 caractères maximum. Utilisé par Amazon. |
Obligatoire |
Obligatoire |
Obligatoire |
TitleDisplay60 |
Affiche le titre abrégé. 60 caractères maximum. |
Amélioré |
Amélioré |
Obligatoire |
ArtReference |
Fichiers d’illustrations avec attributs de résolution et d’objectif. |
Amélioré |
Amélioré |
Amélioré |
Summary190 |
Synopsis court. 190 caractères maximum. |
Obligatoire |
Obligatoire |
Obligatoire |
Summary400 |
Synopsis moyen. 400 caractères maximum. |
Obligatoire |
Obligatoire |
Obligatoire |
Summary4000 |
Synopsis étendu. 4 000 caractères maximum. |
Amélioré |
Amélioré |
Amélioré |
Genre |
Au moins un genre Prime Video. Jusqu’à 3 par champ LocalizedInfo. |
Obligatoire |
Obligatoire |
Obligatoire |
ReleaseYear |
Année de première diffusion sur n’importe quel territoire. |
Obligatoire |
Obligatoire |
Obligatoire |
ReleaseDate |
Date de diffusion précise. Format : AAAA-MM-JJ |
Obligatoire |
Obligatoire |
Amélioré |
ReleaseHistory |
Données de diffusion historiques avec le territoire et l’entreprise. |
Amélioré |
Rejeté |
Amélioré |
WorkType |
Classification du contenu : film, épisode, saison, etc. |
Obligatoire |
Obligatoire |
Obligatoire |
WorkTypeDetail |
Classification supplémentaire. Utilisé pour la classification en séries. |
Rejeté |
Rejeté |
Rejeté |
AltIdentifier (espace-nom + identifiant) |
ID externe : EIDR, ISAN, IMDB ou ORG. |
Obligatoire |
Obligatoire |
Obligatoire |
RatingSet |
Classification officielle des âges pour le contenu. Fournissez toutes les classifications des âges disponibles. |
Obligatoire |
Obligatoire |
Obligatoire |
People |
Les noms des acteurs et l’équipe. |
Obligatoire |
Obligatoire |
Obligatoire |
OriginalLanguage |
Langue de la production originale. |
Obligatoire |
Rejeté |
Obligatoire |
AssociatedOrg (@role=licensor) |
Organisme chargé de l’octroi des licences, avec son identifiant et son rôle. |
Obligatoire |
Rejeté |
Obligatoire |
SequenceInfo/Number |
Numéro de l’épisode ou de la saison dans la série. |
Rejeté |
Obligatoire |
Obligatoire |
Parent/ParentContentID |
Lie un épisode à une saison ou une saison à une série. |
Rejeté |
Obligatoire |
Obligatoire |
CompanyDisplayCredit |
Nom du studio ou de l’entreprise montré aux clients. 250 caractères maximum. |
Obligatoire |
Obligatoire |
Obligatoire |
Groupe de tableaux B : série, bande-annonce, bonus et collection
Consultez le groupe de tableaux A pour les descriptions des champs. Les mêmes définitions de champs s’appliquent ici.
Champ |
Série |
Bande-annonce |
Bonus |
Collection |
@ContentID |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
LocalizedInfo |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
@Language |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
TitleDisplayUnlimited |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
TitleDisplay60 |
Amélioré |
Amélioré |
Amélioré |
Obligatoire |
ArtReference |
Amélioré |
Amélioré |
Amélioré |
Amélioré |
Summary190 |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
Summary400 |
Rejeté |
Rejeté |
Obligatoire |
Obligatoire |
Summary4000 |
Amélioré |
Rejeté |
Rejeté |
Amélioré |
Genre |
Obligatoire |
Rejeté |
Rejeté |
Obligatoire |
ReleaseYear |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
ReleaseDate |
Amélioré |
Rejeté |
Rejeté |
Amélioré |
ReleaseHistory |
Rejeté |
Rejeté |
Rejeté |
Rejeté |
WorkType |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
WorkTypeDetail |
Amélioré |
Rejeté |
Rejeté |
Obligatoire |
AltIdentifier |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
RatingSet |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
People |
Rejeté |
Rejeté |
Rejeté |
Rejeté |
OriginalLanguage |
Rejeté |
Rejeté |
Rejeté |
Rejeté |
AssociatedOrg (@role=licensor) |
Rejeté |
Rejeté |
Rejeté |
Rejeté |
SequenceInfo/Number |
Rejeté |
Obligatoire |
Obligatoire |
Rejeté |
Parent/ParentContentID |
Rejeté |
Rejeté |
Obligatoire |
Rejeté |
CompanyDisplayCredit |
Obligatoire |
Obligatoire |
Obligatoire |
Obligatoire |
![[ICON] Quick Tip](https://cdn.bsp.partner-portal.pv.amazon.dev/15/83/24f05f5140078772701d7026c11f/callout-quick-tip.svg)
Conseil rapide
Détails des champs améliorés
Les tableaux ci-dessous présentent les détails des sous-champs pour les éléments parents améliorés. Utilisez-les pour fournir des métadonnées plus riches et améliorer la disponibilité.
Sous-champs relatifs aux personnes
Sous-champ |
Description |
Film |
Épisode |
Saison |
Job |
Titre du poste de la personne (par exemple, acteur, réalisateur). |
Obligatoire |
Amélioré |
Obligatoire |
JobFunction |
Rôle fonctionnel : réalisateur, producteur, acteur, scénariste ou créateur de contenu. |
Obligatoire |
Amélioré |
Obligatoire |
BillingBlockOrder |
Contrôle l’ordre d’affichage des membres de l’équipe sur la page détaillée. |
Amélioré |
Amélioré |
Amélioré |
Character |
Nom du personnage joué par le membre de l’équipe. |
Amélioré |
Amélioré |
Amélioré |
Guest |
Signale les apparitions des invités pour améliorer la disponibilité. |
Amélioré |
Amélioré |
Amélioré |
Name/DisplayName |
Nom d’affichage complet de la personne. |
Obligatoire |
Obligatoire |
Obligatoire |
Name/SortName |
Nom triable pour la classification par ordre alphabétique. |
Amélioré |
Amélioré |
Amélioré |
Gender |
Sexe de la personne. Prend en charge les recommandations personnalisées. |
Amélioré |
Amélioré |
Amélioré |
Sous-champs de RatingSet
Les sous-champs de RatingSet ci-dessous s’appliquent à tous les types de contenu.
Sous-champ |
Description |
Film |
Épisode |
Saison |
Rating |
Le bloc de classification des âges pour le contenu. |
Obligatoire |
Obligatoire |
Obligatoire |
Region |
Région géographique à laquelle s’applique la classification des âges. |
Obligatoire |
Obligatoire |
Obligatoire |
Country |
Code de pays ISO auquel s’applique la classification des âges. |
Obligatoire |
Obligatoire |
Obligatoire |
System |
Système de classification des âges utilisé (par exemple, MPAA, BBFC). |
Obligatoire |
Obligatoire |
Obligatoire |
Value |
La valeur de classification (par exemple, PG-13, 12A). |
Obligatoire |
Obligatoire |
Obligatoire |
Reason |
Description de la classification des âges affichée sur la page détaillée du titre. |
Amélioré |
Amélioré |
Amélioré |
NotRated |
À utiliser lorsqu’aucune classification officielle des âges n’existe sur aucun territoire. |
Obligatoire |
Obligatoire |
Obligatoire |
IsAdult |
Signale le contenu réservé aux adultes à des fins de classification et de filtrage. |
Amélioré |
Amélioré |
Amélioré |
Sous-champs de ReleaseHistory (film et saison)
Sous-champ |
Description |
Film |
Saison |
DistrTerritory |
Code pays du territoire de diffusion. |
Amélioré |
Amélioré |
ReleaseOrg |
Entreprise impliquée dans cette diffusion. |
Amélioré |
Amélioré |
@organizationID |
Identifiant unique de l’entreprise de diffusion. |
Amélioré |
Amélioré |
@idType |
Type d’identifiant d’entreprise utilisé. |
Amélioré |
Amélioré |
@role |
Rôle de l’entreprise dans la diffusion. |
Amélioré |
Amélioré |
DisplayName |
Affiche le nom de l’entreprise de diffusion. |
Amélioré |
Amélioré |
SortName |
nom triable de l’entreprise de diffusion. |
Amélioré |
Amélioré |
Sous-champs d’AssociatedOrg (film et saison)
Sous-champ |
Description |
Film |
Saison |
@organizationID |
Identifiant unique de l’organisme qui délivre les licences. |
Obligatoire |
Obligatoire |
@role |
Doit être « licensor » (concédant). |
Obligatoire |
Obligatoire |
DisplayName |
Affiche le nom du concédant. |
Amélioré |
Amélioré |
SortName |
Nom triable pour la classification par ordre alphabétique. |
Amélioré |
Amélioré |
AlternateName |
Autre nom pour le concédant. |
Amélioré |
Amélioré |
Sous-champs améliorés de LocalizedInfo
Sous-champ |
Description |
Film |
Épisode |
Saison |
Region |
Région géographique pour les métadonnées localisées. |
Amélioré |
Amélioré |
Amélioré |
Country |
Code pays pour les métadonnées localisées. |
Amélioré |
Amélioré |
Amélioré |
OriginalTitle |
Titre dans sa langue d’origine. Améliore la recherche de contenu international. |
Amélioré |
Amélioré |
Amélioré |
PeopleLocal |
Noms des acteurs et des équipes localisés pour les recherches sur le marché local. |
Amélioré |
Amélioré |
Amélioré |
Champs améliorés supplémentaires
Champ |
Description |
Film |
Épisode |
Saison |
CountryOfOrigin |
Pays où le titre a été produit. |
Amélioré |
Amélioré |
Amélioré |
PrimarySpokenLanguage |
Principale langue parlée dans le contenu. |
Amélioré |
Amélioré |
Amélioré |
VersionLanguage |
Version linguistique de cette entrée de métadonnées spécifique. |
Amélioré |
Amélioré |
Amélioré |
RunLength |
Durée du titre. Affichée sur la page détaillée. |
Amélioré |
Amélioré |
Rejeté |
Location |
Données de localisation géographique pour la précision des métadonnées. |
Amélioré |
Amélioré |
Amélioré |
Valeurs relatives aux relations avec l’élément parent
Content Type |
@relationshipType |
ParentContentID Points To |
Episode |
est un épisode de |
ID du contenu de la saison |
Season |
est la saison de |
ID de contenu de la série |
Trailer |
est une promotion pour |
ID du contenu du film ou de la saison |
Bonus |
est complémentaire à |
ID du contenu du film ou de la saison |
Classement des saisons et épisodes
Vous pouvez personnaliser la façon dont les saisons et les épisodes s’affichent pour les clients à l’aide de WorkTypeDetail au niveau des séries.
Value |
Behavior |
Best For |
StartAtLatestSeasonFirstEpisode |
Montre la dernière saison en premier, à partir de l’épisode 1. |
Séries d’anthologie, actualités, sports, talk-shows, jeux télévisés |
StartAtLatestSeasonLatestEpisode |
Montre la dernière saison et le dernier épisode en premier. |
Actualités, sports, talk-shows où le contenu le plus récent est le plus pertinent |
Chronological |
Classification par ordre chronologique standard. |
Des séries traditionnelles où l’ordre de visionnage est important |
(Aucune valeur définie) |
Classification automatique en fonction du type de contenu. |
Comportements par défaut |
- Définissez cette valeur dans le MEC au niveau de la série uniquement. Elle s’applique automatiquement à toutes les saisons.
- Ce champ s’applique uniquement aux séries télévisées. Non applicable aux films ou à la VAM.
- Vous pouvez mettre à jour cette valeur à tout moment. Les modifications prennent effet une fois le fichier MEC traité.
- L’ordre inversé est automatiquement appliqué aux types de contenu éligibles (actualités, sports, talk-shows, jeux télévisés).
Prise en charge de plusieurs langues
Le modèle d’épisode du référentiel de fichiers d’exemples montre comment livrer plusieurs langues dans un seul fichier MEC. Incluez un bloc LocalizedInfo distinct pour chaque paramètre régional.
Exemple de structure :
- Premier bloc LocalizedInfo : @language="en-US” (avec titre, illustration, synopsis, genres)
- Deuxième bloc LocalizedInfo : @language="es-419" (avec titre localisé, illustration, synopsis, genres)
Chaque bloc LocalizedInfo doit contenir ses propres entrées TitleDisplayUnlimited, ArtReference, Summary190, Summary400 et Genre.
Champs MEC XML rejetés
Les champs suivants sont acceptés par le XSD MEC mais ne sont pas utilisés par Prime Video. Vous pouvez les inclure pour des raisons de conformité avec le XSD, mais cela n’a aucun effet.
- UpdateNum
- LocalizedInfo @Default
- TitleSort (les balises vides sont acceptées pour la conformité avec le XSD)
- Mot-clé
- AlternateTitle
- PictureColorType
- PictureFormat
- AspectRatio
- DistributionNumber
- HouseSequence
- CountryRegion (dans LocalizedInfo et RatingSet)
Codage de caractères spéciaux
Les caractères spéciaux dans les champs du synopsis peuvent entraîner des erreurs de publication s’ils ne sont pas correctement encodés. Utilisez ces références d’entités XML.
Symbol |
Enter As |
< |
< |
> |
> |
& |
& |
' |
' |
" |
" |
Le séparateur vertical (|), le point (.), le dièse (#), la barre oblique (/) et le point d’exclamation (!) peuvent être utilisés tels quels, sans encodage.
Contenu à valeur ajoutée (VAM) dans le fichier MEC XML
Les bandes-annonces et les bonus sont traités comme des entités de contenu distinctes. Pour obtenir des conseils détaillés sur la livraison des bandes-annonces et des bonus, consultez le guide des contenus à valeur ajoutée (VAM). La plupart des valeurs MEC standard s’appliquent. Principaux points de livraison :
- Utilisez WorkType = “promotion” pour les bandes-annonces.
- Utilisez WorkType = “supplemental” pour le contenu bonus.
- Le type de relation avec l’élément source doit être « est une promotion pour » ou « est complémentaire à ».
- Les blocs SequenceInfo et Parent sont obligatoires.
Exigences en matière de localisation
- Les métadonnées peuvent être fournies en plusieurs langues.
- Chaque version localisée doit spécifier son code de langue.
- Les mises à jour partielles sont prises en charge pour les champs localisés tels que le titre et le synopsis.
- Les mises à jour partielles ne sont PAS prises en charge pour les classifications des âges et les acteurs/l’équipe. Incluez toujours toutes les données disponibles.
- Votre soumission la plus récente (par horodatage de livraison) pour une langue donnée est votre version officielle.
À savoir avant de commencer
Générez automatiquement votre fichier MEC XML. La création manuelle entraîne des erreurs.
Utilisez le format URN complet (md:cid:org:[partner_alias]:[id]) pour @ContentID et ParentContentID.
Utilisez uniquement la chaîne d’identification (pas l’URN) dans le champ AltIdentifier/Identifier.
Incluez les quatre entrées ArtReference pour chaque type de contenu, sauf si vous prévoyez de les inclure dans le MMC. Le MMC est le mode de livraison préféré d’Amazon pour les illustrations.
Le MEC au niveau de la série ne nécessite ni People ni ReleaseDate. Ne les incluez pas.
Le MEC au niveau de la saison ne nécessite ni ReleaseDate ni ReleaseHistory. Seul ReleaseYear est nécessaire.
Incluez toujours toutes les classifications des âges et tous les acteurs et membres de l’équipe dans chaque soumission. Pour ces éléments, aucune mise à jour partielle n’est prise en charge.
Chaque épisode a besoin de son propre fichier MEC. Ne combinez pas les épisodes en un seul fichier XML.
Encodez des caractères spéciaux dans les champs du synopsis pour éviter les erreurs de publication.
Définissez WorkTypeDetail au niveau de la série uniquement. Il s’étend à toutes les saisons.
Conseil rapide
Une validation rapide par rapport à la XSD avant la soumission peut vous éviter plusieurs jours d’allers-retours.
Vous avez des questions ? Essayez de demander à l’assistant d’assistance avant de créer un ticket d’assistance via la section Contactez-nous ou contactez votre contact Prime Video.
