Solucionando problemas e pulando de MediaTailor - AWS Elemental MediaTailor

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.

Motivos comuns para ignorar anúncios
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:

  1. 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.

  2. 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]
  3. 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.

    1. Verifique se seu servidor de decisão de anúncio está retornando uma criatividade consistente IDs para o mesmo conteúdo do anúncio

    2. Verifique se seu stream de conteúdo mantém taxas de bits e conjuntos de variantes consistentes

    3. 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

    4. Para problemas persistentes, entre em contato com o AWS Support para obter assistência adicional na solução de problemas

  4. 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

  5. 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

  6. 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

  7. 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.

  8. Resolver problemas de correspondência e formato de variantes

    Se os anúncios estiverem sendo ignorados por motivos relacionados aNO_VARIANT_MATCH, NO_MODEL_CREATIVE_MATCHEARLY_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.

  9. Resolva problemas de invólucro e importação do VAST

    Se os anúncios estiverem sendo ignorados comREJECTED_REPLICA_VAST,, INVALID_VAST_WRAPPER_ADIMPORT_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_ERROReIMPORT_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:

  1. O anúncio é ignorado pelo motivo NEW_CREATIVE

  2. Isso leva a uma tentativa desnecessária de transcodificação.

  3. 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.

Requisitos de formato de duração
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:

  1. Verifique o formato do marcador de anúncio nos CloudWatch registros em eventos AD_MARKER_FOUND

  2. Procure motivos para FORMAT_ERROR pular em eventos FILLED_AVAIL

  3. Verifique se os valores de duração em seu manifesto de conteúdo usam formatos compatíveis

  4. 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:

  1. Ative o registro de depuração para sua configuração MediaTailor

  2. Verifique o grupo de MediaTailor/AdDecisionServerInteractions registros para ver a solicitação real do ADS URLs

  3. Verifique se todas as variáveis no URL do modelo foram substituídas por valores apropriados

  4. 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 incluir format_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

sessionIdSubstitua 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.

Para obter mais informações sobre como solucionar problemas de omissão de anúncios, consulte estes tópicos relacionados: