Este guia de suporte apresenta o processo completo de entrega do seu conteúdo de formato curto ou de criadores, como podcasts e programas de criadores, ao Prime Video usando um feed Media RSS (mRSS). Ele abrange:
- O que é a entrega por mRSS e por que ela simplifica seu pipeline de conteúdo
- Como preparar seu feed e seus arquivos de mídia para a integração
- O que seu feed mRSS deve conter para passar na validação do Prime Video
- Como configurar seu bucket do S3 se você hospedar seus próprios arquivos de mídia
- O que acontece em cada fase, com prazos previstos para cada etapa
- Onde encontrar as especificações de entrega e os arquivos de exemplo antes de começar
⚠️ Observação: Se você for um parceiro novo, poderá selecionar este método de entrega durante a integração. Se você já for um parceiro, entre em contato com seu contato comercial ou operacional.
Como funciona a entrega por mRSS
Com a entrega por mRSS, você publica um feed e o Prime Video faz o trabalho pesado. Em vez de fazer upload dos arquivos manualmente, você mantém uma URL de feed mRSS. O Prime Video consulta esse feed periodicamente e obtém seu conteúdo automaticamente.
- Obtenção automatizada: O Prime Video consulta seu feed e o novo conteúdo sem nenhuma ação da sua parte.
- Sem uploads manuais: Você não envia arquivos ao Prime Video. Você atualiza seu feed e o Prime Video cuida do restante.
⚠️ Observação: A URL do seu feed deve usar HTTPS. URLs de feed apenas com HTTP não são aceitas.
Processo de integração do mRSS
Sua integração passa por seis fases. A tabela abaixo mostra cada fase e o que ela abrange:
Fase |
O que acontece |
|---|---|
Fase 1 |
Configuração do feed (URL do feed e método de autenticação confirmados) |
Fase 2 |
Preparação do feed (conteúdo de teste em conformidade com a especificação pronto) |
Fase 3 |
Teste de feed e conteúdo (etapas de validação e análise do parceiro) |
Fase 4 |
Implementação e entrada em produção |
Fase 5 |
Operação em regime e monitoramento |
📌 Dica: Designe um único ponto de contato na sua organização que possa responder aos comentários em até 24 a 48 horas. Isso mantém sua integração dentro do cronograma.
Introdução: O que você vai precisar
Ter esses itens prontos ajuda todas as fases a avançarem rapidamente.
Detalhes do feed e da entrega
- A URL do seu feed mRSS (deve estar hospedada em HTTPS e ser acessível publicamente ou de forma segura)
- Seu método de autenticação: SigV4 ou NONE
- Seu tipo de conteúdo: Séries
- Sua preferência de frequência de consulta (o padrão é de hora em hora para podcasts)
Se você hospedar arquivos de mídia no seu próprio bucket do S3
- A função IAM e a região do seu bucket do AWS S3
- Seu método de criptografia do S3: SSE-S3, SSE-KMS ou sem criptografia
Especificações de entrega
Antes de criar seu feed, consulte as especificações completas de entrega de vídeo, áudio, legendas e arte. Atender à especificação desde o início significa ingestão mais rápida e menos falhas de validação.
Referência Consulte as especificações completas na nossa página Especificações de entrega.
- Requisitos de formatos de vídeo, resoluções, codecs e taxa de bits
- Especificações de faixa de áudio e requisitos de rotulagem de idioma
- Requisitos de formato de legenda e de legenda oculta
- Requisitos de dimensões, espaço de cor e formato de arquivo da arte
- Práticas recomendadas para todos os arquivos entregues ao Prime Video: Os nomes de arquivo de cada ativo entregue devem ser exclusivos, mas o Prime Video já consegue remover duplicatas de entregas com IDs diferentes. Se você entregar video.mp4 para vários arquivos, poderá pesquisá-lo no Slate usando o prefixo {item_guid}_ para encontrar a versão correta associada ao título.
📌 Dica: Consulte estas especificações antes de preparar seu primeiro envio de feed. Estar em conformidade com a especificação desde o início reduz as idas e vindas durante os testes. Os requisitos para os ativos não mudaram para este método de entrega
Arquivos de exemplo
Faça download dos arquivos de exemplo para ver exatamente como é um conteúdo em conformidade antes de preparar seu próprio envio.
- Arquivos XML de exemplo de feed mRSS com todos os campos necessários preenchidos
- Arquivos de arte de exemplo nas dimensões e proporções corretas
📌 Dica: Consulte os arquivos de exemplo antes de criar seu primeiro feed. Eles mostram exatamente o que o Prime Video espera em cada nível.
Preparação do seu feed mRSS
Seu feed mRSS é o motor do seu pipeline de entrega. O Prime Video lê seu feed para ingerir títulos, metadados, arquivos de mídia e arte. Todos os campos necessários devem estar presentes e formatados corretamente antes que seu feed passe na validação.
Campos necessários no nível do canal
Esses campos descrevem sua série ou seu canal. Eles devem aparecer no início do seu feed, dentro do elemento <channel>.
Campo |
Formato |
Observações |
|---|---|---|
<title> |
Texto simples |
O nome da sua série ou do seu canal |
<description> |
Texto simples |
Descrição da sua série |
<language> |
ISO 639-1 (por exemplo, en-US) |
Idioma principal de áudio da série |
<pubDate> |
ISO 8601 |
Horário da última atualização do feed |
<image><url> |
Mínimo de 1920x1080, proporção 16:9 |
Arte de capa da série. Necessário. |
Arte necessária no nível do canal (arte da temporada)
Seu feed deve incluir um bloco <media:group> no nível do canal para entregar a arte da temporada. Cada elemento de arte usa <itunes:seasonNumber> para associar a imagem a uma temporada específica.
Tipo de imagem |
Valor da categoria |
Proporção de tela |
Dimensões mínimas |
Tamanho máximo do arquivo |
|---|---|---|---|---|
Capa |
cover |
16:9 |
1920 x 1080 px |
10 MB |
Pôster |
poster |
2:3 |
2000 x 3000 px |
10 MB |
Arte da caixa |
box |
4:3 |
1600 x 1200 px |
10 MB |
Destaque |
hero |
16:9 (sem texto) |
1920 x 1080 px |
10 MB |
Os quatro tipos de arte são necessários. Inclua <itunes:seasonNumber> dentro de cada elemento <media:content> para atribuir a arte à temporada correta.
Campos necessários no nível do item
Esses campos descrevem cada episódio individual do seu feed. Todo elemento <item> deve incluir todos os campos necessários para passar na validação.
Campo |
Formato |
Observações |
|---|---|---|
<guid isPermaLink="false"> |
Somente caracteres alfanuméricos, hifens e sublinhados |
ID exclusiva e permanente do episódio. Nunca altere esse valor depois de defini-lo. |
<title> |
Texto simples |
Título do episódio |
<description> |
Texto simples (mínimo de 50 caracteres) |
Descrição do episódio. Procure usar até 400 caracteres para obter melhores resultados. |
<pubDate> |
ISO 8601 |
Data de lançamento original do episódio |
<media:content url> |
URL HTTPS |
Link direto para o seu arquivo de vídeo |
<media:content type> |
Tipo MIME (por exemplo, video/mp4) |
Identifica o formato do vídeo |
<media:thumbnail url> |
Mínimo de 1920x1080, 16:9, máximo de 10 MB |
Imagem em miniatura do episódio |
<media:category> |
Valor de gênero do Prime Video |
Gênero do conteúdo. Deve corresponder a um gênero válido do PV. Consulte o mapeamento entre os gêneros do iTunes e da Amazon. |
<itunes:season> |
Número inteiro |
Número da temporada do episódio |
<itunes:episode> |
Número inteiro |
Número do episódio. Deve ser exclusivo em cada temporada. |
Campos aprimorados no nível do canal
Esses campos melhoram a visibilidade e a experiência do espectador. Inclua-os sempre que possível
Campo |
Formato |
Observações |
|---|---|---|
<guid isPermaLink="false"> |
String, permanente e exclusiva |
O identificador exclusivo/SKU da sua série; será gerado se não for informado. Nunca altere esse valor depois de defini-lo. |
Campos aprimorados no nível do item
Esses campos melhoram a visibilidade e a experiência do espectador. Inclua-os sempre que possível.
Campo |
Formato |
Observações |
|---|---|---|
<media:keywords> |
Texto separado por vírgulas (máximo de 15 palavras-chave) |
Palavras-chave de descoberta para ajudar os espectadores a encontrar seu conteúdo |
<media:rating scheme="amazon_maturity_rating"> |
Código de classificação (por exemplo, NR) |
Classificação etária. Integrado como parte da configuração do feed. Se não for informado, o Prime Video usa NR como padrão, o que limita a exibição nos carrosséis. |
<media:contentlangauge> |
ISO 639-1 (por exemplo, en) |
Idioma de áudio do episódio. Derivado do canal se não for informado. |
<media:credit> |
String |
Funções aceitas: Diretor, Produtor, Ator, Escritor ou Criador. Permite que os usuários pesquisem o conteúdo com base no elenco. |
<dcterms:valid> |
Início/fim em ISO 8601 |
Janela de disponibilidade (por exemplo, 2026-02-01T09:00:00Z/2027-02-01T09:00:00Z). Se for omitido, o conteúdo entra no ar assim que for codificado e os requisitos de publicação forem atendidos. |
<media:subTitle> |
Atributos: type, lang, href |
Arquivo de legendas ou de legendas ocultas. Especifique o formato (por exemplo, text/vtt), o idioma e a URL do arquivo. |
<atom:updated> |
ISO 8601 |
Carimbo de data/hora da última atualização deste item. Deve ser incluído se forem feitas atualizações em itens mais antigos do feed. |
Dicas rápidas: Metadados do feed
- O <guid> da sua série é tão permanente quanto o <guid> do seu episódio. Nunca altere nenhum dos dois depois de publicar.
- As descrições dos episódios devem ter no mínimo 50 caracteres. Descrições curtas não passam na validação.
- Embora não seja obrigatório, recomendamos pelo menos um <media:credit> por episódio para melhorar a visibilidade. Funções aceitas: Diretor, Produtor, Ator, Escritor ou Criador.
- Os valores de gênero devem corresponder aos gêneros do Prime Video. Consulte o mapeamento entre os gêneros do iTunes e da Amazon.
- Toda a arte (nível do canal e do item) tem tamanho máximo de arquivo de 10 MB.
- A arte da temporada usa <itunes:seasonNumber> dentro do bloco <media:group> para direcionar a temporada correta.
- As restrições de território usam códigos de país separados por espaço (por exemplo, US CA GB).
Comportamentos padrão
Se você omitir determinados campos, o Prime Video aplicará estes padrões automaticamente.
- Sem número de temporada: Seu conteúdo assume a Temporada 1 por padrão.
- Sem data de término: Seu conteúdo permanece disponível por tempo indeterminado (até o ano 3333).
- Sem restrição de território: Seu conteúdo fica disponível em todos os territórios do Prime Video.
- Sem frequência de consulta especificada: Os podcasts são consultados de hora em hora por padrão.
Métodos de autenticação compatíveis
- SigV4 (AWS Signature Version 4)
- Basic Auth
Se você hospedar arquivos no seu próprio bucket do S3
Se seus arquivos de mídia estiverem no seu próprio bucket do AWS S3, você precisa conceder permissão ao Prime Video para obter esses arquivos. Esta seção se aplica somente se você usar acesso ao S3 baseado em função IAM. Se você fornecer URLs HTTPS diretas no seu feed, pule esta seção.
Conceda acesso à função IAM do Prime Video
O Prime Video usa uma função IAM dedicada para fazer download dos arquivos de mídia do seu bucket. Você deve adicionar o ARN dessa função à política do seu bucket do S3.
Prime Video IAM Role ARN
arn:aws:iam::584788036134:role/PVPartnerContentFeedConsumerServiceS3DownloadRole-prod
Permissões necessárias na política do bucket
A política do seu bucket deve permitir as ações a seguir para o ARN da função IAM do Prime Video listado acima.
- s3:GetObject - permite que o Prime Video faça download dos seus arquivos de mídia
- s3:ListBucket - permite que o Prime Video liste os objetos do seu bucket
Opções de criptografia
Informe ao Prime Video qual método de criptografia você usa para que o acesso correto seja configurado.
Método de criptografia |
O que você precisa fazer |
|---|---|
SSE-S3 (chaves gerenciadas pelo S3) |
Nenhuma configuração adicional é necessária. Conceda as permissões da política do bucket indicadas acima e tudo estará pronto. |
SSE-KMS (chaves gerenciadas pelo KMS) |
Conceda à função IAM permissão para usar sua chave do KMS, além das permissões da política do bucket indicadas acima. |
Sem criptografia |
Conceda as permissões da política do bucket indicadas acima. Nenhuma etapa adicional é necessária. |
⚠️ Importante: Confirme que a política do seu bucket está atualizada antes do início da fase de configuração do feed. O Prime Video não pode consultar seus arquivos até que esta etapa seja concluída.
Teste do seu feed
Depois de concluir a configuração do feed, você publica conteúdo de teste no seu feed mRSS. O Prime Video executa verificações de validação automatizadas e retorna comentários instantâneos sobre qualquer problema.
O que a validação verifica
- Acessibilidade do feed por recuperação via HTTPS
- Transformação correta para o formato padronizado do Prime Video
- Todos os campos necessários no nível do canal e no nível do item estão presentes e válidos
- Acessibilidade do arquivo de vídeo e qualidade da imagem em miniatura
- Estrutura de hierarquia do podcast (canal, temporada e episódio)
- Restrições de território aplicadas corretamente
Como analisar os resultados
Verifique os resultados da validação na guia Entregas do Slate usando a ID da sua conta. Os erros aparecem com detalhes específicos para que você saiba exatamente o que corrigir.
📌 Boa notícia: Você tem tentativas ilimitadas durante os testes. Corrija o problema, publique o feed novamente e o validador é executado outra vez automaticamente. Continue iterando até que seu feed passe por todas as etapas de validação.
Critérios de sucesso do teste
- Seu feed mRSS passa por todas as etapas de validação
- Seu conteúdo é ingerido corretamente e fica visível no Slate
- Você é notificado e fica pronto para a data de implementação
Entrada em produção
Quando seu feed passa por todas as etapas de validação, o Prime Video ativa sua conta de publicador e a entrega do seu conteúdo começa.
- O status muda para ATIVA: Sua conta de publicador passa de EM TESTE para ATIVA no lançamento.
- A consulta automatizada começa: O Prime Video consulta seu feed e ingere novos episódios à medida que você os publica.
- O conteúdo entra no ar: Seus títulos ficam visíveis nas superfícies de pesquisa e navegação do Prime Video.
- Suporte contínuo: Use a guia Entregas do Slate para monitorar o status da entrega.
Lista de verificação de dicas rápidas
Use esta lista de verificação antes de enviar seu feed pela primeira vez. Cada item é um ponto comum de falha durante a validação.
- A URL do seu feed usa HTTPS. URLs apenas com HTTP não são aceitas.
- O <guid> de cada item é permanente. Nunca altere um guid depois que ele estiver no ar.
- Sua arte de capa e suas miniaturas atendem à resolução mínima de 1920 x 1080 px na proporção 16:9.
- O campo <itunes:episode> está presente em todos os episódios e é exclusivo em cada temporada.
- Os links <media:content url> apontam para arquivos de vídeo acessíveis (HTTPS obrigatório).
- Seu método de autenticação está confirmado e compartilhado com seu contato no Prime Video.
- Se você usar seu próprio bucket do S3, a política do bucket permite s3:GetObject e s3:ListBucket para a função do IAM Prime Video.
- Você consultou as especificações completas de entrega no link da seção acima.
- Você fez download dos seus arquivos e os comparou com os arquivos de exemplo.
- O código de idioma no nível do canal segue o formato ISO 639-1 (por exemplo, en-US).
- Os campos <pubDate> seguem o formato ISO 8601.
- Você entende os comportamentos padrão: sem número de temporada, o padrão é a Temporada 1; sem restrição de território, o padrão são todos os territórios.
- Cada episódio inclui pelo menos um <media:credit> com uma função aceita: Diretor, Produtor, Ator, Escritor ou Criador.
- O valor de <media:category> corresponde a um gênero válido do Prime Video.
- O bloco <media:group> no nível do canal inclui os quatro tipos de arte: cover, poster, box e hero.
- Cada elemento de arte <media:content> inclui <itunes:seasonNumber> para atribuir a arte à temporada correta.
