Solución de problemas de 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, puedes identificar rápidamente dónde se producen los problemas e implementar soluciones específicas.

Esta sección proporciona una guía práctica para utilizar 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.

Identificación de flujos de eventos incompletos

Los flujos de eventos incompletos se producen cuando la secuencia de eventos esperada se detiene antes de lograr una personalización correcta 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 raíz 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 tras detectar una oportunidad publicitaria: indica problemas con los marcadores de anuncios o con el propio manifiesto que MediaTailor impiden realizar una solicitud de ADS. Se podrían producir problemas de conectividad, configuración o tiempo de espera del 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 en el procesamiento de las creatividades, tiempos de espera de ADS, errores de conectividad o problemas de configuración, como un ADS no válido URLs que solo se descubre al realizar la solicitud.

• Falta un indicador de seguimiento: podría indicar problemas de configuración del seguimiento, problemas de notificación por parte del servidor o deficiencias en la implementación por parte del cliente.

CloudWatch consultas para un análisis de flujo incompleto

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

Selección de grupos de registros:

• MediaTailor/AdDecisionServerInteractions- Se utiliza para consultas que analizan las interacciones entre los servidores de decisiones publicitarias, las oportunidades de anuncios y los errores relacionados con ADS.

• MediaTailor/TranscodeService- Se utiliza para analizar problemas en los que no se insertaron anuncios debido a problemas de transcodificación, errores en el procesamiento de las creatividades u otros problemas no relacionados con la publicidad.

ejemplo Identifica oportunidades de anuncios sin una personalización correcta de los manifiestos

Grupo de registros: MediaTailor/AdDecisionServerInteractions

La siguiente consulta identifica las oportunidades de anuncios que no se tradujeron en una personalización correcta 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 analiza las tasas de finalización del flujo de eventos

Grupo de registros: MediaTailor/AdDecisionServerInteractions

La siguiente consulta analiza las tasas de finalización de los distintos 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 falten eventos de baliza

Grupo de registros: MediaTailor/AdDecisionServerInteractions

La siguiente consulta identifica las sesiones en las que se han agotado los valores disponibles pero no se han registrado los eventos de baliza correspondientes:

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

Grupo de registros:/ MediaTailorTranscodeService

La siguiente consulta identifica los problemas de transcodificación que impiden que el anuncio se inserte correctamente:

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 de tiempo inusuales suelen indicar problemas subyacentes que afectan a la experiencia del espectador.

Umbrales de temporización del 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 del espectador y puede indicar problemas de rendimiento de ADS, problemas con el servidor de origen (como tiempos de espera para recuperar los manifiestos) o problemas internos MediaTailor , como problemas de infraestructura con NAT Gateway, EC2 DynamoDB u otros componentes del sistema.

• Tiempo de respuesta de ADS superior a 2 segundos: sugiere problemas de rendimiento de ADS o problemas de latencia de la red.

• Personalización de manifiestos de más de 1 segundo: puede indicar retrasos en el procesamiento de las creatividades, problemas con el servidor de origen (como tiempos de espera para la recuperación de manifiestos) o problemas internos MediaTailor del sistema, incluidas las limitaciones de infraestructura con NAT Gateway, DynamoDB u otros componentes. EC2

Sincronización de consultas de análisis

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 de 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 del manifiesto 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

Esta sección proporciona soluciones para los problemas de flujo de eventos más frecuentes, organizados por tipo de problema y síntomas.

Fallos en las solicitudes del servidor de decisiones publicitarias

Síntomas: el flujo de eventos se detiene tras la detección de una oportunidad publicitaria. No se registraron eventos de solicitud de ADS.

Causas y soluciones comunes

• Errores de configuración de la URL de ADS: compruebe que la URL de ADS de su configuración de reproducción sea correcta y accesible. En el registro de interacciones de los anuncios, verás un evento de solicitud de ADS (MAKING_ADS_REQUEST), pero no la respuesta de VAST correspondiente, que suele ir acompañada de un 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 del firewall y la resolución del DNS.

• Problemas con los certificados SSL/TLS: 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 tenga que ponerse en contacto con AWS Support para activar 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 de ADS VAST según los estándares de especificación VAST.

• Problemas de tiempo de espera de ADS: aumenta la configuración de tiempo de espera de ADS u optimiza el tiempo de respuesta de 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 de manifiestos

Síntomas: se han recibido respuestas de VAST, pero se ha producido 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 una transcodificación antes de insertarlo. También puedes comprobar si hay errores de transcodificación examinando el MediaTailor/TranscodeService registro para detectar errores comoINTERNAL_ERROR, por ejemplo, o. MISSING_VARIANTS, PROFILE_NOT_FOUND

• Problemas de discordancia de duración: comprueba que las duraciones de los anuncios se ajusten a las duraciones de pausas publicitarias disponibles.

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

Consulta de diagnóstico

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

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 anuncios omitidos

La siguiente consulta proporciona información detallada sobre por qué 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 ha omitido el anuncio y la creatividad es única IDs

En la siguiente consulta, se proporciona información detallada sobre los anuncios omitidos, incluidos los motivos y la creatividad exclusiva IDs de los dos primeros anuncios de cada publicación:

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 las fallas de

Síntomas: la personalización del manifiesto se ha realizado correctamente, pero faltan balizas de seguimiento o han fallado.

Causas y soluciones comunes

• Problemas de implementación en el lado del cliente: la mayoría de los problemas de las balizas de seguimiento se deben a problemas de implementación en el lado del cliente, como la falta de seguimiento de las encuestas con la URLs frecuencia suficiente para el seguimiento del lado del cliente o a problemas de lógica de activación de balizas específicas del jugador.

• Problemas de accesibilidad a las URL de seguimiento: compruebe que las respuestas de seguimiento de VAST son accesibles y URLs devuelva las respuestas adecuadas. Los problemas se pueden producir cuando no URLs se puede contactar con ellos o cuando surgen problemas internos MediaTailor que impidan la entrega correcta de las respuestas de rastreo.

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

Consulta de diagnóstico

La siguiente consulta ayuda a diagnosticar los errores de las balizas de seguimiento mediante el examen de las validaciones agotadas y los eventos de baliza:

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 de monitoreo del flujo de eventos

Implemente estas prácticas de supervisión para identificar y resolver de forma proactiva los problemas de flujo de eventos:

Configuración de alarmas CloudWatch

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

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

• Alarma de tiempo de respuesta de ADS: monitorea los tiempos de respuesta promedio de ADS y alerta cuando superen los umbrales de rendimiento.

• Alarma de tasa de error: rastrea las frecuencias de los eventos de error y alerta sobre picos inusuales en tipos de error específicos.

Consultas de monitoreo 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 error por hora

La siguiente consulta hace un seguimiento de las tasas de error por hora para identificar las tendencias de los problemas:

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

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

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

• Preparación creativa: transcodifique previamente las creatividades publicitarias para que se ajusten a sus perfiles de contenido y reduzca los retrasos en el procesamiento.

• Ajuste de la configuración: ajuste los ajustes de 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 orientación adicional sobre la solución de problemas más allá del análisis del flujo de eventos:

• Para obtener información detallada sobre el formato de registro y las especificaciones técnicas, consulteVisualización de registros.

• Para obtener una solución integral de problemas comunes de inserción de anuncios, consulteSolución de problemas comunes de .

• Para obtener instrucciones sobre la configuración de la supervisión y las alertas, consulteMonitorización AWS Elemental MediaTailor con CloudWatch métricas de Amazon.

• Para conocer los procedimientos de registro de depuración, consulte. Generar registros de depuración