View a markdown version of this page

Solución de problemas relacionados con el flujo de MediaTailor eventos - AWS Elemental MediaTailor
Flujos incompletosAnálisis de temporizaciónProblemas comunesPrácticas recomendadas de supervisiónRecursos adicionales

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Solución de problemas relacionados con el flujo de MediaTailor eventos

Comprender AWS Elemental MediaTailor el flujo de eventos proporciona una base sólida para solucionar problemas de inserción de anuncios. Al analizar la secuencia, el tiempo y los patrones de los eventos, puede identificar rápidamente dónde se producen los problemas e implementar soluciones específicas.

Esta sección proporciona una guía práctica para usar el análisis del flujo de eventos para diagnosticar problemas. Para comprender los conceptos básicos del flujo de eventos, consulteFlujo de eventos de inserción de anuncios.

Identificar los flujos de eventos incompletos

Los flujos de eventos incompletos se producen cuando la secuencia esperada de eventos se detiene antes de lograr una personalización satisfactoria del manifiesto (el proceso de MediaTailor insertar información publicitaria personalizada en el manifiesto). Identificar dónde se interrumpe el flujo ayuda a identificar la causa principal de los errores de inserción de anuncios.

Patrones de flujo incompletos comunes

Los diferentes puntos de falla en el flujo de eventos indican tipos específicos de problemas, como los siguientes.

  • El flujo se detiene después de detectar una oportunidad publicitaria: indica que hay problemas con los marcadores de anuncios o con el propio manifiesto que MediaTailor impiden realizar una solicitud de ADS. Pueden producirse problemas de conectividad, configuración o tiempo de espera de ADS después de realizar la solicitud de ADS.

  • El flujo se detiene después de una solicitud de ADS: sugiere problemas de respuesta de ADS, problemas de análisis de VAST, errores de procesamiento creativo, tiempos de espera de ADS, errores de conectividad o problemas de configuración, como URL de ADS no válidas que solo se descubren cuando se realiza la solicitud.

  • Indicador de seguimiento faltante: puede indicar problemas de configuración del seguimiento, problemas de generación de informes del lado del servidor o lagunas en la implementación del lado del cliente.

CloudWatch consultas para un análisis de flujo incompleto

Utilice estas consultas de Amazon CloudWatch Logs Insights para identificar los flujos de eventos incompletos. Ejecute estas consultas en los grupos de registros apropiados en función del tipo de análisis necesario.

Selección de grupos de registros:

  • MediaTailor/AdDecisionServerInteractions- Úselo para consultas que analicen las interacciones del servidor de decisiones publicitarias, las oportunidades publicitarias y ADS-related los errores.

  • MediaTailor/TranscodeService- Utilízalo para analizar los problemas en los que los anuncios no se insertaron debido a problemas de transcodificación, errores de procesamiento creativo u otros problemas no relacionados con los anuncios.

ejemplo identifique las oportunidades publicitarias sin que la personalización de los manifiestos tenga éxito

Grupo de registro: MediaTailor/AdDecisionServerInteractions

La siguiente consulta identifica las oportunidades publicitarias que no se han traducido en una personalización satisfactoria del manifiesto:

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
ejemplo analice las tasas de finalización del flujo de eventos

Grupo de registro: MediaTailor/AdDecisionServerInteractions

La siguiente consulta analiza las tasas de finalización en los 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
ejemplo busca sesiones en las que faltan eventos de baliza

Grupo de registro: MediaTailor/AdDecisionServerInteractions

La siguiente consulta identifica las sesiones que han agotado las reservas, pero no los correspondientes eventos de baliza:

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
ejemplo identifique los errores de inserción de anuncios relacionados con la transcodificación

Grupo de registro: MediaTailor/TranscodeService

La siguiente consulta identifica los problemas de transcodificación que impiden la inserción correcta de los anuncios:

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

Analizar los problemas de sincronización de los eventos

El análisis de la temporización de los eventos ayuda a identificar los cuellos de botella en el rendimiento y a optimizar los flujos de trabajo de inserción de anuncios. Los patrones temporales inusuales suelen indicar problemas subyacentes que afectan a la experiencia de los espectadores.

Umbrales de tiempo de rendimiento

Utilice estos umbrales de tiempo para identificar posibles problemas de rendimiento.

  • Duración total del flujo superior a 5 segundos: puede afectar a la experiencia de los espectadores y puede indicar problemas de rendimiento del ADS, problemas en el servidor de origen (como el tiempo de espera para recuperar los manifiestos) o problemas internos MediaTailor , como problemas de infraestructura con NAT Gateway, DynamoDB, EC2 u otros componentes del sistema.

  • Tiempo de respuesta de los ADS de más de 2 segundos: sugiere problemas de rendimiento de los ADS o problemas de latencia de la red.

  • La personalización del manifiesto dura más de 1 segundo: puede indicar retrasos en el procesamiento de la creatividad, problemas con el servidor de origen (como el tiempo de espera para recuperar los manifiestos) o problemas internos MediaTailor del sistema, como restricciones de infraestructura con NAT Gateway, DynamoDB, EC2 u otros componentes.

Análisis de tiempos

Utilice estas consultas para analizar los patrones de temporización de los eventos.

ejemplo mida la duración total del flujo de eventos

La siguiente consulta mide la duración total de los flujos de eventos e identifica los que superan los 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
ejemplo analiza el tiempo de respuesta de ADS

La siguiente consulta analiza los tiempos de respuesta del ADS e identifica los que superan los 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
ejemplo identifica la personalización lenta de los manifiestos

La siguiente consulta identifica los procesos de personalización de manifiestos que tardan más 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 y soluciones comunes del flujo de eventos

En esta sección se proporcionan soluciones para los problemas frecuentes relacionados con el flujo de eventos, organizadas por tipo de problema y síntomas.

Errores en las solicitudes del servidor de decisiones publicitarias

Síntomas: el flujo de eventos se detiene después de detectar una oportunidad publicitaria. No se registró ningún evento de solicitud de ADS.

Causas y soluciones comunes

  • Errores de configuración de la URL del ADS: compruebe que la URL del ADS de su configuración de reproducción sea correcta y accesible. En el registro de interacciones con los anuncios, verás un evento de solicitud de ADS (MAKING_ADS_REQUEST) pero no la correspondiente respuesta de VAST, que suele ir acompañada de un evento de error ERROR_UNKNOWN o similar.

  • Problemas de conectividad de red: comprueba la conectividad de red entre tu ADS MediaTailor y tu ADS, incluidas las reglas de firewall y la resolución de DNS.

  • SSL/TLS problemas con los certificados: asegúrese de que su ADS utilice certificados SSL válidos de una autoridad de certificación de confianza. En el caso específico de Google Ad Manager, es posible que tengas que ponerte en contacto con AWS Support para habilitar un indicador de configuración que acepte los certificados SSL de Google.

Consulta de diagnóstico

La siguiente consulta ayuda a diagnosticar los errores en las solicitudes de ADS mediante el seguimiento de la secuencia 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

Fallos de respuesta del servidor de decisiones publicitarias

Síntomas: las solicitudes de ADS se realizan correctamente pero MediaTailor no reciben respuesta o se producen errores de análisis.

Causas y soluciones comunes

  • Formato VAST no válido: valide sus respuestas a ADS VAST comparándolas con los estándares de especificación VAST.

  • Problemas de tiempo de espera de los ADS: aumenta la configuración del tiempo de espera de los ADS u optimiza el tiempo de respuesta de los ADS.

  • Inventario de anuncios vacío: comprueba la disponibilidad del inventario de anuncios y los criterios de segmentación en tu configuración de ADS.

Consulta de diagnóstico

La siguiente consulta ayuda a diagnosticar los errores de respuesta del ADS mediante el examen de los eventos de solicitud y respuesta:

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

Fallos de personalización manifiestos

Síntomas: se reciben respuestas de VAST, pero se produce un error en la personalización del manifiesto o se omiten los anuncios.

Causas y soluciones comunes:

  • Problemas de transcodificación creativa: comprueba si el anuncio es un NEW_CREATIVE anuncio que requiere la transcodificación antes de insertarlo. También puedes comprobar si hay errores de transcodificación examinando el MediaTailor/TranscodeService registro en busca de eventos de error comoINTERNAL_ERROR, por ejemplo, o. MISSING_VARIANTS, PROFILE_NOT_FOUND

  • Problemas de falta de coincidencia en la duración de los anuncios: comprueba que la duración de los anuncios se ajusta a la duración de las pausas publicitarias disponibles.

  • Problemas con los umbrales de personalización: revisa la configuración del umbral de personalización en la configuración de reproducción.

