Solucionar problemas y saltarse desde MediaTailor - AWS Elemental MediaTailor
SíntomasCausasPasos para la solución de problemasVariables de sesiónConsultas avanzadasPrácticas recomendadasRecursos relacionados

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.

Solucionar problemas y saltarse desde MediaTailor

La omisión de anuncios es uno de los problemas más comunes reportados por MediaTailor los clientes. En esta sección se ofrece un análisis detallado de los motivos por los que se pueden omitir los anuncios durante la reproducción y se ofrecen soluciones para garantizar una inserción adecuada de los anuncios.

Síntomas e impacto

Cuando se omite un anuncio, es posible que observe los siguientes síntomas:

  • Los anuncios no aparecen durante las pausas publicitarias esperadas

  • Las pausas publicitarias están llenas de contenido en lugar de anuncios

  • Reproducción de anuncios incoherente en diferentes sesiones de visualización

  • CloudWatch registros que muestran AdSkipped eventos con varios motivos de omisión

La omisión de anuncios repercute directamente en la generación de ingresos y, si no se soluciona con rapidez, puede provocar una mala experiencia para los espectadores.

Causas habituales

MediaTailor registra los motivos específicos por los que los anuncios se omiten en el mensaje de registro de FILLED_AVAIL eventos del grupo de MediaTailor/AdDecisionServerInteractions registro. Comprender estos motivos de omisión es fundamental para solucionar problemas de forma eficaz.

Motivos comunes de omisión de anuncios
Motivo de omisión Descripción
NEW_CREATIVE El anuncio aún no se ha transcodificado. Esto ocurre cuando MediaTailor encuentra una nueva creatividad publicitaria que necesita ser transcodificada antes de insertarla.
PROFILE_NOT_FOUND El perfil de MediaConvert transcodificación asociado a la configuración de la sesión no existe, lo que impide la preparación del anuncio.
TRANSCODE_ERROR El proceso de transcodificación de anuncios detectó un error y no se pudo completar.
TRANSCODE_IN_PROGRESS La transcodificación del anuncio aún está en curso y no está lista para su inserción.
INTERNAL_ERROR Se ha producido un MediaTailor error interno al gestionar el anuncio, lo que ha impedido su inserción.
AVAIL_DURATION_EXCEEDED El anuncio no cabe durante el resto de la pausa publicitaria.
LEFTOVER_AVAIL_EXCEEDED_THRESHOLD La duración acumulada de todos los anuncios que podrían haberse insertado no alcanza el umbral de personalización configurado para la sesión.
VAST_PARSING_ERROR La respuesta VAST del servidor de decisiones publicitarias contiene errores o tiene un formato incorrecto.
ADS_TIMEOUT El servidor de decisiones publicitarias no respondió dentro del período de espera configurado.
MEDIA_FILE_UNAVAILABLE No se puede acceder a los archivos multimedia publicitarios especificados en la respuesta de VAST.
SESSION_INITIALIZATION_FAILED La MediaTailor sesión no se pudo inicializar correctamente, a menudo debido a variables de sesión incorrectas.
EARLY_CUE_IN La pausa publicitaria finalizó antes de lo previsto debido a una señal de entrada temprana, lo que impidió que el anuncio se insertara por completo.
NO_VARIANT_MATCH La creatividad publicitaria no tiene ninguna variante que coincida con los parámetros de codificación del flujo de contenido (velocidad de bits, resolución, códec).
NO_MODEL_CREATIVE_MATCH La creatividad publicitaria no cumple los requisitos de modelo o formato esperados para la configuración de reproducción actual.
REJECTED_REPLICA_VAST La respuesta de VAST se rechazó debido a las políticas de detección de contenido duplicado o réplica.
INVALID_VAST_WRAPPER_AD El anuncio envoltorio VAST contiene elementos envoltorios no válidos o con un formato incorrecto que impiden que el anuncio se inserte correctamente.
IMPORT_ERROR Se ha producido un error durante el proceso de importación del anuncio que ha impedido que el anuncio se procese para su inserción.
IMPORT_IN_PROGRESS El proceso de importación de anuncios está actualmente en curso y aún no se ha completado.

Además de estos motivos específicos de omisión, otras causas comunes son las siguientes:

  • Configuración incorrecta de las variables de sesión

  • Problemas de conectividad con el servidor de decisiones publicitarias (ADS)

  • Creatividad incoherente IDs para el mismo contenido publicitario

  • Problemas de compatibilidad de los reproductores con el formato del manifiesto

  • Problemas de configuración de la CDN que afectan a la publicación de segmentos de anuncios

Pasos para la solución de problemas

Siga estos pasos para diagnosticar y resolver los problemas de omisión de anuncios:

  1. Identifica el motivo específico de omisión

    Usa CloudWatch Logs Insights para consultar los anuncios omitidos en el grupo de MediaTailor/AdDecisionServerInteractions registros:

    
fields @timestamp, avail.availId, skippedAds.0.skippedReason, skippedAds.0.creativeUniqueId
| filter eventType = "FILLED_AVAIL" and ispresent(skippedAds.0.skippedReason)
| sort @timestamp desc

    Esta consulta muestra los eventos de omisión de anuncios más recientes con sus motivos específicos, lo que te ayuda a identificar patrones.

  2. Compruebe la configuración de las variables de sesión

    Las variables de sesión incorrectas son una causa común de que se omitan anuncios. Verifique lo siguiente:

    • Todas las variables de sesión obligatorias están configuradas correctamente en tu plantilla de URL de ADS

    • Las variables dinámicas tienen el formato correcto (consulte MediaTailor variables de anuncios dinámicos la sintaxis adecuada)

    • Los parámetros del reproductor se están pasando correctamente a MediaTailor

    Ejemplo de una URL de ADS correctamente configurada con variables de sesión:

    
https://my-ads-server.com/ads?
sessionId=[session.id]&
playerParams=[player_params.param1]&
deviceType=[player_params.device]&
correlator=[session.avail_duration_ms]

  3. Resuelva los problemas de NEW_CREATIVE

    Si se omiten anuncios con el motivo: NEW_CREATIVE

    MediaTailor transcodifica los anuncios en función de tres factores clave: el ID de la creatividad, el ID de la cuenta de AWS y el conjunto de variantes de transcodificación (las variantes de reproducción de la transmisión de contenido subyacente). Si alguna parte del conjunto de variantes de transcodificación o ID de creatividad es diferente, MediaTailor reconoce el anuncio como una nueva variante que requiere transcodificación. Esto incluye los cambios en la velocidad de bits cuando se redondea a los 8000 bits más cercanos, lo que puede ocurrir cuando la transmisión de contenido subyacente cambia el manifiesto principal.

    Para obtener información detallada sobre los escenarios de NEW_CREATIVE, incluidos los cambios en la velocidad de bits y los conflictos de ID de las creatividades, consulte la Análisis detallado de NEW_CREATIVE sección siguiente a este procedimiento.

    1. Compruebe que su servidor de decisiones publicitarias devuelva creatividades coherentes IDs para el mismo contenido publicitario

    2. Comprueba si tu flujo de contenido mantiene tasas de bits y conjuntos de variantes consistentes

    3. Considere la posibilidad de implementar la captura previa de anuncios para garantizar que los anuncios se transcodifiquen antes de su reproducción (consulte) Búsqueda previa de anuncios

    4. Si los problemas persisten, póngase en contacto con AWS Support para obtener asistencia adicional para la solución de problemas

  4. Solucione los problemas de conectividad de ADS

    Si se omiten los anuncios por motivos relacionados ADS_TIMEOUT o relacionados:

    • Comprueba que se pueda acceder a tu servidor de decisiones publicitarias desde MediaTailor

    • Compruebe si su ADS responde dentro del período de tiempo de espera configurado

    • Asegúrese de que su ADS pueda gestionar el volumen de solicitudes durante los períodos de mayor actividad

    • Considera la posibilidad de implementar una estrategia publicitaria alternativa para cuando tu ADS principal no esté disponible

  5. Resuelve los problemas de respuesta de VAST

    Si los anuncios se omiten junto con VAST_PARSING_ERROR oMEDIA_FILE_UNAVAILABLE:

    • Valide el formato de respuesta de VAST según la especificación VAST

    • Asegúrese de que todos los archivos multimedia URLs de la respuesta VAST sean de acceso público

    • Compruebe que los caracteres especiales estén correctamente codificados en su XML VAST

    • Compruebe que la respuesta de VAST incluya archivos multimedia en formatos compatibles con MediaTailor

  6. Aborde los problemas de discordancia de duración

    Si los anuncios se omiten con AVAIL_DURATION_EXCEEDED o: LEFTOVER_AVAIL_EXCEEDED_THRESHOLD

    • Asegúrese de que su ADS muestre anuncios que se ajusten a la duración de la pausa publicitaria disponible

    • Comprueba si los marcadores de pausa publicitaria del contenido indican correctamente la duración prevista

    • Considera la posibilidad de ajustar el umbral de personalización si es adecuado para tu caso de uso

  7. Supervise CloudWatch las métricas

    Configura CloudWatch alarmas para las MediaTailor métricas clave a fin de detectar de forma proactiva los problemas de omisión de anuncios:

    • AdDecisionServer.Ads.Skipped- Recuento de anuncios omitidos

    • AdDecisionServer.Timeouts- Recuento de tiempos de espera de ADS

    • Avail.FilledDuration- Duración de las pausas publicitarias rellenadas

    • Avail.SlateOnly- Recuento de pausas publicitarias rellenas únicamente con pizarra

    Para obtener más información sobre las métricas disponibles, consulte Monitorización AWS Elemental MediaTailor con CloudWatch métricas de Amazon.

  8. Solucione los problemas de coincidencia de variantes y formato

    Si los anuncios se omiten por motivos relacionados con el formato NO_VARIANT_MATCH NO_MODEL_CREATIVE_MATCHEARLY_CUE_IN, o por motivos relacionados con el formato:

    • NO_VARIANT_MATCH: Asegúrese de que sus creatividades publicitarias estén disponibles en variantes que coincidan con los parámetros de codificación de su flujo de contenido (velocidad de bits, resolución, códec). Configura tu servidor de anuncios para que muestre anuncios en formatos compatibles.

    • NO_MODEL_CREATIVE_MATCH: Revisa los requisitos del modelo creativo de tu configuración de reproducción y asegúrate de que tu servidor de anuncios ofrezca anuncios que coincidan con el formato y las especificaciones esperados.

    • EARLY_CUE_IN: compruebe que las señales de inicio de su transmisión de contenido estén sincronizadas correctamente y que las pausas publicitarias tengan una duración suficiente para la inserción de anuncios. Comprueba si hay EXT-X-CUE-IN etiquetas prematuras o mensajes SCTE-35 splice_insert.

  9. Resuelva los problemas de empaquetado e importación de VAST

    Si los anuncios se omiten conREJECTED_REPLICA_VAST, INVALID_VAST_WRAPPER_ADIMPORT_ERROR, o: IMPORT_IN_PROGRESS

    • REJECTED_REPLICA_VAST: Comprueba la configuración de tu servidor de anuncios para conocer las políticas de detección de contenido duplicado. Asegúrese de que las respuestas de VAST contengan contenido creativo exclusivo y evite publicar anuncios idénticos en la misma sesión.

    • INVALID_VAST_WRAPPER_AD: Valide las respuestas del contenedor VAST según la especificación VAST. Asegúrese de que todos los elementos del contenedor tengan el formato correcto y contengan un TagURI válido. VASTAd

    • IMPORT_ERRORyIMPORT_IN_PROGRESS: indican problemas con el proceso de importación de anuncios. Comprueba la accesibilidad y la compatibilidad de formatos de los archivos fuente de las creatividades publicitarias. Supervisa el progreso de la importación y vuelve a intentar las importaciones fallidas.

Análisis detallado de NEW_CREATIVE

Esta sección proporciona información completa sobre los escenarios de omisión de anuncios de NEW_CREATIVE, incluidas las causas subyacentes y las técnicas avanzadas de solución de problemas.

Escenario de cambios en la tasa de bits

Los cambios en la velocidad de bits pueden provocar que NEW_CREATIVE salte si la velocidad de bits no coincide después de redondearla a los 8000 bits más cercanos. Esto suele ocurrir cuando:

  • El flujo de contenido subyacente cambia el manifiesto principal

  • Las sesiones nuevas se crean con variantes diferentes a las sesiones existentes

  • Las velocidades de bits del flujo de contenido son inconsistentes en todas las sesiones de reproducción

Conflictos de Creative ID

Cuando MediaTailor encuentra un ID de creatividad diferente para un archivo multimedia que ya se ha transcodificado, se produce la siguiente secuencia:

  1. El anuncio se omite por el motivo NEW_CREATIVE

  2. Esto lleva a un intento de transcodificación innecesario

  3. La creatividad está marcada como DUPLICATE_TRANSCODE o COPY_DEDUP

nota

MediaTailor no caduca ni elimina los anuncios transcodificados. Se almacenan indefinidamente en un depósito MediaTailor de S3 de su propiedad.

Procesamiento de ETAG

El ETAG es un identificador único asociado a una versión específica de una lista de reproducción o manifiesto de anuncios. MediaTailor utiliza el ID de la creatividad para identificar un recurso publicitario, pero si el ID de la creatividad cambia con cada solicitud, el anuncio puede marcarse como una nueva creatividad, lo que impide su inserción.

aviso

No se garantiza que el ID de la creatividad sea único, lo que puede provocar que se muestren anuncios incorrectos.

Problemas de duración y formato

La inserción de anuncios en el servidor (SSAI) requiere formatos de parámetros de duración específicos en los archivos de manifiesto. Los formatos de duración incorrectos pueden provocar errores en la inserción de anuncios.

EXT-X-CUE-OUT parámetro de duración

El parámetro de duración de la EXT-X-CUE-OUT etiqueta debe formatearse como un valor entero, no como un formato de duración ISO 8601.

Requisitos de formato de duración
Formato Ejemplo Estado
Entero (correcto) 32 Compatible: representa 32 segundos
Decimal (correcto) 30.000 Compatible: representa 30 segundos
ISO 8601 (incorrecto) PT32S No se admite: provoca errores de inserción

Ejemplo de formato de manifiesto correcto:


#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

Asegúrese de que todos los parámetros de EXT-X-CUE-OUT duración utilicen un formato entero para evitar problemas de inserción de anuncios.

Validar los formatos de los marcadores de anuncios

Para validar el formato de los marcadores de anuncios e identificar los problemas de duración al analizar la duración:

  1. Comprueba el formato de los marcadores de anuncios en CloudWatch los registros de la sección de AD_MARKER_FOUND eventos

  2. Busca los motivos de FORMAT_ERROR omisión en FILLED_AVAIL los eventos

  3. Comprueba que los valores de duración de tu manifiesto de contenido utilicen los formatos compatibles

  4. Realiza pruebas con diferentes formatos de duración para identificar problemas de compatibilidad

Optimización de transmisiones de VOD

Las transmisiones de vídeo bajo demanda (VOD) pueden generar múltiples solicitudes de ADS, lo que puede afectar al rendimiento. MediaTailor proporciona funciones de optimización para abordar este comportamiento.

Problema con varias solicitudes de ADS

De forma predeterminada, las transmisiones de VOD pueden generar varios eventos MAKING_ADS_REQUEST en los registros. MediaTailor Esto se debe a que cada pausa publicitaria del contenido de VOD desencadena una solicitud de ADS independiente al servidor de decisiones publicitarias.

Para saber si tus transmisiones de vídeo a la carta generan un número excesivo de solicitudes de ADS, utiliza esta consulta de CloudWatch Logs Insights:


fields @timestamp, sessionId, eventType, adBreakIndex
| filter eventType = "MAKING_ADS_REQUEST"
| stats count() by sessionId
| sort count desc
| limit 20

Función de paralelización de VOD

MediaTailor ofrece una función de paralelización para optimizar la gestión de las solicitudes de ADS para el contenido de VOD. Esta función se puede configurar mediante el maxConcurrentAdsRequests parámetro de la configuración de reproducción.

Ejemplo de configuración:


{
  "Name": "OptimizedVODConfig",
  "VideoContentSourceUrl": "https://example.com/content/",
  "AdDecisionServerUrl": "https://example.com/ads",
  "maxConcurrentAdsRequests": 3
}

Esta configuración limita la cantidad de solicitudes ADS simultáneas, lo que reduce la carga del servidor y mejora los tiempos de respuesta.

Gestión integrada de las respuestas de VAST

La función de paralelización también optimiza el manejo de las respuestas VAST empaquetadas, que son comunes en los escenarios de publicidad programática. Las respuestas VAST empaquetadas contienen varias capas de etiquetas VAST que es necesario desempaquetar para llegar a los archivos multimedia reales.

Solución de problemas de variables de sesión

Las variables de sesión desempeñan un papel fundamental en la segmentación y la selección de los anuncios. La configuración incorrecta de las variables de sesión es una causa común de problemas de omisión de anuncios.

Problemas frecuentes con las variables de sesión

Los siguientes problemas con las variables de sesión pueden provocar que se omitan anuncios:

  • Faltan variables obligatorias: es posible que tu servidor de decisiones publicitarias requiera variables específicas que no se proporcionan

  • Sintaxis de variables incorrecta: las variables deben usar la sintaxis correcta (por ejemplo, [session.id] en lugar de${session.id})

  • Problemas de codificación de URL: es posible que los caracteres especiales en valores variables necesiten una codificación de URL adecuada

  • Parámetros del reproductor incoherentes: los parámetros del reproductor deben transmitirse de forma coherente en todas las sesiones

  • Fallos en la resolución de las variables dinámicas: las variables que no se puedan resolver se sustituirán por cadenas vacías

  • Problemas de análisis del UPID del SCTE-35: Los problemas con el procesamiento del UPID de segmentación pueden provocar fallos en la resolución de las variables de sesión.

Verificación de la resolución de las variables de sesión

Para comprobar que las variables de sesión se resuelven correctamente:

  1. Habilite el registro de depuración para su configuración MediaTailor

  2. Compruebe el grupo de MediaTailor/AdDecisionServerInteractions registros para ver la solicitud de ADS real URLs

  3. Compruebe que todas las variables de la URL de la plantilla se hayan reemplazado por los valores adecuados

  4. Busque cualquier variable que se haya reemplazado por cadenas vacías, lo que puede indicar errores de resolución

Ejemplo de entrada de registro que muestra una URL de solicitud de ADS resuelta:


{
  "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"
}

Variables de sesión y análisis UPID del SCTE-35

Los problemas con el procesamiento del UPID de segmentación del SCTE-35 pueden provocar problemas con las variables de sesión:

  • Requisitos de formato: el UPID debe tener segmentation_upid_type entre 12 y estar incluido para un procesamiento adecuado. format_identifier

  • Reglas de análisis: el UPID decodificado puede contener delimitadores de dos puntos para varios valores. El número de variables de plantilla y de tokens UPID decodificados debe ser igual.

  • Formatos no válidos: evite los dos puntos dobles sin valores (por ejemplo, :: o:46175218::4053), ya que provocan errores de análisis.

  • Manejo de los identificadores de formato: se MediaTailor supone que los primeros cuatro bytes son format_identifier. Si falta, private_data trunca los primeros cuatro bytes, lo que podría provocar que el ADS reciba valores diferentes a los esperados.

CloudWatch Consultas avanzadas de Logs Insights

Utiliza estas consultas especializadas de CloudWatch Logs Insights para solucionar de forma detallada los problemas de inserción de anuncios:

¿Cómo encontrar creatividad? IDs

Para identificar los eventos creativos IDs de los de FILLED_AVAIL en el ads_interaction_log:


fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc
nota

Sustitúyalo por el identificador sessionId de sesión real que estás investigando.

Análisis exhaustivo de la sesión

Para un análisis detallado del comportamiento de inserción de anuncios en una sesión 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

Análisis de saltos de NEW_CREATIVE

Para analizar los patrones de omisión de anuncios de NEW_CREATIVE:


fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50

Prácticas recomendadas para evitar que se salten anuncios

Implemente estas prácticas recomendadas para minimizar los problemas de omisión de anuncios:

  • Implemente la captura previa de anuncios: utilice la función de captura previa MediaTailor de anuncios para garantizar que los anuncios se transcodifiquen antes de su reproducción. Consulte los detalles de la implementación. Búsqueda previa de anuncios

  • Mantén una creatividad coherente IDs: asegúrate de que tu servidor de decisiones publicitarias utilice una creatividad coherente IDs para el mismo contenido publicitario en todas las sesiones.

  • Asegúrese de que el formato de duración sea adecuado: utilice valores enteros para los parámetros de EXT-X-CUE-OUT duración en lugar del formato ISO 8601.

  • Configure la optimización de VOD: defina maxConcurrentAds las solicitudes de transmisiones de VOD con varias pausas publicitarias para reducir la carga del servidor.

  • Supervise los patrones de transcodificación: supervise CloudWatch los registros para comprobar la eficacia de la transcodificación y póngase en contacto con AWS Support si observa patrones que indiquen problemas de transcodificación.

  • Compruebe la coherencia de las ETAG: asegúrese de que los archivos multimedia URIs sean coherentes para contenido idéntico a fin de evitar una retranscodificación innecesaria.

  • Implemente una solución de problemas sistemática: siga un enfoque estructurado: identifique los motivos de los errores, analice las causas fundamentales, implemente soluciones y valide las correcciones.

  • Optimice el rendimiento de ADS: configure su servidor de decisiones publicitarias para que responda rápidamente y gestione los picos de tráfico.

  • Implemente una gestión adecuada de los errores: configure el contenido de la lista para cubrir las pausas publicitarias cuando no se puedan insertar anuncios.

  • Supervisa las métricas de inserción de anuncios: configura CloudWatch alarmas para detectar rápidamente los problemas de omisión de anuncios.

  • Realice pruebas exhaustivas: valide su flujo de trabajo de inserción de anuncios en diferentes dispositivos y condiciones de red.

  • Implemente estrategias alternativas: configure las fuentes de anuncios de respaldo o los anuncios predeterminados para cuando las fuentes de anuncios principales fallen.

Para obtener más información sobre cómo solucionar problemas de omisión de anuncios, consulta estos temas relacionados: