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á.
# MediaTailor guia de solução de problemas para ignorar anúncios
Ignorar anúncios é um dos problemas mais comuns relatados MediaTailor pelos clientes. Este guia ajuda você a identificar problemas de ignorar anúncios e fornece procedimentos de step-by-step solução de problemas.
## Sintomas e impacto
Quando ocorre a omissão de anúncios, você pode observar os seguintes sintomas:
+ Os anúncios não aparecem durante os intervalos publicitários esperados
+ Os intervalos publicitários mostram 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
Ignorar anúncios afeta diretamente a receita e pode criar experiências ruins para os espectadores. Resolva esses problemas imediatamente para manter o desempenho ideal.
## Identificando os motivos 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 para ajudar você a identificar padrões.
**Topics**
+ [Sintomas](#ad-skipping-symptoms)
+ [Ignorar motivos](#identifying-skip-reasons)
+ [NEW\$1CREATIVE pulando](troubleshooting-new-creative-skipping.md)
+ [Ignorando o tempo limite do ADS](troubleshooting-ads-timeout-skipping.md)
+ [Ignorando a análise VAST](troubleshooting-vast-parsing-skipping.md)
+ [Ignorando a incompatibilidade de duração](troubleshooting-duration-mismatch-skipping.md)
+ [Ignorando a variável da sessão](troubleshooting-session-variables-skipping.md)
+ [Monitorando e pulando](monitoring-ad-skipping-issues.md)
+ [Melhores práticas de prevenção](preventing-ad-skipping-best-practices.md)
+ [Materiais de referência](ad-skipping-reference-materials.md)
# MediaTailor Solução de problemas com NEW\$1CREATIVE e ignorando anúncios
Quando os anúncios são ignorados com o `NEW_CREATIVE` motivo, AWS Elemental MediaTailor encontramos um anúncio que exige transcodificação antes da inserção. Este guia de solução de problemas explica as causas e fornece procedimentos step-by-step de resolução.
## O que faz com que NEW\$1CREATIVE pule
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). Quando qualquer parte do conjunto de variantes da ID criativa ou da transcodificação é diferente, MediaTailor reconhece o anúncio como uma nova variante que requer transcodificação.
### Alterações na taxa de bits
Alterações na taxa de bits podem fazer com que NEW\$1CREATIVE pule quando a taxa de bits não coincide após o arredondamento para os 8.000 bits mais próximos. Isso geralmente ocorre nas seguintes situações:
+ 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
#### Colete a variação da largura de banda do trabalho
Para trabalhos de colheita, MediaTailor usa um limite de variação de largura de banda de 15% ao combinar anúncios com fluxos de conteúdo. Se houver uma diferença de 15% ou mais entre a largura de banda da transmissão ao vivo e a largura de banda do arquivo HLS coletado, o anúncio será transcodificado novamente. Isso pode fazer com que NEW\$1CREATIVE seja ignorado durante o processo de transcodificação.
Esse comportamento geralmente ocorre quando:
+ Os mesmos anúncios pré-transcodificados são usados para streaming ao vivo e conteúdo VOD
+ O conteúdo coletado tem parâmetros de codificação diferentes dos da transmissão ao vivo original
+ As diferenças de largura de banda excedem o limite de 15% entre o conteúdo ao vivo e o conteúdo coletado
### 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\$1CREATIVE
1. Isso leva a uma tentativa desnecessária de transcodificação.
1. O criativo está marcado como DUPLICATE\$1TRANSCODE ou COPY\$1DEDUP
**nota**
MediaTailor não expira nem exclui anúncios transcodificados. Nós os armazenamos em um bucket S3 MediaTailor de propriedade indefinidamente.
## Etapas de resolução
Para resolver problemas de ignorar anúncios do NEW\$1CREATIVE:
1. Verifique se seu servidor de decisão de anúncios retorna conteúdo criativo consistente IDs para o mesmo conteúdo do anúncio.
1. Verifique se seu stream de conteúdo mantém taxas de bits e conjuntos de variantes consistentes.
1. Considere implementar a pré-busca de anúncios para garantir que os anúncios sejam transcodificados antes da reprodução. Para obter mais informações, consulte [Pré-busca de anúncios](prefetching-ads.md).
1. Para problemas persistentes, entre em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/) para obter assistência adicional na solução de problemas.
## Monitorando padrões NEW\$1CREATIVE
Use essa consulta do CloudWatch Logs Insights para analisar padrões na omissão de anúncios NEW\$1CREATIVE:
```
fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50
```
# MediaTailor Solução de problemas de tempo limite e salto do ADS
Quando os anúncios são ignorados por motivos relacionados, você tem problemas de conectividade ou desempenho com seu servidor de decisão de anúncios. `ADS_TIMEOUT` AWS Elemental MediaTailor requer comunicação confiável com seu ADS para inserir anúncios com sucesso. Este guia de solução de problemas explica como identificar e resolver esses problemas de conectividade.
## Problemas comuns de conectividade do ADS
Os problemas comuns de conectividade do ADS incluem o seguinte:
+ Servidor de decisão de anúncios não acessível a partir de MediaTailor
+ O ADS não está respondendo dentro do período de tempo limite configurado
+ O ADS não consegue lidar com o volume de solicitações durante os períodos de pico
+ Problemas de conectividade de rede entre MediaTailor e seu ADS
## Etapas de resolução
Para resolver problemas de tempo limite do ADS:
1. Verifique se seu servidor de decisão de anúncios está acessível a partir de MediaTailor.
1. Verifique se seu ADS responde dentro do período de tempo limite configurado.
1. Certifique-se de que seu ADS possa lidar com o volume de solicitações durante os períodos de pico.
1. Considere implementar uma estratégia de anúncios alternativos para quando seu ADS principal estiver indisponível.
## Monitorando o desempenho do AD
Configure CloudWatch alarmes para a `AdDecisionServer.Timeouts` métrica para detectar proativamente problemas de conectividade do ADS.
# MediaTailor VAST analisando e ignorando a solução de problemas
Quando os anúncios são ignorados com `VAST_PARSING_ERROR` ou`MEDIA_FILE_UNAVAILABLE`, você tem problemas com suas respostas VAST ou arquivos de mídia publicitária. AWS Elemental MediaTailor requer respostas VAST formatadas adequadamente e arquivos de mídia acessíveis para uma inserção bem-sucedida do anúncio. Este guia de solução de problemas explica como identificar e resolver esses problemas.
## Problemas comuns do VAST
Os problemas comuns do VAST incluem o seguinte:
+ Formato de resposta VAST não compatível com a especificação VAST
+ Arquivo de mídia URLs na resposta VAST não acessível publicamente
+ Caracteres especiais não codificados corretamente em VAST XML
+ Resposta VAST sem arquivos ou formatos de mídia necessários
## Etapas de resolução
Para resolver problemas de análise do VAST:
1. Valide seu formato de resposta VAST em relação à especificação VAST.
1. Certifique-se de que todos os arquivos de mídia URLs na resposta do VAST estejam acessíveis ao público.
1. Verifique a codificação adequada de caracteres especiais em seu XML VAST.
1. Verifique se sua resposta VAST inclui arquivos de mídia em formatos compatíveis com MediaTailor.
## Solução de problemas do VAST wrapper
Para problemas com `INVALID_VAST_WRAPPER_AD` ou`REJECTED_REPLICA_VAST`:
+ Valide as 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
+ Verifique a configuração do servidor de anúncios para políticas de detecção de conteúdo duplicado
+ Garanta que as respostas do VAST contenham conteúdo criativo exclusivo na mesma sessão
# MediaTailor incompatibilidade de duração e solução de problemas de salto
Quando os anúncios são ignorados por motivos relacionados ao formato ou por motivos relacionados ao formato, você tem problemas de compatibilidade de duração ou formato. `AVAIL_DURATION_EXCEEDED` `LEFTOVER_AVAIL_EXCEEDED_THRESHOLD` AWS Elemental MediaTailor requer formatação e correspondência adequadas da duração entre o conteúdo do anúncio e o tempo de intervalo disponível para o anúncio. Este guia de solução de problemas explica como identificar e resolver esses problemas relacionados à duração.
## Problemas comuns de duração
Os problemas comuns de duração incluem o seguinte:
+ Anúncios maiores do que a duração disponível do intervalo publicitário
+ Marcadores de intervalo de anúncio incorretos no conteúdo, sinalizando duração errada
+ Limite de personalização não atingido para inserção de anúncios
+ Formato de duração incorreto nas EXT-X-CUE-OUT tags
## Requisitos de formato 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 |
## Etapas de resolução
Para resolver problemas de incompatibilidade de duração:
1. Garanta que seu ADS retorne anúncios que se encaixem na duração do intervalo publicitário disponível.
1. Verifique se os marcadores de quebra de anúncio no conteúdo sinalizam corretamente a duração pretendida.
1. Verifique se os parâmetros de EXT-X-CUE-OUT duração usam o formato inteiro.
1. Considere ajustar o limite de personalização, se apropriado para seu caso de uso.
# MediaTailor variável de sessão e ignorando a solução de problemas
As variáveis de sessão desempenham um papel fundamental na segmentação e seleção de anúncios em AWS Elemental MediaTailor. A configuração incorreta da variável de sessão é uma causa comum de problemas de ignorar anúncios. Este guia abrangente de solução de problemas explica como identificar e resolver problemas de variáveis de sessão que podem impedir a inserção bem-sucedida de anúncios.
## Problemas comuns de variáveis de sessão
Os problemas comuns de variáveis de sessão incluem o seguinte:
+ **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 uma 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 dinâmica** de variáveis: variáveis que não podem ser resolvidas sã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 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
1. Verifique o grupo de `MediaTailor/AdDecisionServerInteractions` registros para ver a solicitação real do ADS URLs
1. Verifique se todas as variáveis no URL do modelo foram substituídas por valores apropriados
1. Procure todas as variáveis que foram substituídas por strings vazias, o que pode indicar falhas na resolução
## Solução de problemas de análise 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
# MediaTailor monitoramento e alertas de saltos de anúncios
O monitoramento proativo ajuda você a detectar e resolver problemas de ignorar anúncios antes que eles afetem significativamente sua receita. AWS Elemental MediaTailor fornece métricas abrangentes e recursos de registro que permitem o monitoramento eficaz do desempenho da inserção de anúncios. Este guia explica como configurar um monitoramento eficaz para problemas de ignorar anúncios.
## Principais CloudWatch métricas a serem monitoradas
Configure CloudWatch alarmes para essas MediaTailor métricas principais:
+ `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
## Consultas avançadas CloudWatch do Logs Insights
Use essas consultas especializadas para solucionar problemas detalhados:
### 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
```
### Encontrando a criatividade IDs
Para identificar o Creative a IDs partir dos eventos FILLED\$1AVAIL:
```
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.
# MediaTailor melhores práticas de prevenção de saltos de anúncios
A implementação dessas práticas recomendadas ajuda a evitar problemas de ignorar anúncios antes que eles ocorram, garantindo melhor desempenho de inserção de anúncios e proteção de receita com. AWS Elemental MediaTailor Essas medidas proativas abordam as causas mais comuns de pular anúncios e ajudam a manter a exibição consistente de anúncios.
## Medidas proativas
+ **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](prefetching-ads.md) 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 de anúncio 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 de anúncios para reduzir a carga do servidor
+ **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
## Diretrizes de implementação
+ **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
+ **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**
+ **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](https://aws.amazon.com/premiumsupport/) se você observar padrões que indiquem problemas de transcodificação
# MediaTailor guia de referência para ignorar anúncios
Esta seção fornece informações de referência abrangentes sobre os motivos de pular anúncios e links para a documentação relacionada do. AWS Elemental MediaTailor Use este guia de referência para entender os significados específicos dos diferentes motivos de omissão e encontrar recursos adicionais para solução de problemas.
## Referência completa de motivos para ignorar o anúncio
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.
**Motivos preenchidos e ignorados**
| Ignorar o motivo | Description |
| --- | --- |
| NEW\$1CREATIVE | 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\$1NOT\$1FOUND | O perfil de MediaConvert transcodificação associado à configuração da sessão não existe, impedindo a preparação do anúncio. |
| TRANSCODE\$1ERROR | O processo de transcodificação do anúncio encontrou um erro e não foi concluído. |
| TRANSCODE\$1IN\$1PROGRESS | A transcodificação do anúncio ainda está em andamento e ainda não está pronta para inserção. |
| INTERNAL\$1ERROR | Ocorreu um MediaTailor erro interno ao manusear o anúncio, impedindo a inserção. |
| AVAIL\$1DURATION\$1EXCEEDED | O anúncio não se encaixa na duração restante do intervalo publicitário. |
| LEFTOVER\$1AVAIL\$1EXCEEDED\$1THRESHOLD | 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\$1PARSING\$1ERROR | A resposta VAST do servidor de decisão do anúncio contém erros ou está mal formada. |
| ADS\$1TIMEOUT | O servidor de decisão do anúncio não respondeu dentro do período de tempo limite configurado. |
| MEDIA\$1FILE\$1UNAVAILABLE | Os arquivos de mídia publicitária especificados na resposta VAST não estão acessíveis. |
| SESSION\$1INITIALIZATION\$1FAILED | A MediaTailor sessão falhou ao inicializar corretamente, geralmente devido a variáveis de sessão incorretas. |
| EARLY\$1CUE\$1IN | 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\$1VARIANT\$1MATCH | 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\$1MODEL\$1CREATIVE\$1MATCH | O anúncio criativo não corresponde aos requisitos de modelo ou formato esperados para a configuração de reprodução atual. |
| REJECTED\$1REPLICA\$1VAST | A resposta do VAST foi rejeitada devido às políticas de detecção de conteúdo duplicado ou de réplicas. |
| INVALID\$1VAST\$1WRAPPER\$1AD | 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\$1ERROR | Ocorreu um erro durante o processo de importação do anúncio, impedindo que o anúncio fosse processado para inserção. |
| IMPORT\$1IN\$1PROGRESS | O processo de importação de anúncios está em andamento e ainda não foi concluído. |
## 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 dinâmicas de anúncios para solicitações de ADS](variables.md)- Guia abrangente sobre variáveis dinâmicas de anúncios em MediaTailor
+ [Pré-busca de anúncios](prefetching-ads.md)- 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](monitoring-cloudwatch-metrics.md)- Monitoramento MediaTailor com CloudWatch métricas
+ [Visualizando AWS Elemental MediaTailor registros](monitoring-through-logs.md)- Como visualizar e analisar MediaTailor registros
+ [Solução de problemas de fluxo de MediaTailor eventos](troubleshooting-event-flow.md)- Entendendo o fluxo de eventos de inserção de anúncios