Consulta de diagnóstico

La siguiente consulta ayuda a diagnosticar los errores manifiestos de personalización al examinar las respuestas de VAST y los vales completados:

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

Consulta sobre los motivos por los que se omitieron los anuncios

La siguiente consulta proporciona información detallada sobre los motivos por los que se omitieron los anuncios:

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 los motivos por los que se omitieron los anuncios y los ID únicos de las creatividades

La siguiente consulta proporciona información detallada sobre los anuncios omitidos, incluidos los motivos y los identificadores únicos de la creatividad de los dos primeros anuncios de cada uno de los anuncios disponibles:

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

Fallos de rastreo de balizas

Síntomas: la personalización del manifiesto se realizó correctamente, pero faltaron balizas de seguimiento o no se realizaron correctamente.

Causas y soluciones comunes

  • Client-side Problemas de implementación: La mayoría de los problemas relacionados con el seguimiento de las balizas se deben a problemas de implementación por parte del cliente, como no sondear las URL de seguimiento con la suficiente frecuencia para rastrearlas por parte del cliente o a problemas de lógica de activación de balizas específicos de los jugadores.

  • Problemas de accesibilidad de las URL: comprueba que las URL de seguimiento de las respuestas VAST sean accesibles y devuelvan las respuestas adecuadas. Pueden producirse problemas cuando no se puede acceder a las URL o cuando MediaTailor se producen problemas internos que impiden el seguimiento correcto de la entrega de las respuestas.

  • Problemas con las solicitudes de segmentos de jugadores: pueden producirse aparentes fallos en la baliza de seguimiento cuando el reproductor cliente no solicita ningún segmento. Esto provoca que no se envíen balizas, lo que parece ser un error de seguimiento, pero en realidad se debe a un problema de implementación del jugador, más que a un problema de baliza.

Consulta de diagnóstico

La siguiente consulta ayuda a diagnosticar los fallos de seguimiento de las balizas mediante el examen de las reservas y los eventos de baliza rellenados:

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

Mejores prácticas para monitorear el flujo de eventos

Implemente estas prácticas de monitoreo para identificar y resolver de manera proactiva los problemas del flujo de eventos:

Configuración de alarmas CloudWatch

Cree CloudWatch alarmas de Amazon para supervisar las métricas clave del flujo de eventos.

  • Alarma del índice de finalización del flujo: alerta cuando la proporción entre la personalización exitosa de los manifiestos y las oportunidades de anuncios cae por debajo de los umbrales aceptables.

  • Alarma de tiempo de respuesta de los ADS: supervise los tiempos medios de respuesta de los ADS y avise cuando superen los umbrales de rendimiento.

  • Alarma de índice de errores: realiza un seguimiento de la frecuencia de los eventos de error y alerta cuando se produzcan picos inusuales en tipos de error específicos.

Consultas de supervisión periódicas

Ejecute estas consultas con regularidad para mantener la visibilidad del estado del flujo de eventos:

ejemplo tasa de éxito del flujo de eventos diario

La siguiente consulta proporciona un resumen diario de las tasas de éxito del flujo 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
ejemplo tendencia de la tasa de errores por hora

La siguiente consulta registra las tasas de error por hora para identificar los problemas más actuales:

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

Guía de optimización del rendimiento

Usa el análisis del flujo de eventos para optimizar el rendimiento de la inserción de anuncios.

  • Optimización de anuncios: colabore con su proveedor de anuncios para optimizar los tiempos de respuesta y reducir la latencia.

  • Preparación creativa: creatividades Pre-transcode publicitarias que se adapten a tus perfiles de contenido y reduzcan los retrasos en el procesamiento.

  • Ajuste de la configuración: ajuste la configuración del tiempo de espera, los umbrales de personalización y otros parámetros de configuración en función del análisis del flujo de eventos.

Recursos adicionales de solución de problemas

Para obtener más información sobre la solución de problemas más allá del análisis del flujo de eventos: