Os metadados MEC (Media Entertainment Core) são usados se você optar por publicar pela MovieLabs Spec. Se você usar o upload de título único ou o mRSS, os metadados MEC não se aplicam a você.
É necessário que os arquivos MEC sigam a especificação MovieLabs MEC v2.6, com os requisitos específicos da Amazon. Em caso de conflito, os requisitos do Prime Video prevalecem. Revise os nossos arquivos de amostra do MEC no nosso Repositório de arquivos de amostra.
Assista primeiro
Requisitos de metadados do título
Assista a este vídeo para conhecer rapidamente os requisitos de metadados do título no Prime Video. Para saber mais sobre os conceitos básicos dos metadados do título, acesse o guia abaixo:
Metadados do título: Visão geral
Padrões de entrega do MEC XML
Siga estas regras em todo envio de MEC XML.
- É necessário que o seu XML seja gerado automaticamente. A criação manual do XML causa erros de entrega.
- É necessário que os envios de arquivos MEC sigam as regras de nomenclatura de arquivos do Prime Video.
- A definição de esquema XML (XSD) e a documentação estão no pacote de arquivos de amostra.
- Os valores de ContentID e WorkType ficam fixos no primeiro envio. Reenviar com valores diferentes causa um erro de entrega.
Formato do ContentID
É necessário que o seu ContentID siga este formato URN no atributo @ContentID. O unique_ID, ou ContentID (SKU), é o AltID/ALID na especificação MovieLabs.
Formato: md:cid:org:[partner_alias]:[unique_id]
Exemplos:
- Filme: md:cid:org:wb:suicidesquadfeature
- Série: md:cid:org:amzn_studios_example:HighCastleSeries
- Temporada: md:cid:org:amzn_studios_example:HighCastle1
- Episódio: md:cid:org:amzn_studios_example:HighCastle1_1
O campo AltIdentifier/Identifier usa somente a parte da string da ID. Por exemplo, use HighCastle1_1, e não o URN completo.
Regras de atualização e envio parcial
- Para atualizar metadados já entregues, use exatamente o mesmo ContentID do original.
- O seu envio mais recente (por idioma-LOCALE e data e hora da entrega) é a sua versão oficial.
- SÃO aceitas atualizações parciais de atributos dentro das seções LocalizedInfo.
- NÃO são aceitas atualizações parciais de RatingSet e People. Inclua sempre todas as classificações e todo o elenco e equipe técnica.
- Se você entregar metadados para o mesmo idioma-LOCALE duas vezes, o arquivo mais recente substitui o anterior.
Estrutura do conteúdo de TV
O MEC XML tem regras de estrutura específicas para conteúdo de TV.
- É necessário entregar cada episódio no próprio arquivo MEC XML.
- Várias variantes de idioma do mesmo episódio podem ser combinadas em um único arquivo MEC.
- Use o campo ParentContentID para indicar a qual temporada o episódio pertence.
- O Prime Video prefere a entrega simultânea dos XMLs de série, temporada e episódio.
- Se a entrega simultânea não for possível, entregue em sequência: primeiro a série, depois a temporada e, por fim, o episódio.
Requisitos de referência de arte
É necessário que todos os tipos de conteúdo incluam referências de arte no arquivo MEC.
Tipo de arte |
Valor de @purpose |
@resolution |
Padrão do nome do arquivo |
Arte da capa (4:3) |
Arte da capa |
3840x2160 |
[título]-[localidade]-4x3.jpg |
Arte da capa (16:9) |
Arte da capa |
3840x2160 |
[título]-[localidade]-16x9.jpg |
Design da capa (3:4) |
Arte da caixa |
1920x2560 |
[título]-[localidade]-3x4.jpg |
Arte do pôster (2:3) |
Arte do pôster |
2000x3000 |
[título]-[localidade]-2x3.jpg |
Os atributos @resolution e @purpose são obrigatórios em todas as entradas de ArtReference. Os quatro tipos de arte aparecem em todos os modelos de tipo de conteúdo.
![[ICON] Important](https://cdn.bsp.partner-portal.pv.amazon.dev/d6/b7/1bc515f940a9b8e27ca63c3a70d7/callout-important.svg)
Importante
Formato do gênero
É necessário que os gêneros usem códigos de ID de gênero específicos da Amazon no atributo @id. São permitidos até três gêneros por seção LocalizedInfo. Dois gêneros são exibidos na vitrine; o terceiro alimenta os algoritmos de descoberta.
Formato: <md:Genre @id="[genre_code]">
Exemplos de códigos de gênero:
- av_genre_action
- av_genre_drama
- av_genre_science_fiction
A primeira entrada de gênero precisa incluir o atributo @source, que aponta para a lista de gêneros da Amazon.
Campos obrigatórios por tipo de conteúdo
As tabelas a seguir mostram o status dos campos para cada tipo de conteúdo, com base no MEC v2.6. Devido ao número de tipos de conteúdo, as tabelas estão agrupadas abaixo.
Grupo de tabelas A: Filme, episódio e temporada
Campo |
Descrição |
Movie |
Episódio |
Temporada |
@ContentID |
ID exclusiva dos metadados. Precisa seguir as práticas recomendadas do MovieLabs. |
Obrigatório |
Obrigatório |
Obrigatório |
LocalizedInfo |
Bloco de elementos localizáveis. É necessário ao menos um. |
Obrigatório |
Obrigatório |
Obrigatório |
@Language |
Código de idioma da lista permitida do Prime Video. |
Obrigatório |
Obrigatório |
Obrigatório |
TitleDisplayUnlimited |
Título de exibição. Máximo de 250 caracteres. Usado pela Amazon. |
Obrigatório |
Obrigatório |
Obrigatório |
TitleDisplay60 |
Título curto. Máximo de 60 caracteres. |
Aprimorado |
Aprimorado |
Obrigatório |
ArtReference |
Arquivos de arte com os atributos de resolução e finalidade. |
Aprimorado |
Aprimorado |
Aprimorado |
Summary190 |
Sinopse curta. Máximo de 190 caracteres. |
Obrigatório |
Obrigatório |
Obrigatório |
Summary400 |
Sinopse média. Máximo de 400 caracteres. |
Obrigatório |
Obrigatório |
Obrigatório |
Summary4000 |
Sinopse estendida. Máximo de 4.000 caracteres. |
Aprimorado |
Aprimorado |
Aprimorado |
Genre |
Pelo menos um gênero do Prime Video. Até 3 por LocalizedInfo. |
Obrigatório |
Obrigatório |
Obrigatório |
ReleaseYear |
Ano do primeiro lançamento em qualquer território. |
Obrigatório |
Obrigatório |
Obrigatório |
ReleaseDate |
Data de lançamento específica. Formato: AAAA-MM-DD. |
Obrigatório |
Obrigatório |
Aprimorado |
ReleaseHistory |
Dados históricos de lançamento, com território e organização. |
Aprimorado |
Descartado |
Aprimorado |
WorkType |
Classificação do conteúdo: movie, episode, season, etc. |
Obrigatório |
Obrigatório |
Obrigatório |
WorkTypeDetail |
Classificação adicional. Usado na ordenação das séries. |
Descartado |
Descartado |
Descartado |
AltIdentifier (Namespace + Identifier) |
ID externa: EIDR, ISAN, IMDB ou ORG. |
Obrigatório |
Obrigatório |
Obrigatório |
RatingSet |
Classificação indicativa oficial do conteúdo. Informe todas as classificações disponíveis. |
Obrigatório |
Obrigatório |
Obrigatório |
People |
Entradas nomeadas de elenco e equipe técnica. |
Obrigatório |
Obrigatório |
Obrigatório |
OriginalLanguage |
Idioma da produção original. |
Obrigatório |
Descartado |
Obrigatório |
AssociatedOrg (@role=licensor) |
Organização licenciante, com ID e papel. |
Obrigatório |
Descartado |
Obrigatório |
SequenceInfo/Number |
Número do episódio ou da temporada na série. |
Descartado |
Obrigatório |
Obrigatório |
Parent/ParentContentID |
Vincula o episódio à temporada ou a temporada à série. |
Descartado |
Obrigatório |
Obrigatório |
CompanyDisplayCredit |
Nome do estúdio ou da empresa exibido aos clientes. Máximo de 250 caracteres. |
Obrigatório |
Obrigatório |
Obrigatório |
Grupo de tabelas B: Série, trailer, conteúdo extra e coleção
Consulte o Grupo de tabelas A para ver as descrições dos campos. As mesmas definições de campo se aplicam aqui.
Campo |
séries |
Trailer |
Bônus |
Coleção |
@ContentID |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
LocalizedInfo |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
@Language |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
TitleDisplayUnlimited |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
TitleDisplay60 |
Aprimorado |
Aprimorado |
Aprimorado |
Obrigatório |
ArtReference |
Aprimorado |
Aprimorado |
Aprimorado |
Aprimorado |
Summary190 |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
Summary400 |
Descartado |
Descartado |
Obrigatório |
Obrigatório |
Summary4000 |
Aprimorado |
Descartado |
Descartado |
Aprimorado |
Genre |
Obrigatório |
Descartado |
Descartado |
Obrigatório |
ReleaseYear |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
ReleaseDate |
Aprimorado |
Descartado |
Descartado |
Aprimorado |
ReleaseHistory |
Descartado |
Descartado |
Descartado |
Descartado |
WorkType |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
WorkTypeDetail |
Aprimorado |
Descartado |
Descartado |
Obrigatório |
AltIdentifier |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
RatingSet |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
People |
Descartado |
Descartado |
Descartado |
Descartado |
OriginalLanguage |
Descartado |
Descartado |
Descartado |
Descartado |
AssociatedOrg (@role=licensor) |
Descartado |
Descartado |
Descartado |
Descartado |
SequenceInfo/Number |
Descartado |
Obrigatório |
Obrigatório |
Descartado |
Parent/ParentContentID |
Descartado |
Descartado |
Obrigatório |
Descartado |
CompanyDisplayCredit |
Obrigatório |
Obrigatório |
Obrigatório |
Obrigatório |
![[ICON] Quick Tip](https://cdn.bsp.partner-portal.pv.amazon.dev/15/83/24f05f5140078772701d7026c11f/callout-quick-tip.svg)
Dica rápida
Detalhes dos campos aprimorados
As tabelas abaixo mostram os detalhes dos subcampos dos elementos parent aprimorados. Use-as para fornecer metadados mais completos e melhorar a visibilidade.
Subcampos de People
Subcampo |
Descrição |
Movie |
Episódio |
Temporada |
Job |
A função da pessoa (por exemplo, Actor, Director). |
Obrigatório |
Aprimorado |
Obrigatório |
JobFunction |
Papel funcional: Diretor, Produtor, Ator, Escritor ou Criador. |
Obrigatório |
Aprimorado |
Obrigatório |
BillingBlockOrder |
Controla a ordem de exibição do elenco na página de detalhes. |
Aprimorado |
Aprimorado |
Aprimorado |
Personagem |
Nome do personagem interpretado pelo membro do elenco. |
Aprimorado |
Aprimorado |
Aprimorado |
Guest |
Sinaliza participações especiais, para facilitar a descoberta. |
Aprimorado |
Aprimorado |
Aprimorado |
Name/DisplayName |
Nome de exibição completo da pessoa. |
Obrigatório |
Obrigatório |
Obrigatório |
Name/SortName |
Nome para ordenação alfabética. |
Aprimorado |
Aprimorado |
Aprimorado |
Gender |
Gênero da pessoa. Contribui para recomendações personalizadas. |
Aprimorado |
Aprimorado |
Aprimorado |
Subcampos de RatingSet
Os subcampos de RatingSet abaixo se aplicam a todos os tipos de conteúdo.
Subcampo |
Descrição |
Movie |
Episódio |
Temporada |
Classificação |
O bloco de classificação do conteúdo. |
Obrigatório |
Obrigatório |
Obrigatório |
Região |
Região geográfica em que a classificação se aplica. |
Obrigatório |
Obrigatório |
Obrigatório |
País |
Código ISO do país em que a classificação se aplica. |
Obrigatório |
Obrigatório |
Obrigatório |
System |
Sistema de classificação usado (por exemplo, MPAA, BBFC). |
Obrigatório |
Obrigatório |
Obrigatório |
Valor |
O valor da classificação (por exemplo, PG-13, 12A). |
Obrigatório |
Obrigatório |
Obrigatório |
Reason |
Descrição da classificação exibida na página de detalhes do título. |
Aprimorado |
Aprimorado |
Aprimorado |
NotRated |
Use quando não houver classificação oficial em nenhum território. |
Obrigatório |
Obrigatório |
Obrigatório |
IsAdult |
Sinaliza conteúdo adulto para classificação e filtragem. |
Aprimorado |
Aprimorado |
Aprimorado |
Subcampos de ReleaseHistory (filme e temporada)
Subcampo |
Descrição |
Movie |
Temporada |
DistrTerritory |
Código do país do território de distribuição. |
Aprimorado |
Aprimorado |
ReleaseOrg |
Organização envolvida neste lançamento. |
Aprimorado |
Aprimorado |
@organizationID |
ID exclusiva da organização responsável pelo lançamento. |
Aprimorado |
Aprimorado |
@idType |
Tipo de ID de organização usado. |
Aprimorado |
Aprimorado |
@role |
Papel da organização no lançamento. |
Aprimorado |
Aprimorado |
DisplayName |
Nome de exibição da organização responsável pelo lançamento. |
Aprimorado |
Aprimorado |
SortName |
Nome para ordenação da organização responsável pelo lançamento. |
Aprimorado |
Aprimorado |
Subcampos de AssociatedOrg (filme e temporada)
Subcampo |
Descrição |
Movie |
Temporada |
@organizationID |
ID exclusiva da organização licenciante. |
Obrigatório |
Obrigatório |
@role |
Precisa ser “licensor.” |
Obrigatório |
Obrigatório |
DisplayName |
Nome de exibição do licenciante. |
Aprimorado |
Aprimorado |
SortName |
Nome para ordenação alfabética. |
Aprimorado |
Aprimorado |
AlternateName |
Nome alternativo do licenciante. |
Aprimorado |
Aprimorado |
Subcampos aprimorados de LocalizedInfo
Subcampo |
Descrição |
Movie |
Episódio |
Temporada |
Região |
Região geográfica dos metadados localizados. |
Aprimorado |
Aprimorado |
Aprimorado |
País |
Código do país dos metadados localizados. |
Aprimorado |
Aprimorado |
Aprimorado |
OriginalTitle |
Título no idioma original. Melhora a pesquisa de conteúdo internacional. |
Aprimorado |
Aprimorado |
Aprimorado |
PeopleLocal |
Nomes localizados do elenco e da equipe técnica, para pesquisa no mercado local. |
Aprimorado |
Aprimorado |
Aprimorado |
Campos aprimorados adicionais
Campo |
Descrição |
Movie |
Episódio |
Temporada |
CountryOfOrigin |
País em que o título foi produzido. |
Aprimorado |
Aprimorado |
Aprimorado |
PrimarySpokenLanguage |
Principal idioma falado no conteúdo. |
Aprimorado |
Aprimorado |
Aprimorado |
VersionLanguage |
Versão de idioma desta entrada de metadados. |
Aprimorado |
Aprimorado |
Aprimorado |
RunLength |
Duração do título. Exibida na página de detalhes. |
Aprimorado |
Aprimorado |
Descartado |
Localização |
Dados de localização geográfica para a precisão dos metadados. |
Aprimorado |
Aprimorado |
Aprimorado |
Valores da relação parent
Tipo de conteúdo |
@relationshipType |
Para onde aponta o ParentContentID |
Episódio |
isepisodeof |
ContentID da temporada |
Temporada |
isseasonof |
ContentID da série |
Trailer |
ispromotionfor |
ContentID do filme ou da temporada |
Bônus |
issupplementalto |
ContentID do filme ou da temporada |
Ordem das temporadas e dos episódios
Você pode personalizar a forma como as temporadas e os episódios são exibidos aos clientes com o WorkTypeDetail no nível da série.
Valor |
Comportamento |
Ideal para |
StartAtLatestSeasonFirstEpisode |
Mostra primeiro a temporada mais recente, a partir do episódio 1. |
Séries de antologia, notícias, esportes, talk shows, game shows |
StartAtLatestSeasonLatestEpisode |
Mostra primeiro a temporada mais recente e o episódio mais recente. |
Notícias, esportes e talk shows em que o conteúdo mais recente é o mais relevante |
Chronological |
Ordem cronológica padrão. |
Séries tradicionais em que a ordem de exibição importa |
(Nenhum valor definido) |
Ordem automática com base no tipo de conteúdo. |
Comportamento padrão |
- Defina este valor somente no MEC do nível da série. Ele se aplica automaticamente a todas as temporadas.
- Este campo se aplica somente a séries. Não se aplica a filmes nem a VAM.
- Você pode atualizar este valor a qualquer momento. As alterações entram em vigor depois que o MEC é processado.
- A ordem inversa é aplicada automaticamente aos tipos de conteúdo qualificados (notícias, esportes, talk shows, game shows).
Suporte a vários idiomas
O modelo de episódio no Repositório de arquivos de amostra mostra como entregar vários idiomas em um único arquivo MEC. Inclua um bloco LocalizedInfo separado para cada idioma-LOCALE.
Exemplo de estrutura:
- Primeiro bloco LocalizedInfo: @language="en-US” (com título, arte, sinopses, gêneros)
- Segundo bloco LocalizedInfo: @language="es-419" (com título, arte, sinopses e gêneros localizados)
Cada bloco LocalizedInfo precisa conter as próprias entradas de TitleDisplayUnlimited, ArtReference, Summary190, Summary400 e Genre.
Campos descartados do MEC XML
Os campos a seguir são aceitos pelo XSD do MEC, mas não são usados pelo Prime Video. Você pode incluí-los para manter a conformidade com o XSD, mas eles não têm efeito.
- UpdateNum
- LocalizedInfo @Default
- TitleSort (tags vazias são aceitas para a conformidade com o XSD)
- Keyword
- AlternateTitle
- PictureColorType
- PictureFormat
- AspectRatio
- DistributionNumber
- HouseSequence
- CountryRegion (em LocalizedInfo e RatingSet)
Codificação de caracteres especiais
Caracteres especiais nos campos de sinopse causam erros de publicação se não forem codificados corretamente. Use estas referências de entidade XML.
Símbolo |
Inserir como |
< |
< |
> |
> |
& |
& |
' |
' |
“ |
" |
A barra vertical (|), o ponto (.), a cerquilha (#), a barra (/) e o ponto de exclamação (!) podem ser usados como estão, sem codificação.
Conteúdo de material de valor agregado (VAM) no MEC XML
Trailers e materiais extras são tratados como entidades de conteúdo distintas. Para obter orientações detalhadas sobre a entrega de trailers e conteúdo extra, acesse o Guia de material de valor agregado (VAM). A maioria dos valores padrão do MEC se aplica. Principais pontos da entrega:
- Use WorkType = “promotion” para trailers.
- Use WorkType = “supplemental” para conteúdo extra.
- É necessário que o tipo de relação parent seja “ispromotionfor” ou “issupplementalto.”
- Os blocos SequenceInfo e Parent são obrigatórios.
Requisitos de localização
- Os metadados podem ser entregues em vários idiomas.
- É necessário que cada versão localizada especifique o código de idioma.
- São aceitas atualizações parciais de campos localizados, como nome do título e sinopse.
- NÃO são aceitas atualizações parciais de classificações e de elenco e equipe técnica. Inclua sempre todos os dados disponíveis.
- O seu envio mais recente (por data e hora da entrega) para um determinado idioma é a sua versão oficial.
O que saber antes de começar
Gere o seu MEC XML automaticamente. A criação manual causa erros.
Use o formato URN completo (md:cid:org:[partner_alias]:[id]) em @ContentID e ParentContentID.
Use somente a string da ID (e não o URN) no campo AltIdentifier/Identifier.
Inclua as quatro entradas de ArtReference para cada tipo de conteúdo, a menos que pretenda incluí-las no MMC. O MMC é o método de entrega de arte preferido da Amazon.
O MEC no nível da série não exige People nem ReleaseDate. Não os inclua.
O MEC no nível da temporada não exige ReleaseDate nem ReleaseHistory. Só o ReleaseYear é necessário.
Inclua sempre todas as classificações e todo o elenco e equipe técnica em cada envio. Não são aceitas atualizações parciais desses campos.
Cada episódio precisa do próprio arquivo MEC. Não junte episódios em um único XML.
Codifique os caracteres especiais nos campos de sinopse para evitar erros de publicação.
Defina o WorkTypeDetail somente no nível da série. Ele se propaga para todas as temporadas.
Dica rápida
Uma validação rápida com o XSD antes do envio pode poupar dias de idas e vindas.
Tem dúvidas? Pergunte ao Assistente de suporte antes de abrir um chamado pelo Fale conosco, ou entre em contato com o seu contato do Prime Video.
