Solução de problemas de fluxo de MediaTailor eventos - AWS Elemental MediaTailor
Fluxos incompletosAnálise de temporizaçãoProblemas comunsMelhores práticas de monitoramentoRecursos adicionais

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

Solução de problemas de fluxo de MediaTailor eventos

Compreender o fluxo de AWS Elemental MediaTailor eventos fornece uma base poderosa para solucionar problemas de inserção de anúncios. Ao analisar a sequência, o tempo e os padrões dos eventos, você pode identificar rapidamente onde os problemas ocorrem e implementar soluções específicas.

Esta seção fornece orientação prática para o uso da análise de fluxo de eventos para diagnosticar problemas. Para entender os conceitos básicos de fluxo de eventos, consulteFluxo de eventos de inserção de anúncios.

Identificação de fluxos de eventos incompletos

Fluxos de eventos incompletos ocorrem quando a sequência esperada de eventos é interrompida antes de alcançar a personalização bem-sucedida do manifesto (o processo de MediaTailor inserir informações personalizadas do anúncio no manifesto). Identificar onde o fluxo é interrompido ajuda a identificar a causa raiz das falhas na inserção de anúncios.

Padrões comuns de fluxo incompletos

Pontos de falha diferentes no fluxo de eventos indicam tipos específicos de problemas, como os seguintes.

  • O fluxo é interrompido após a detecção da oportunidade de anúncio: indica problemas com os marcadores do anúncio ou com o próprio manifesto que MediaTailor impedem a realização de uma solicitação de ADS. Problemas de conectividade, configuração ou tempo limite do ADS ocorreriam após a solicitação do ADS ser feita.

  • O fluxo é interrompido após a solicitação do ADS: sugere problemas de resposta do ADS, problemas de análise do VAST, falhas no processamento criativo, tempos limite do ADS, erros de conectividade ou problemas de configuração, como ADS inválidos, URLs que só são descobertos quando a solicitação é feita.

  • Sinalizador de rastreamento ausente: pode indicar problemas de configuração de rastreamento, problemas de relatórios do lado do servidor ou lacunas na implementação do lado do cliente.

CloudWatch consultas para análise de fluxo incompleta

Use essas consultas do Amazon CloudWatch Logs Insights para identificar fluxos de eventos incompletos. Execute essas consultas nos grupos de registros apropriados com base no tipo de análise necessária.

Seleção do grupo de registros:

  • MediaTailor/AdDecisionServerInteractions- Use para consultas que analisam interações do servidor de decisão de anúncios, oportunidades de anúncios e falhas relacionadas ao AD.

  • MediaTailor/TranscodeService- Use para analisar problemas em que os anúncios não foram inseridos devido a problemas de transcodificação, falhas no processamento criativo ou outros problemas não relacionados a anúncios.

exemplo identifique oportunidades de anúncios sem uma personalização bem-sucedida do manifesto

Grupo de registros: MediaTailor/AdDecisionServerInteractions

A consulta a seguir identifica oportunidades de anúncios que não resultaram na personalização bem-sucedida do manifesto:

fields @timestamp, eventType, avail.availId, sessionId
| filter eventType = "AD_MARKER_FOUND"
| stats count() as total_opportunities by avail.availId
| join (
    fields @timestamp, eventType, avail.availId
    | filter eventType = "FILLED_AVAIL"
    | stats count() as successful_fills by avail.availId
) on avail.availId
| where ispresent(total_opportunities) and not ispresent(successful_fills)
| sort total_opportunities desc
exemplo analisar as taxas de conclusão do fluxo de eventos

Grupo de registros: MediaTailor/AdDecisionServerInteractions

A consulta a seguir analisa as taxas de conclusão em diferentes tipos de eventos:

fields @timestamp, eventType, avail.availId
| filter eventType in ["AD_MARKER_FOUND", "MAKING_ADS_REQUEST", "VAST_RESPONSE", "FILLED_AVAIL", "BEACON_FIRED"]
| stats count() by eventType, avail.availId
| sort avail.availId, eventType
exemplo encontre sessões com eventos de beacon ausentes

Grupo de registros: MediaTailor/AdDecisionServerInteractions

A consulta a seguir identifica sessões que preencheram os avais, mas nenhum evento de beacon correspondente:

fields @timestamp, eventType, sessionId, avail.availId
| filter eventType = "FILLED_AVAIL"
| stats count() as filled_avails by sessionId
| join (
    fields @timestamp, eventType, sessionId
    | filter eventType = "BEACON_FIRED"
    | stats count() as beacon_events by sessionId
) on sessionId
| where filled_avails > 0 and (not ispresent(beacon_events) or beacon_events = 0)
| sort filled_avails desc
exemplo identificar falhas de inserção e transcodificação

Grupo de registros: MediaTailor/TranscodeService

A consulta a seguir identifica problemas de transcodificação que impedem a inserção bem-sucedida do anúncio:

fields @timestamp, eventType, sessionId, requestId
| filter eventType in ["TRANSCODE_IN_PROGRESS", "INTERNAL_ERROR", "MISSING_VARIANTS", "PROFILE_NOT_FOUND"]
| stats count() as transcode_issues by eventType, sessionId
| sort transcode_issues desc

Análise de problemas de cronometragem de eventos

A análise do tempo de eventos ajuda a identificar gargalos de desempenho e otimizar os fluxos de trabalho de inserção de anúncios. Padrões de tempo incomuns geralmente indicam problemas subjacentes que afetam a experiência do espectador.

Limites de tempo de desempenho

Use esses limites de tempo para identificar possíveis problemas de desempenho.

  • Duração total do fluxo de mais de 5 segundos: pode afetar a experiência do espectador e pode indicar problemas de desempenho do ADS, problemas no servidor de origem (como tempos limite de recuperação de manifestos) ou problemas internos, incluindo MediaTailor problemas de infraestrutura com o NAT Gateway, o DynamoDB ou outros componentes do sistema. EC2

  • Tempo de resposta do ADS superior a 2 segundos: sugere problemas de desempenho do ADS ou problemas de latência da rede.

  • Personalização do manifesto por mais de 1 segundo: pode indicar atrasos no processamento criativo, problemas no servidor de origem (como tempos limite de recuperação do manifesto) ou problemas internos do MediaTailor sistema, incluindo restrições de infraestrutura com o NAT Gateway, o DynamoDB ou outros componentes. EC2

Consultas de análise de tempo

Use essas consultas para analisar os padrões de temporização de eventos.

exemplo medir a duração total do fluxo de eventos

A consulta a seguir mede a duração total dos fluxos de eventos e identifica aqueles que excedem 5 segundos:

fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["AD_MARKER_FOUND", "FILLED_AVAIL"]
| sort @timestamp asc
| stats min(@timestamp) as start_time, max(@timestamp) as end_time by avail.availId
| eval duration_seconds = (end_time - start_time) / 1000
| where duration_seconds > 5
exemplo analise o tempo de resposta do ADS

A consulta a seguir analisa os tempos de resposta do ADS e identifica aqueles que excedem 2 segundos:

fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["MAKING_ADS_REQUEST", "VAST_RESPONSE"]
| sort @timestamp asc
| stats min(@timestamp) as request_time, max(@timestamp) as response_time by avail.availId
| eval ads_response_seconds = (response_time - request_time) / 1000
| where ads_response_seconds > 2
exemplo identifique a personalização lenta do manifesto

A consulta a seguir identifica processos de personalização de manifestos que levam mais de 1 segundo:

fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["VAST_RESPONSE", "FILLED_AVAIL"]
| sort @timestamp asc
| stats min(@timestamp) as response_time, max(@timestamp) as filled_time by avail.availId
| eval personalization_seconds = (filled_time - response_time) / 1000
| where personalization_seconds > 1

Problemas e soluções comuns de fluxo de eventos

Esta seção fornece soluções para problemas de fluxo de eventos frequentemente encontrados, organizados por tipo de problema e sintomas.

Falhas na solicitação do servidor de decisão de anúncios

Sintomas: o fluxo de eventos é interrompido após a detecção da oportunidade de anúncio. Nenhum evento de solicitação de ADS registrado.

