Los metadatos MEC (Media Entertainment Core) se usan si eliges publicar mediante las especificaciones de MovieLabs. Si usas la carga de un solo título o mRSS, los metadatos MEC no se aplican a tu caso.
Los archivos MEC deben seguir la especificación MEC v2.6 de MovieLabs con los requisitos específicos de Amazon. Cuando hay conflictos, prevalecen los requisitos de Prime Video. Revisa nuestros archivos de muestra de MEC en el repositorio de archivos de muestra.
Mira este video para ver un recorrido rápido por los requisitos de metadatos de título de Prime Video. Para obtener más información sobre los conceptos básicos de los metadatos de título, visita la siguiente guía:
Metadatos del título: Descripción general
Estándares de entrega de XML de MEC
Sigue estas reglas en cada envío de XML de MEC.
- El XML se debe generar de forma automática. La creación manual de XML provocará errores de entrega.
- Los envíos de archivos MEC deben seguir las reglas de nombres de archivo de Prime Video.
- La definición del esquema XML (XSD) y la documentación están en el paquete de archivos de muestra.
- Los valores ContentID y WorkType se fijan con el primer envío. Si se vuelve a enviar con valores diferentes, se produce un error de entrega.
Formato de ContentID
Tu ContentID debe seguir este formato URN en el atributo @ContentID. El unique_ID, o identificador de contenido (SKU), es el AltID/ALID dentro de la especificación MovieLabs.
Formato: md:cid:org:[partner_alias]:[unique_id]
Ejemplos:
- Película: md:cid:org:wb:suicidesquadfeature
- Serie: md:cid:org:amzn_studios_example:HighCastleSeries
- Temporada: md:cid:org:amzn_studios_example:HighCastle1
- Episodio: md:cid:org:amzn_studios_example:HighCastle1_1
El campo AltIdentifier/Identifier usa sólo la parte de la cadena del identificador. Por ejemplo, usa HighCastle1_1, no el URN completo.
Reglas de actualización y envíos parciales
- Para actualizar metadatos enviados antes, usa exactamente el mismo ContentID que el original.
- Tu envío más reciente (por combinación de idioma y configuración regional, y marca de tiempo de entrega) es tu versión autorizada.
- Las actualizaciones parciales SÍ se admiten para los atributos de las secciones LocalizedInfo.
- Las actualizaciones parciales NO se admiten para RatingSet y People. Incluye siempre todas las clasificaciones y el reparto y equipo.
- Si entregas metadatos para la misma combinación de idioma y configuración regional dos veces, el archivo más reciente sobrescribe el anterior.
Estructura del contenido televisivo
El XML de MEC tiene reglas estructurales específicas para el contenido de TV.
- Cada episodio se debe entregar en su propio archivo XML de MEC.
- Las variantes de varios idiomas para el mismo episodio se pueden combinar en un solo archivo MEC.
- Usa el campo ParentContentID para indicar a qué temporada pertenece un episodio.
- Prime Video prefiere la entrega simultánea de los XML de serie, temporada y episodio.
- Si no es posible la entrega simultánea, entrega de forma secuencial: Primero la serie, luego la temporada y después el episodio.
Requisitos de referencia de material gráfico
Todos los tipos de contenido deben incluir referencias de material gráfico en el archivo MEC.
Tipo de material gráfico |
Valor @purpose |
@resolution |
Patrón de nombre de archivo |
Diseño de portada (4:3) |
Diseño de portada |
3840 x 2160 |
[título]-[configuración regional]-4x3.jpg |
Diseño de portada (16:9) |
Diseño de portada |
3840 x 2160 |
[título]-[configuración regional]-16x9.jpg |
Diseño de carátula (3:4) |
Diseño de carátula |
1920 x 2560 |
[título]-[configuración regional]-3x4.jpg |
Diseño de póster (2:3) |
Diseño de póster |
2000 x 3000 |
[título]-[configuración regional]-2x3.jpg |
Los atributos @resolution y @purpose son obligatorios en cada entrada de ArtReference. Los cuatro tipos de material gráfico aparecen en cada plantilla de tipo de contenido.
Importante
Formato de Genre
Genres debe usar códigos de identificador de género específicos de Amazon en el atributo @id. Se permiten hasta tres géneros por sección de LocalizedInfo. En la tienda se muestran dos géneros; el tercero alimenta los algoritmos de visibilidad.
Formato: <md:Genre @id="[genre_code]">
Ejemplos de códigos de género:
- av_genre_action
- av_genre_drama
- av_genre_science_fiction
La primera entrada de género debe incluir el atributo @source que apunte a la lista de géneros de Amazon.
Campos obligatorios por tipo de contenido
En las siguientes tablas se muestran los estados de los campos de cada tipo de contenido según MEC v2.6. Debido a la cantidad de tipos de contenido, las tablas se agrupan a continuación.
Grupo de tabla A: Película, episodio y temporada
Campo |
Descripción |
Película |
Episodio |
Temporada |
@ContentID |
ID de metadatos único. Debe seguir las prácticas recomendadas de MovieLabs. |
Obligatorio |
Obligatorio |
Obligatorio |
LocalizedInfo |
Bloque de elementos localizables. Se requiere al menos uno. |
Obligatorio |
Obligatorio |
Obligatorio |
@Language |
Código de idioma de la lista de aceptación de Prime Video. |
Obligatorio |
Obligatorio |
Obligatorio |
TitleDisplayUnlimited |
Título de visualización. 250 caracteres como máximo. Lo usa Amazon. |
Obligatorio |
Obligatorio |
Obligatorio |
TitleDisplay60 |
Título corto. 60 caracteres como máximo. |
Mejorado |
Mejorado |
Obligatorio |
ArtReference |
Archivos de material gráfico con los atributos de resolución y propósito. |
Mejorado |
Mejorado |
Mejorado |
Summary190 |
Sinopsis corta. 190 caracteres como máximo. |
Obligatorio |
Obligatorio |
Obligatorio |
Summary400 |
Sinopsis media. 400 caracteres como máximo. |
Obligatorio |
Obligatorio |
Obligatorio |
Summary4000 |
Sinopsis extendida. 4000 caracteres como máximo. |
Mejorado |
Mejorado |
Mejorado |
Genre |
A menos un género de Prime Video. Hasta 3 por LocalizeInfo. |
Obligatorio |
Obligatorio |
Obligatorio |
ReleaseYear |
Año del primer lanzamiento en cualquier territorio. |
Obligatorio |
Obligatorio |
Obligatorio |
ReleaseDate |
Fecha de lanzamiento específica. Formato: AAAA-MM-DD. |
Obligatorio |
Obligatorio |
Mejorado |
ReleaseHistory |
Datos históricos de publicación con territorio y organización. |
Mejorado |
Descartado |
Mejorado |
WorkType |
Clasificación de contenido: película, episodio, temporada, etc. |
Obligatorio |
Obligatorio |
Obligatorio |
WorkTypeDetail |
Clasificación adicional. Se utiliza para ordenar en las series. |
Descartado |
Descartado |
Descartado |
AltiIdentifier (espacio de nombres + identificador) |
ID externo: EIDR, ISAN, IMDB, o ORG. |
Obligatorio |
Obligatorio |
Obligatorio |
RatingSet |
Clasificación del contenido oficial. Proporciona todas las clasificaciones disponibles. |
Obligatorio |
Obligatorio |
Obligatorio |
People |
Entradas con nombre de reparto y equipo. |
Obligatorio |
Obligatorio |
Obligatorio |
OriginalLanguage |
Idioma de la producción original. |
Obligatorio |
Descartado |
Obligatorio |
AssociatedOrg (@role=licensor) |
Organización de licencias con identificador y rol. |
Obligatorio |
Descartado |
Obligatorio |
SequenceInfo/Number |
Número de episodio o temporada de la serie. |
Descartado |
Obligatorio |
Obligatorio |
Parent/ParentContentID |
Vincula el episodio con la temporada o la temporada con la serie. |
Descartado |
Obligatorio |
Obligatorio |
CompanyDisplayCredit |
Nombre del estudio o de la empresa que se muestra a los clientes. 250 caracteres como máximo. |
Obligatorio |
Obligatorio |
Obligatorio |
Grupo de tabla B: Serie, tráiler, contenido adicional y colección
Consulta el grupo de tabla A para ver la descripción de los campos. Aquí se aplican las mismas definiciones de campo.
Campo |
Serie |
Tráiler |
Contenido adicional |
Colección |
@ContentID |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
LocalizedInfo |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
@Language |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
TitleDisplayUnlimited |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
TitleDisplay60 |
Mejorado |
Mejorado |
Mejorado |
Obligatorio |
ArtReference |
Mejorado |
Mejorado |
Mejorado |
Mejorado |
Summary190 |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
Summary400 |
Descartado |
Descartado |
Obligatorio |
Obligatorio |
Summary4000 |
Mejorado |
Descartado |
Descartado |
Mejorado |
Genre |
Obligatorio |
Descartado |
Descartado |
Obligatorio |
ReleaseYear |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
ReleaseDate |
Mejorado |
Descartado |
Descartado |
Mejorado |
ReleaseHistory |
Descartado |
Descartado |
Descartado |
Descartado |
WorkType |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
WorkTypeDetail |
Mejorado |
Descartado |
Descartado |
Obligatorio |
AltIdentifier |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
RatingSet |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
People |
Descartado |
Descartado |
Descartado |
Descartado |
OriginalLanguage |
Descartado |
Descartado |
Descartado |
Descartado |
AssociatedOrg (@role=licensor) |
Descartado |
Descartado |
Descartado |
Descartado |
SequenceInfo/Number |
Descartado |
Obligatorio |
Obligatorio |
Descartado |
Parent/ParentContentID |
Descartado |
Descartado |
Obligatorio |
Descartado |
CompanyDisplayCredit |
Obligatorio |
Obligatorio |
Obligatorio |
Obligatorio |
Consejo rápido
Detalles de campo mejorados
En las siguientes tablas se muestran los detalles de los subcampos de los elementos parent mejorados. Úsalos para proporcionar metadatos más completos y mejorar la visibilidad.
Subcampos de personas
Subcampo |
Descripción |
Película |
Episodio |
Temporada |
Cargo |
El cargo de la persona (por ejemplo, actor, director). |
Obligatorio |
Mejorado |
Obligatorio |
JobFunction |
Rol funcional: Director, productor, actor, escritor o creador. |
Obligatorio |
Mejorado |
Obligatorio |
BillingBlockOrder |
Controla el orden de visualización del reparto en la página de detalles. |
Mejorado |
Mejorado |
Mejorado |
Personaje |
Nombre del personaje interpretado por el miembro del reparto. |
Mejorado |
Mejorado |
Mejorado |
Invitado |
Identifica apariciones de invitados para mayor visibilidad. |
Mejorado |
Mejorado |
Mejorado |
Name/DisplayName |
Nombre completo visible de la persona. |
Obligatorio |
Obligatorio |
Obligatorio |
Name/SortName |
Nombre clasificable para ordenar alfabéticamente. |
Mejorado |
Mejorado |
Mejorado |
Género |
Género de la persona. Admite recomendaciones personalizadas. |
Mejorado |
Mejorado |
Mejorado |
Subcampos de RatingSet
Los subcampos de RatingSet que aparecen a continuación se aplican a todos los tipos de contenido.
Subcampo |
Descripción |
Película |
Episodio |
Temporada |
Clasificación |
El bloque de clasificación del contenido. |
Obligatorio |
Obligatorio |
Obligatorio |
Región |
Región geográfica donde se aplica la clasificación. |
Obligatorio |
Obligatorio |
Obligatorio |
País |
Código ISO del país donde se aplica la clasificación. |
Obligatorio |
Obligatorio |
Obligatorio |
Sistema |
Sistema de clasificación utilizado (por ejemplo, MPAA, BBFC). |
Obligatorio |
Obligatorio |
Obligatorio |
Valor |
El valor nominal (por ejemplo, PG-13, 12A). |
Obligatorio |
Obligatorio |
Obligatorio |
Motivo |
Descripción de la clasificación que se muestra en la página de detalles del título. |
Mejorado |
Mejorado |
Mejorado |
NotRated |
Úsalo cuando no exista una clasificación oficial en ningún territorio. |
Obligatorio |
Obligatorio |
Obligatorio |
IsAdult |
Marca el contenido para adultos para su clasificación y filtro. |
Mejorado |
Mejorado |
Mejorado |
Subcampos de ReleaseHistory (película y temporada)
Subcampo |
Descripción |
Película |
Temporada |
DistrTerritory |
Código de país para el territorio de distribución. |
Mejorado |
Mejorado |
ReleaseOrg |
Organización que participa en este lanzamiento. |
Mejorado |
Mejorado |
@organizationID |
Identificador único de la organización del lanzamiento. |
Mejorado |
Mejorado |
@idType |
Tipo de identificador de organización utilizado. |
Mejorado |
Mejorado |
@role |
Rol de la organización en el lanzamiento. |
Mejorado |
Mejorado |
DisplayName |
Nombre para mostrar de la organización del lanzamiento. |
Mejorado |
Mejorado |
SortName |
Nombre clasificable de la organización del lanzamiento. |
Mejorado |
Mejorado |
Subcampos de AssociatedOrg (película y temporada)
Subcampo |
Descripción |
Película |
Temporada |
@organizationID |
Identificador único de la organización de licencias. |
Obligatorio |
Obligatorio |
@role |
Debe ser “licenciante”. |
Obligatorio |
Obligatorio |
DisplayName |
Nombre para mostrar del licenciante. |
Mejorado |
Mejorado |
SortName |
Nombre clasificable para ordenar alfabéticamente. |
Mejorado |
Mejorado |
AlternateName |
Nombre alternativo del licenciante. |
Mejorado |
Mejorado |
Subcampos mejorados de LocalizeInfo
Subcampo |
Descripción |
Película |
Episodio |
Temporada |
Región |
Región geográfica de los metadatos localizados. |
Mejorado |
Mejorado |
Mejorado |
País |
Código de país de los metadatos localizados. |
Mejorado |
Mejorado |
Mejorado |
OriginalTitle |
Título en su idioma original. Mejora la búsqueda de contenido internacional. |
Mejorado |
Mejorado |
Mejorado |
PeopleLocal |
Nombres localizados de reparto y equipo para la búsqueda en el sector local. |
Mejorado |
Mejorado |
Mejorado |
Campos adicionales mejorados
Campo |
Descripción |
Película |
Episodio |
Temporada |
CountryOfOrigin |
País en el que se produjo el título. |
Mejorado |
Mejorado |
Mejorado |
PrimarySpokenLanguage |
Idioma hablado principal en el contenido. |
Mejorado |
Mejorado |
Mejorado |
VersionLanguage |
Versión de idioma de esta entrada de metadatos específica. |
Mejorado |
Mejorado |
Mejorado |
RunLength |
Duración del título. Se muestra en la página de detalles. |
Mejorado |
Mejorado |
Descartado |
Ubicación |
Datos de ubicación geográfica para la precisión de los metadatos. |
Mejorado |
Mejorado |
Mejorado |
Valores de relación con el elemento parent
Tipo de contenido |
@relationshipType |
ParentContentID apunta a |
Episodio |
isepisodeof |
ContentID de la temporada |
Temporada |
isseasonof |
ContentID de la serie |
Tráiler |
ispromotionfor |
ContentID de la película o temporada |
Contenido adicional |
issupplementalto |
ContentID de la película o temporada |
Orden de temporadas y episodios
Puedes personalizar cómo se muestran las temporadas y los episodios a clientes con WorkTypeDetail en el nivel de serie.
Valor |
Comportamiento |
Mejor para |
StartAtLatestSeasonFirstEpisode |
Muestra primero la temporada más reciente, a partir del episodio 1. |
Serie de antología, noticias, deportes, programas de entrevistas, concursos |
StartAtLatestSeasonLatestEpisode |
Muestra primero la temporada más reciente y el episodio más reciente. |
Noticias, deportes y programas de entrevistas, donde el contenido más reciente es el más relevante |
Cronológico |
Orden cronológico estándar. |
Series tradicionales donde importa el orden de visualización |
(Sin valores establecidos) |
Orden automático según el tipo de contenido. |
Comportamiento predeterminado |
- Establece este valor sólo en el MEC de nivel de serie. Se aplica a todas las temporadas de forma automática.
- Este campo se aplica únicamente a las series de TV. No se aplica a películas ni a VAM.
- Puedes actualizar este valor en cualquier momento. Los cambios surten efecto cuando se procesa el MEC.
- El orden inverso se aplica de forma automática a los tipos de contenido aptos (noticias, deportes, programas de entrevistas, concursos).
Compatibilidad con varios idiomas
La plantilla de episodios del repositorio de archivos de muestra indica cómo entregar varios idiomas en un único archivo MEC. Incluye un bloque LocalizedInfo independiente para cada idioma y configuración regional.
Ejemplo de estructura:
- Primer bloque LocalizedInfo: @language="en-US” (con título, material gráfico, sinopsis y géneros)
- Segundo bloque LocalizedInfo: @language="es-419" (con título, material gráfico, sinopsis y géneros localizados)
Cada bloque LocalizedInfo debe contener sus propias entradas de TitleDisplayUnlimited, ArtReference, Summary190, Summary400 y Genre.
Campos XML del MEC descartados
El XSD del MEC acepta los siguientes campos, pero Prime Video no los usa. Puedes incluirlos para cumplir con el XSD, pero no tienen efecto.
- UpdateNum
- LocalizedInfo @Default
- TitleSort (las etiquetas vacías son válidas para cumplir con el XSD)
- Keyword
- AlternateTitle
- PictureColorType
- PictureFormat
- AspectRatio
- DistributionNumber
- HouseSequence
- CountryRegion (en LocalizedInfo y RatingSet)
Codificación de caracteres especiales
Los caracteres especiales en los campos de sinopsis provocan errores de publicación si no se codifican correctamente. Usa estas referencias de entidad XML.
Símbolo |
Ingresar como |
< |
< |
> |
> |
& |
& |
' |
' |
" |
" |
La barra vertical (|), el punto (.), el numeral (#), la barra diagonal (/) y el signo de exclamación (!) se pueden usar tal cual, sin codificar.
Contenido de material de valor agregado (VAM) en el XML del MEC
Los avances y los materiales adicionales se tratan como entidades de contenido distintas. Para obtener orientación detallada sobre la entrega de tráileres y contenido adicional, visita la guía de Material de valor agregado (VAM). Se aplica la mayoría de los valores estándar del MEC. Puntos de entrega clave:
- Usa WorkType = “promotion” para los tráileres.
- Usa WorkType = “supplemental” para el contenido adicional.
- El tipo de relación con el elemento parent debe ser “ispromotionfor” o “issupplementalto”.
- Los bloques SequenceInfo y Parent son obligatorios.
Requisitos de localización
- Los metadatos se pueden entregar en varios idiomas.
- Cada versión localizada debe especificar su código de idioma.
- Se admiten actualizaciones parciales de campos localizados, como el nombre del título y la sinopsis.
- No se admiten actualizaciones parciales de clasificaciones ni de reparto y equipo. Incluye siempre todos los datos disponibles.
- Tu envío más reciente (según la marca de tiempo de entrega) para un idioma dado es tu versión autorizada.
Lo que debes saber antes de continuar
Genera tu XML de MEC de forma automática. La creación manual provoca errores.
Usa el formato URN completo (md:cid:org:[partner_alias]:[id]) para @ContentID y ParentContentID.
Usa sólo la cadena de identificador (no el URN) en el campo AltIdentifier/Identifier.
Incluye las cuatro entradas de ArtReference para cada tipo de contenido, a menos que tengas previsto incluir el material gráfico en el MMC. El MMC es el método de entrega de material gráfico preferido de Amazon.
El MEC a nivel de serie no requiere People ni ReleaseDate. No los incluyas.
El MEC a nivel de temporada no requiere ReleaseDate ni ReleaseHistory. Sólo se requiere ReleaseYear.
Incluye siempre todas las clasificaciones y el reparto y equipo en cada envío. No se admiten actualizaciones parciales para estos.
Cada episodio necesita su propio archivo MEC. No combines los episodios en un solo XML.
Codifica los caracteres especiales en los campos de sinopsis para evitar errores de publicación.
Establece WorkTypeDetail sólo a nivel de serie. Se aplica en cascada a todas las temporadas.
Consejo rápido
Una validación rápida con el XSD antes de enviar puede ahorrarte días de idas y venidas.
¿Tienes preguntas? Intenta preguntarle al asistente de soporte antes de abrir un ticket de Contáctanos o comunícate con tu contacto de Prime Video.