As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Solucionando problemas e pulando de MediaTailor
Ignorar anúncios é um dos problemas mais comuns relatados pelos MediaTailor clientes. Esta seção fornece uma análise detalhada do motivo pelo qual os anúncios podem ser ignorados durante a reprodução e oferece soluções para garantir a inserção adequada do anúncio.
Sintomas e impacto
Quando ocorre a omissão de anúncios, você pode observar os seguintes sintomas:
-
Anúncios que não aparecem durante os intervalos publicitários esperados
-
Pausas publicitárias preenchidas com conteúdo em vez de anúncios
-
Reprodução inconsistente de anúncios em diferentes sessões de visualização
-
CloudWatch registros mostrando
AdSkipped
eventos com vários motivos de salto
A omissão de anúncios afeta diretamente a geração de receita e pode levar a experiências ruins para os espectadores se não for tratada imediatamente.
Causas comuns
MediaTailor registra os motivos específicos pelos quais os anúncios são ignorados na mensagem de registro de FILLED_AVAIL
eventos do grupo de MediaTailor/AdDecisionServerInteractions
registros. Compreender esses motivos de omissão é crucial para uma solução eficaz de problemas.
Ignorar o motivo | Descrição |
---|---|
NEW_CREATIVE |
O anúncio ainda não foi transcodificado. Isso ocorre quando se depara com MediaTailor um novo anúncio criativo que requer transcodificação antes da inserção. |
PROFILE_NOT_FOUND |
O perfil de MediaConvert transcodificação associado à configuração da sessão não existe, impedindo a preparação do anúncio. |
TRANSCODE_ERROR |
O processo de transcodificação do anúncio encontrou um erro e não foi concluído. |
TRANSCODE_IN_PROGRESS |
A transcodificação do anúncio ainda está em andamento e ainda não está pronta para inserção. |
INTERNAL_ERROR |
Ocorreu um MediaTailor erro interno ao manusear o anúncio, impedindo a inserção. |
AVAIL_DURATION_EXCEEDED |
O anúncio não se encaixa na duração restante do intervalo publicitário. |
LEFTOVER_AVAIL_EXCEEDED_THRESHOLD |
A duração cumulativa de todos os anúncios que poderiam ter sido inseridos não atende ao limite de personalização configurado para a sessão. |
VAST_PARSING_ERROR |
A resposta VAST do servidor de decisão do anúncio contém erros ou está mal formada. |
ADS_TIMEOUT |
O servidor de decisão do anúncio não respondeu dentro do período de tempo limite configurado. |
MEDIA_FILE_UNAVAILABLE |
Os arquivos de mídia publicitária especificados na resposta VAST não estão acessíveis. |
SESSION_INITIALIZATION_FAILED |
A MediaTailor sessão falhou ao inicializar corretamente, geralmente devido a variáveis de sessão incorretas. |
EARLY_CUE_IN |
O intervalo publicitário terminou mais cedo do que o esperado devido a um sinal de alerta antecipado, impedindo que o anúncio fosse totalmente inserido. |
NO_VARIANT_MATCH |
O anúncio criativo não tem uma variante que corresponda aos parâmetros de codificação do fluxo de conteúdo (taxa de bits, resolução, codec). |
NO_MODEL_CREATIVE_MATCH |
O anúncio criativo não corresponde aos requisitos de modelo ou formato esperados para a configuração de reprodução atual. |
REJECTED_REPLICA_VAST |
A resposta do VAST foi rejeitada devido às políticas de detecção de conteúdo duplicado ou de réplicas. |
INVALID_VAST_WRAPPER_AD |
O anúncio de invólucro VAST contém elementos de embalagem inválidos ou malformados que impedem a inserção bem-sucedida do anúncio. |
IMPORT_ERROR |
Ocorreu um erro durante o processo de importação do anúncio, impedindo que o anúncio fosse processado para inserção. |
IMPORT_IN_PROGRESS |
O processo de importação de anúncios está em andamento e ainda não foi concluído. |
Além desses motivos específicos de pular, outras causas comuns incluem:
-
Configuração incorreta da variável de sessão
-
Problemas de conectividade do Ad Decision Server (ADS)
-
Criatividade inconsistente IDs para o mesmo conteúdo publicitário
-
Problemas de compatibilidade do player com o formato do manifesto
-
Problemas de configuração de CDN que afetam a entrega do segmento de anúncios
Etapas de solução de problemas
Siga estas etapas para diagnosticar e resolver problemas de ignorar anúncios:
-
Identifique o motivo específico do salto
Use o CloudWatch Logs Insights para consultar o grupo de
MediaTailor/AdDecisionServerInteractions
registros para anúncios ignorados:fields @timestamp, avail.availId, skippedAds.0.skippedReason, skippedAds.0.creativeUniqueId | filter eventType = "FILLED_AVAIL" and ispresent(skippedAds.0.skippedReason) | sort @timestamp desc
Essa consulta retorna os eventos de salto de anúncios mais recentes com seus motivos específicos, ajudando você a identificar padrões.
-
Verifique a configuração da variável de sessão
Variáveis de sessão incorretas são uma causa comum de ignorar anúncios. Verificar se:
-
Todas as variáveis de sessão necessárias estão configuradas corretamente em seu modelo de URL do ADS
-
As variáveis dinâmicas estão formatadas corretamente (consulte MediaTailor variáveis de anúncios dinâmicas para obter a sintaxe adequada)
-
Os parâmetros do jogador estão sendo passados corretamente para MediaTailor
Exemplo de um URL do ADS configurado corretamente com variáveis de sessão:
https://my-ads-server.com/ads? sessionId=[session.id]& playerParams=[player_params.param1]& deviceType=[player_params.device]& correlator=[session.avail_duration_ms]
-
-
Resolver problemas de NEW_CREATIVE
Se os anúncios estiverem sendo ignorados com o
NEW_CREATIVE
motivo:MediaTailor transcodifica anúncios com base em três fatores principais: ID criativa, ID da conta da AWS e conjunto de variantes de transcodificação (as representações de reprodução do stream de conteúdo subjacente). Se alguma parte do conjunto de variantes da ID criativa ou da transcodificação for diferente, MediaTailor reconhecerá o anúncio como uma nova variante que requer transcodificação. Isso inclui alterações na taxa de bits quando arredondadas para os 8.000 bits mais próximos, o que pode ocorrer quando o fluxo de conteúdo subjacente altera o manifesto primário.
Para obter informações detalhadas sobre os cenários NEW_CREATIVE, incluindo alterações na taxa de bits e conflitos de ID criativa, consulte a Análise detalhada do NEW_CREATIVE seção após este procedimento.
-
Verifique se seu servidor de decisão de anúncio está retornando uma criatividade consistente IDs para o mesmo conteúdo do anúncio
-
Verifique se seu stream de conteúdo mantém taxas de bits e conjuntos de variantes consistentes
-
Considere implementar a pré-busca de anúncios para garantir que os anúncios sejam transcodificados antes da reprodução (consulte) Pré-busca de anúncios
-
Para problemas persistentes, entre em contato com o AWS Support
para obter assistência adicional na solução de problemas
-
-
Resolver problemas de conectividade do ADS
Se os anúncios estiverem sendo ignorados por motivos
ADS_TIMEOUT
relacionados:-
Verifique se seu servidor de decisão de anúncios está acessível a partir de MediaTailor
-
Verifique se seu ADS está respondendo dentro do período de tempo limite configurado
-
Garanta que seu ADS possa lidar com o volume de solicitações durante os períodos de pico
-
Considere implementar uma estratégia de anúncios alternativos para quando seu ADS principal estiver indisponível
-
-
Resolva problemas de resposta do VAST
Se os anúncios estiverem sendo ignorados com
VAST_PARSING_ERROR
ou:MEDIA_FILE_UNAVAILABLE
-
Valide seu formato de resposta VAST em relação à especificação VAST
-
Garanta que todos os arquivos de mídia URLs na resposta do VAST estejam acessíveis ao público
-
Verifique a codificação adequada de caracteres especiais em seu XML VAST
-
Verifique se sua resposta VAST inclui arquivos de mídia em formatos compatíveis com MediaTailor
-
-
Solucione problemas de incompatibilidade de duração
Se os anúncios estiverem sendo ignorados com
AVAIL_DURATION_EXCEEDED
ou:LEFTOVER_AVAIL_EXCEEDED_THRESHOLD
-
Certifique-se de que seu ADS esteja retornando anúncios que se encaixam na duração do intervalo publicitário disponível
-
Verifique se os marcadores de quebra de anúncio no conteúdo estão sinalizando corretamente a duração pretendida
-
Considere ajustar o limite de personalização, se apropriado para seu caso de uso
-
-
Monitore CloudWatch métricas
Configure CloudWatch alarmes para as principais MediaTailor métricas para detectar proativamente problemas de omissão de anúncios:
-
AdDecisionServer.Ads.Skipped
- Contagem de anúncios ignorados -
AdDecisionServer.Timeouts
- Contagem de tempos limite do ADS -
Avail.FilledDuration
- Duração dos intervalos publicitários preenchidos -
Avail.SlateOnly
- Contagem de intervalos publicitários preenchidos apenas com ardósia
Para obter mais informações sobre as métricas disponíveis, consulte Monitoramento AWS Elemental MediaTailor com CloudWatch métricas da Amazon.
-
-
Resolver problemas de correspondência e formato de variantes
Se os anúncios estiverem sendo ignorados por motivos relacionados a
NO_VARIANT_MATCH
,NO_MODEL_CREATIVE_MATCH
EARLY_CUE_IN
, ou relacionados ao formato:-
NO_VARIANT_MATCH
: garanta que seus anúncios criativos estejam disponíveis em variantes que correspondam aos parâmetros de codificação do seu fluxo de conteúdo (taxa de bits, resolução, codec). Configure seu servidor de anúncios para fornecer anúncios em formatos compatíveis. -
NO_MODEL_CREATIVE_MATCH
: revise os requisitos do modelo criativo da sua configuração de reprodução e garanta que seu servidor de anúncios forneça anúncios que correspondam ao formato e às especificações esperados. -
EARLY_CUE_IN
: verifique se os sinais de entrada do seu stream de conteúdo estão sincronizados corretamente e se os intervalos publicitários têm duração suficiente para a inserção do anúncio. Verifique se há EXT-X-CUE-IN tags prematuras ou mensagens SCTE-35 splice_insert.
-
-
Resolva problemas de invólucro e importação do VAST
Se os anúncios estiverem sendo ignorados com
REJECTED_REPLICA_VAST
,,INVALID_VAST_WRAPPER_AD
IMPORT_ERROR
, ou:IMPORT_IN_PROGRESS
-
REJECTED_REPLICA_VAST
: verifique a configuração do seu servidor de anúncios para ver se há políticas de detecção de conteúdo duplicado. Garanta que as respostas do VAST contenham conteúdo criativo exclusivo e evite veicular anúncios idênticos na mesma sessão. -
INVALID_VAST_WRAPPER_AD
: valide suas respostas do invólucro VAST em relação à especificação VAST. Certifique-se de que todos os elementos do invólucro estejam formatados corretamente e contenham TagURI válido VASTAd. -
IMPORT_ERROR
eIMPORT_IN_PROGRESS
: Isso indica problemas com o processo de importação de anúncios. Verifique a acessibilidade e a compatibilidade de formatos nos arquivos de origem do anúncio. Monitore o progresso da importação e repita as importações com falha.
-
Análise detalhada do NEW_CREATIVE
Esta seção fornece informações abrangentes sobre os cenários de ignorar anúncios do NEW_CREATIVE, incluindo as causas subjacentes e as técnicas avançadas de solução de problemas.
Cenário de mudanças na taxa de bits
Alterações na taxa de bits podem fazer com que NEW_CREATIVE pule quando a taxa de bits não coincide após ser arredondada para os 8.000 bits mais próximos. Isso geralmente ocorre quando:
-
O fluxo de conteúdo subjacente altera o manifesto principal
-
Novas sessões são criadas com variantes diferentes das sessões existentes
-
As taxas de bits do fluxo de conteúdo são inconsistentes nas sessões de reprodução
Conflitos de ID criativa
Quando MediaTailor encontra uma ID criativa diferente para um arquivo de mídia que já foi transcodificado, ocorre a seguinte sequência:
-
O anúncio é ignorado pelo motivo NEW_CREATIVE
-
Isso leva a uma tentativa desnecessária de transcodificação.
-
O criativo está marcado como DUPLICATE_TRANSCODE ou COPY_DEDUP
nota
MediaTailor não expira nem exclui anúncios transcodificados. Eles são armazenados em um bucket S3 MediaTailor de propriedade indefinidamente.
Processamento ETAG
O ETAG é um identificador exclusivo associado a uma versão específica de uma playlist ou manifesto de anúncios. MediaTailor usa a ID criativa para identificar um recurso de anúncio, mas se a ID criativa mudar a cada solicitação, o anúncio poderá ser marcado como novo criativo, impedindo a inserção.
Atenção
Não é garantido que o ID criativo seja exclusivo, o que pode resultar na exibição incorreta de anúncios.
Problemas de formato de duração
A inserção de anúncios no lado do servidor (SSAI) exige formatos específicos de parâmetros de duração nos arquivos de manifesto. Formatos de duração incorretos podem causar falhas na inserção de anúncios.
EXT-X-CUE-OUT parâmetro de duração
O parâmetro de duração da EXT-X-CUE-OUT tag deve ser formatado como um valor inteiro, não como um formato de duração ISO 8601.
Formato | Exemplo | Status |
---|---|---|
Inteiro (correto) | 32 |
Suportado - representa 32 segundos |
Decimal (correto) | 30.000 |
Suportado - representa 30 segundos |
ISO 8601 (incorreto) | PT32S |
Não suportado - causa falhas de inserção |
Exemplo de formato de manifesto correto:
#EXTM3U #EXT-X-VERSION:3 #EXT-X-TARGETDURATION:10 #EXTINF:10.0, segment1.ts #EXT-X-CUE-OUT:30 #EXTINF:10.0, segment2.ts #EXT-X-CUE-IN #EXTINF:10.0, segment3.ts
Importante
Certifique-se de que todos os parâmetros de EXT-X-CUE-OUT duração usem o formato inteiro para evitar problemas de inserção de anúncios.
Validando formatos de marcadores de anúncios
Para validar o formato do marcador de anúncio e identificar problemas de análise de duração:
-
Verifique o formato do marcador de anúncio nos CloudWatch registros em eventos
AD_MARKER_FOUND
-
Procure motivos para
FORMAT_ERROR
pular em eventosFILLED_AVAIL
-
Verifique se os valores de duração em seu manifesto de conteúdo usam formatos compatíveis
-
Teste com diferentes formatos de duração para identificar problemas de compatibilidade
Otimização do fluxo de VOD
Os streams de vídeo sob demanda (VOD) podem gerar várias solicitações de ADS, o que pode afetar o desempenho. MediaTailor fornece recursos de otimização para lidar com esse comportamento.
Problema de várias solicitações de ADS
Por padrão, os fluxos de VOD podem gerar vários eventos MAKING_ADS_REQUEST nos registros. MediaTailor Isso ocorre porque cada interrupção de anúncio no conteúdo do VOD aciona uma solicitação separada do ADS para o servidor de decisão do anúncio.
Para identificar se seus fluxos de VOD estão gerando solicitações excessivas de ADS, use esta consulta do CloudWatch Logs Insights:
fields @timestamp, sessionId, eventType, adBreakIndex | filter eventType = "MAKING_ADS_REQUEST" | stats count() by sessionId | sort count desc | limit 20
Recurso de paralelização de VOD
MediaTailor oferece um recurso de paralelização para otimizar o tratamento de solicitações de ADS para conteúdo VOD. Esse recurso pode ser configurado usando o maxConcurrentAdsRequests
parâmetro em sua configuração de reprodução.
Exemplo de configuração:
{ "Name": "OptimizedVODConfig", "VideoContentSourceUrl": "https://example.com/content/", "AdDecisionServerUrl": "https://example.com/ads", "maxConcurrentAdsRequests": 3 }
Essa configuração limita o número de solicitações simultâneas de ADS, reduzindo a carga do servidor e melhorando os tempos de resposta.
Manipulação de respostas VAST embal
O recurso de paralelização também otimiza o tratamento de respostas VAST agrupadas, que são comuns em cenários de publicidade programática. As respostas VAST agrupadas contêm várias camadas de tags VAST que precisam ser desempacotadas para alcançar os arquivos de mídia reais.
Solução de problemas de variáveis de sessão
As variáveis de sessão desempenham um papel fundamental na segmentação e seleção de anúncios. A configuração incorreta da variável de sessão é uma causa comum de problemas de ignorar anúncios.
Problemas comuns de variáveis de sessão
Os seguintes problemas com variáveis de sessão podem fazer com que o anúncio seja ignorado:
-
Variáveis obrigatórias ausentes: seu servidor de decisão de anúncios pode exigir variáveis específicas que não estão sendo fornecidas
-
Sintaxe de variável incorreta: as variáveis devem usar a sintaxe correta (por exemplo,
[session.id]
em vez de)${session.id}
-
Problemas de codificação de URL: caracteres especiais em valores variáveis podem precisar de codificação de URL adequada
-
Parâmetros inconsistentes do jogador: os parâmetros do jogador devem ser transmitidos de forma consistente entre as sessões
-
Falhas na resolução de variáveis dinâmicas: variáveis que não podem ser resolvidas serão substituídas por sequências vazias
-
Problemas de análise do UPID do SCTE-35: problemas com o processamento do UPID de segmentação podem causar falhas na resolução da variável da sessão.
Verificando a resolução da variável da sessão
Para verificar se as variáveis da sessão estão sendo resolvidas adequadamente:
-
Ative o registro de depuração para sua configuração MediaTailor
-
Verifique o grupo de
MediaTailor/AdDecisionServerInteractions
registros para ver a solicitação real do ADS URLs -
Verifique se todas as variáveis no URL do modelo foram substituídas por valores apropriados
-
Procure todas as variáveis que foram substituídas por strings vazias, o que pode indicar falhas na resolução
Exemplo de entrada de registro mostrando uma URL de solicitação de ADS resolvida:
{ "eventType": "MAKING_ADS_REQUEST", "sessionId": "abcd1234-5678-efgh-9012-ijklmnopqrst", "requestUrl": "https://my-ads-server.com/ads?sessionId=abcd1234-5678-efgh-9012-ijklmnopqrst&playerParams=mobile&deviceType=android&correlator=30000", "timestamp": "2025-06-20T19:00:00Z" }
Variáveis de análise e sessão SCTE-35 UPID
Problemas com o processamento UPID da segmentação SCTE-35 podem causar problemas nas variáveis da sessão:
-
Requisitos de formato: o UPID deve ter
segmentation_upid_type
12 e incluirformat_identifier
para um processamento adequado. -
Regras de análise: o UPID decodificado pode conter delimitadores de dois pontos para vários valores. O número de variáveis de modelo e tokens UPID decodificados deve ser igual.
-
Formatos inválidos: evite dois pontos duplos sem valores (por exemplo,
::
ou:46175218::4053
), pois eles causam falhas na análise. -
Manipulação do identificador de formato: MediaTailor presume que os primeiros quatro bytes sejam format_identifier. Se estiver ausente, private_data trunca os primeiros quatro bytes, potencialmente fazendo com que o ADS receba valores diferentes do esperado.
Consultas avançadas CloudWatch do Logs Insights
Use essas consultas especializadas do CloudWatch Logs Insights para solucionar detalhadamente os problemas de inserção de anúncios:
Encontrando a criatividade IDs
Para identificar o Creative a IDs partir dos eventos FILLED_AVAIL no ads_interaction_log:
fields @timestamp, sessionId, eventType | filter sessionId like /sessionId/ and eventType!='BEACON_FIRED' | sort @timestamp desc
nota
sessionId
Substitua pelo ID real da sessão que você está investigando.
Análise abrangente da sessão
Para uma análise detalhada do comportamento de inserção de anúncios em uma sessão específica:
fields @timestamp, sessionId, eventType, creativeId, skipReason, adBreakIndex | filter sessionId = "your-session-id-here" | filter eventType in ["FILLED_AVAIL", "SKIPPED_AVAIL", "MAKING_ADS_REQUEST"] | sort @timestamp asc | limit 100
NEW_CREATIVE pular análise
Para analisar padrões na omissão de anúncios do NEW_CREATIVE:
fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl | filter skipReason = "NEW_CREATIVE" | stats count() by creativeId, MediaFileSourceUrl | sort count desc | limit 50
Práticas recomendadas para evitar a omissão de anúncios
Implemente essas melhores práticas para minimizar os problemas de ignorar anúncios:
-
Implemente a pré-busca de anúncios: use o recurso MediaTailor de pré-busca do usuário para garantir que os anúncios sejam transcodificados antes da reprodução. Consulte Pré-busca de anúncios para obter detalhes de implementação.
-
Mantenha a criatividade consistente IDs: garanta que seu servidor de decisão de anúncios use criatividade consistente IDs para o mesmo conteúdo publicitário em todas as sessões.
-
Garanta a formatação adequada da duração: use valores inteiros para os parâmetros de EXT-X-CUE-OUT duração em vez do formato ISO 8601.
-
Configure a otimização de VOD: defina maxConcurrentAds solicitações para fluxos de VOD com vários intervalos publicitários para reduzir a carga do servidor.
-
Monitore padrões de transcodificação: monitore os CloudWatch registros para verificar a eficiência da transcodificação e entre em contato com o AWS Support
se você observar padrões que indiquem problemas de transcodificação. -
Verifique a consistência do ETAG: garanta que o arquivo URIs de mídia seja consistente para conteúdo idêntico para evitar uma retranscodificação desnecessária.
-
Implemente a solução de problemas sistemática: siga uma abordagem estruturada: identifique os motivos dos pulos, analise as causas-raiz, implemente resoluções e valide as correções.
-
Otimize o desempenho do ADS: configure seu servidor de decisão de anúncios para responder rapidamente e lidar com volumes de pico de tráfego.
-
Implemente o tratamento adequado de erros: configure o conteúdo do Slate para preencher intervalos publicitários quando os anúncios não puderem ser inseridos.
-
Monitore as métricas de inserção de anúncios: configure CloudWatch alarmes para detectar problemas de omissão de anúncios com antecedência.
-
Teste minuciosamente: valide seu fluxo de trabalho de inserção de anúncios em diferentes dispositivos e condições de rede.
-
Implemente estratégias alternativas: configure fontes de anúncios de backup ou anúncios padrão para quando as fontes de anúncios primárias falharem.
Recursos relacionados
Para obter mais informações sobre como solucionar problemas de omissão de anúncios, consulte estes tópicos relacionados:
-
MediaTailor variáveis de anúncios dinâmicas- Guia abrangente sobre variáveis dinâmicas de anúncios em MediaTailor
-
Pré-busca de anúncios- Como implementar a pré-busca de anúncios para evitar o salto relacionado à transcodificação
-
Monitoramento AWS Elemental MediaTailor com CloudWatch métricas da Amazon- Monitoramento MediaTailor com CloudWatch métricas
-
Visualizando AWS Elemental MediaTailor registros- Como visualizar e analisar MediaTailor registros
-
Solução de problemas de fluxo de MediaTailor eventos- Entendendo o fluxo de eventos de inserção de anúncios
-
Solução de problemas de fluxo de MediaTailor eventos- Técnicas avançadas de monitoramento e solução de problemas
-
Para obter mais informações sobre as diferenças que levam MediaTailor à retranscodificação de um anúncio, consulte a documentação da AWS sobre lógica de correspondência de variantes
-
Para solucionar problemas avançados de conteúdo publicitário, entre em contato com o AWS Support