Causas e soluções comuns

  • Erros de configuração do URL do ADS: verifique se o URL do ADS na sua configuração de reprodução está correto e acessível. No registro de interação com anúncios, você verá um evento de solicitação do ADS (MAKING_ADS_REQUEST), mas nenhuma resposta VAST correspondente, geralmente acompanhada por um evento de erro ERROR_UNKNOWN ou similar.

  • Problemas de conectividade de rede: verifique a conectividade de rede entre MediaTailor e seu ADS, incluindo regras de firewall e resolução de DNS.

  • Problemas com certificados SSL/TLS: certifique-se de que seu ADS use certificados SSL válidos de uma autoridade de certificação confiável. Especificamente para o Google Ad Manager, talvez seja necessário entrar em contato com o AWS Support para ativar um sinalizador de configuração que aceite os certificados SSL do Google.

Consulta de diagnóstico

A consulta a seguir ajuda a diagnosticar falhas na solicitação do ADS rastreando a sequência de eventos:

fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["AD_MARKER_FOUND", "MAKING_ADS_REQUEST", "ERROR_ADS_IO", "ERROR_UNKNOWN_HOST"]
| sort @timestamp asc

Falhas de resposta do servidor de decisão de anúncios

Sintomas: as solicitações do ADS são bem-sucedidas, mas MediaTailor não recebem uma resposta, ou ocorrem erros de análise.

Causas e soluções comuns

  • Formato VAST inválido: valide suas respostas do ADS VAST em relação aos padrões de especificação VAST.

  • Problemas de tempo limite do ADS: aumente as configurações de tempo limite do ADS ou otimize o tempo de resposta do ADS.

  • Inventário de anúncios vazio: verifique a disponibilidade do inventário de anúncios e os critérios de segmentação na sua configuração do ADS.

Consulta de diagnóstico

A consulta a seguir ajuda a diagnosticar falhas de resposta do ADS examinando eventos de solicitação e resposta:

fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["MAKING_ADS_REQUEST", "VAST_RESPONSE", "EMPTY_VAST_RESPONSE", "ERROR_ADS_RESPONSE_PARSE", "ERROR_ADS_TIMEOUT"]
| sort @timestamp asc

Falhas manifestas de personalização

Sintomas: respostas VAST recebidas, mas a personalização manifesta falha ou os anúncios são ignorados.

Causas e soluções comuns:

  • Problemas de transcodificação criativa: verifique se o anúncio é um NEW_CREATIVE, o que requer transcodificação antes da inserção. Você também pode verificar se há erros de transcodificação examinando o MediaTailor/TranscodeService registro em busca de eventos de erro, como INTERNAL_ERROR ou. MISSING_VARIANTS, PROFILE_NOT_FOUND

  • Problemas de incompatibilidade de duração: verifique se as durações dos anúncios se encaixam nas durações de intervalos disponíveis.

  • Problemas de limite de personalização: revise as configurações de limite de personalização em sua configuração de reprodução.

Consulta de diagnóstico

A consulta a seguir ajuda a diagnosticar falhas manifestas de personalização examinando respostas VAST e disponibilidades preenchidas:

fields @timestamp, eventType, sessionId, skippedAds
| filter sessionId = "your-session-id"
| filter eventType in ["VAST_RESPONSE", "FILLED_AVAIL", "WARNING_NO_ADVERTISEMENTS"]
| sort @timestamp asc

Consulta por motivos de ignoração do anúncio

A consulta a seguir fornece informações detalhadas sobre por que os anúncios foram ignorados:

fields @timestamp, eventType, sessionId, skippedAds.reason, skippedAds.creativeUniqueId
| filter sessionId = "your-session-id"
| filter eventType = "WARNING_NO_ADVERTISEMENTS" or ispresent(skippedAds)
| sort @timestamp asc

Consulta por motivos de ignoração do anúncio e por motivos criativos exclusivos IDs

A consulta a seguir fornece informações detalhadas sobre anúncios ignorados, incluindo motivos e criativos exclusivos IDs para os dois primeiros anúncios em cada disponibilidade:

fields @timestamp, eventType
| filter sessionId = "your-session-id"
| filter eventType = "FILLED_AVAIL"
| fields avail.skippedAds.0.vastDuration as SkippedDur_Ad0, avail.skippedAds.0.skippedReason as Ad0_SkipReason, avail.skippedAds.0.creativeUniqueId as SkippedCreative0_UID
| fields avail.skippedAds.1.vastDuration as SkippedDur_Ad1, avail.skippedAds.1.skippedReason as Ad1_SkipReason, avail.skippedAds.1.creativeUniqueId as SkippedCreative1_UID
| sort @timestamp desc

Rastreando falhas de farol

Sintomas: Personalização bem-sucedida do manifesto, mas beacons de rastreamento ausentes ou com falha.

Causas e soluções comuns

  • Problemas de implementação do lado do cliente: a maioria dos problemas de beacon de rastreamento decorre de problemas de implementação do lado do cliente, como a falta de rastreamento de pesquisas URLs com frequência suficiente para o rastreamento do lado do cliente ou problemas de lógica de disparo de beacon específicos do jogador.

  • Problemas de acessibilidade do URL de rastreamento: verifique se o rastreamento URLs nas respostas do VAST está acessível e retorne as respostas apropriadas. Os problemas podem ocorrer quando não URLs estão acessíveis ou quando há problemas internos que impedem o MediaTailor rastreamento bem-sucedido da entrega da resposta.

  • Problemas na solicitação do segmento do player: falhas aparentes do farol de rastreamento podem ocorrer quando o player cliente não solicita realmente nenhum segmento. Isso faz com que nenhum beacon seja enviado, o que parece uma falha de rastreamento, mas na verdade é um problema de implementação do jogador e não um problema de beacon.

Consulta de diagnóstico

A consulta a seguir ajuda a diagnosticar falhas de beacon de rastreamento examinando disponibilidades preenchidas e eventos de beacon:

fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["FILLED_AVAIL", "BEACON_FIRED", "ERROR_FIRING_BEACON_FAILED"]
| sort @timestamp asc

Melhores práticas de monitoramento de fluxo de eventos

Implemente essas práticas de monitoramento para identificar e resolver proativamente problemas de fluxo de eventos:

Configurando CloudWatch alarmes

Crie CloudWatch alarmes da Amazon para monitorar as principais métricas de fluxo de eventos.

  • Alarme de taxa de conclusão de fluxo: alerta quando a proporção entre a personalização bem-sucedida do manifesto e as oportunidades de anúncios cair abaixo dos limites aceitáveis.

  • Alarme de tempo de resposta do ADS: monitore os tempos médios de resposta do ADS e alerte quando eles excederem os limites de desempenho.

  • Alarme de taxa de erro: rastreie as frequências de eventos de erro e alerte sobre picos incomuns em tipos de erro específicos.

Consultas regulares de monitoramento

Execute essas consultas regularmente para manter a visibilidade da integridade do fluxo de eventos:

exemplo taxa de sucesso do fluxo diário de eventos

A consulta a seguir fornece uma visão geral diária das taxas de sucesso do fluxo de eventos por tipo de evento:

fields @timestamp, eventType
| filter @timestamp > datefloor(@timestamp, 1d)
| stats count() as total_events by eventType
| sort total_events desc
exemplo tendência da taxa de erro por hora

A consulta a seguir rastreia as taxas de erro por hora para identificar problemas populares:

fields @timestamp, eventType
| filter eventType like /ERROR_/
| stats count() as error_count by datefloor(@timestamp, 1h) as hour
| sort hour desc

Orientação de otimização de desempenho

Use a análise de fluxo de eventos para otimizar o desempenho da inserção de anúncios.

  • Otimização de ADS: trabalhe com seu provedor de ADS para otimizar os tempos de resposta e reduzir a latência.

  • Preparação criativa: pré-transcodifique os anúncios de acordo com seus perfis de conteúdo e reduza os atrasos no processamento.

  • Ajuste de configuração: ajuste as configurações de tempo limite, limites de personalização e outros parâmetros de configuração com base na análise do fluxo de eventos.

Recursos adicionais para solução de problemas

Para obter orientação adicional sobre solução de problemas além da análise do fluxo de eventos: