

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.

# MediaTailor Guía de solución de problemas de omisión de anuncios
<a name="troubleshooting-ad-skipping-overview"></a>

La omisión de anuncios es uno de los problemas más comunes que denuncian MediaTailor los clientes. Esta guía le ayuda a identificar los problemas de omisión de anuncios y proporciona procedimientos de step-by-step solución de problemas.

## Síntomas e impacto
<a name="ad-skipping-symptoms"></a>

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 muestran contenido en lugar de anuncios
+ Reproducción de anuncios incoherente en distintas sesiones de visualización
+ CloudWatch registros que muestran `AdSkipped` eventos con varios motivos de omisión

La omisión de anuncios afecta directamente a los ingresos y puede crear una mala experiencia para los espectadores. Aborde estos problemas con prontitud para mantener un rendimiento óptimo.

## Identificar los motivos de los saltos
<a name="identifying-skip-reasons"></a>

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 para ayudarte a identificar patrones.

**Topics**
+ [Síntomas](#ad-skipping-symptoms)
+ [Omitir los motivos](#identifying-skip-reasons)
+ [NEW\$1CREATIVE: omisión](troubleshooting-new-creative-skipping.md)
+ [Omisión del tiempo de espera de ADS](troubleshooting-ads-timeout-skipping.md)
+ [Omisión de análisis de VAST](troubleshooting-vast-parsing-skipping.md)
+ [Omisión de discordancia de duración](troubleshooting-duration-mismatch-skipping.md)
+ [Omisión de variables de sesión](troubleshooting-session-variables-skipping.md)
+ [Supervisión y omisión](monitoring-ad-skipping-issues.md)
+ [Mejores prácticas de prevención](preventing-ad-skipping-best-practices.md)
+ [Materiales de referencia](ad-skipping-reference-materials.md)

# MediaTailor NEW\$1CREATIVE: solución de problemas de omisión de anuncios
<a name="troubleshooting-new-creative-skipping"></a>

Cuando se omiten los anuncios `NEW_CREATIVE` por el motivo, se AWS Elemental MediaTailor encuentra un anuncio que requiere ser transcodificado antes de insertarse. En esta guía de solución de problemas se explican las causas y se proporcionan los procedimientos de step-by-step resolución.

## ¿Qué provoca que NEW\$1CREATIVE omita
<a name="new-creative-causes"></a>

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. 

### La velocidad de bits cambia
<a name="bitrate-changes-cause"></a>

Los cambios en la velocidad de bits pueden provocar que NEW\$1CREATIVE salte si la velocidad de bits no coincide después de redondearla a los 8000 bits más cercanos. Esto suele ocurrir en las siguientes situaciones:
+ 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

#### Recoja la variación del ancho de banda del trabajo
<a name="harvest-job-bandwidth-variance"></a>

En el caso de los trabajos de recolección, MediaTailor utiliza un umbral de variación del ancho de banda del 15% al hacer coincidir los anuncios con las transmisiones de contenido. Si hay una diferencia del 15% o más entre el ancho de banda de la transmisión en directo y el ancho de banda del archivo HLS recolectado, el anuncio se volverá a transcodificar. Esto puede provocar que NEW\$1CREATIVE se salte durante el proceso de transcodificación.

Este comportamiento suele producirse cuando:
+ Los mismos anuncios pretranscodificados se utilizan tanto para la transmisión en directo como para el contenido de VOD
+ El contenido recolectado tiene parámetros de codificación diferentes a los de la transmisión en directo original
+ Las diferencias de ancho de banda superan el umbral del 15% entre el contenido en vivo y el recolectado

### Conflictos de Creative ID
<a name="creative-id-conflicts-cause"></a>

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\$1CREATIVE

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

1. La creatividad está marcada como DUPLICATE\$1TRANSCODE o COPY\$1DEDUP

**nota**  
MediaTailor no caduca ni elimina los anuncios transcodificados. Los almacenamos indefinidamente en un depósito S3 MediaTailor de nuestra propiedad.

## Pasos de resolución
<a name="new-creative-resolution-steps"></a>

Para resolver los problemas de omisión de anuncios de NEW\$1CREATIVE:

1. Comprueba que tu servidor de decisiones publicitarias muestre creatividades coherentes IDs para el mismo contenido publicitario.

1. Comprueba que tu flujo de contenido mantenga velocidades de bits y conjuntos de variantes consistentes.

1. Considere la posibilidad de implementar la captura previa de anuncios para garantizar que los anuncios se transcodifiquen antes de su reproducción. Para obtener más información, consulte [Búsqueda previa de anuncios](prefetching-ads.md).

1. Si los problemas persisten, póngase en contacto con [AWS Support](https://aws.amazon.com/premiumsupport/) para obtener asistencia adicional para la solución de problemas.

## Supervisión de los patrones de NEW\$1CREATIVE
<a name="new-creative-monitoring"></a>

Usa esta consulta de CloudWatch Logs Insights para analizar los patrones de omisión de anuncios de NEW\$1CREATIVE:

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

# MediaTailor Solución de problemas de tiempo de espera y omisión de anuncios
<a name="troubleshooting-ads-timeout-skipping"></a>

Cuando se omiten los anuncios por motivos relacionados `ADS_TIMEOUT` o relacionados, tiene problemas de conectividad o rendimiento con su servidor de decisiones publicitarias. AWS Elemental MediaTailor requiere una comunicación fiable con tu ADS para poder insertar anuncios correctamente. Esta guía de solución de problemas explica cómo identificar y resolver estos problemas de conectividad.

## Problemas comunes de conectividad de ADS
<a name="ads-timeout-causes"></a>

Los problemas de conectividad de ADS más comunes incluyen los siguientes:
+ No se puede acceder al servidor de decisiones publicitarias desde MediaTailor
+ El ADS no responde dentro del período de espera configurado
+ ADS no puede gestionar el volumen de solicitudes durante los períodos de mayor actividad
+ Problemas de conectividad de red entre MediaTailor y su ADS

## Pasos de resolución
<a name="ads-timeout-resolution"></a>

Para resolver problemas de tiempo de espera de ADS:

1. Compruebe que se pueda acceder a su servidor de decisiones publicitarias desde MediaTailor.

1. Comprueba que tu ADS responde dentro del período de espera configurado.

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

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

## Supervisión del rendimiento de ADS
<a name="ads-timeout-monitoring"></a>

Configure CloudWatch alarmas para que la `AdDecisionServer.Timeouts` métrica detecte de forma proactiva los problemas de conectividad de ADS.

# MediaTailor VAST analiza y omite la solución de problemas
<a name="troubleshooting-vast-parsing-skipping"></a>

Cuando los anuncios se omiten `VAST_PARSING_ERROR` o `MEDIA_FILE_UNAVAILABLE` si tienes problemas con tus respuestas de VAST o tus archivos multimedia publicitarios. AWS Elemental MediaTailor requiere respuestas VAST con el formato adecuado y archivos multimedia accesibles para poder insertar correctamente los anuncios. Esta guía de solución de problemas explica cómo identificar y resolver estos problemas.

## Problemas frecuentes de VAST
<a name="vast-parsing-causes"></a>

Entre los problemas frecuentes de VAST se incluyen los siguientes:
+ El formato de respuesta VAST no cumple con la especificación VAST
+ El archivo multimedia de URLs la respuesta VAST no es de acceso público
+ Los caracteres especiales no están codificados correctamente en VAST XML
+ A la respuesta VAST le faltan los archivos multimedia o formatos necesarios

## Pasos de resolución
<a name="vast-parsing-resolution"></a>

Para resolver los problemas de análisis de VAST:

1. Valide su formato de respuesta VAST según la especificación VAST.

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

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

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

## Solución de problemas con el contenedor VAST
<a name="vast-wrapper-issues"></a>

Si tiene problemas con `INVALID_VAST_WRAPPER_AD` o`REJECTED_REPLICA_VAST`:
+ Valide las respuestas del contenedor VAST con respecto a la especificación VAST
+ Asegúrese de que todos los elementos del contenedor tengan el formato correcto y contengan un TagURI válido VASTAd
+ Compruebe la configuración del 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 único en la misma sesión

# MediaTailor resolución de problemas de discordancia y omisión de la duración
<a name="troubleshooting-duration-mismatch-skipping"></a>

Si los anuncios se omiten por motivos relacionados con `AVAIL_DURATION_EXCEEDED` el formato o por motivos relacionados con el formato, se producen problemas de duración o compatibilidad con el formato. `LEFTOVER_AVAIL_EXCEEDED_THRESHOLD` AWS Elemental MediaTailor requiere una duración, un formato y una correspondencia adecuados entre el contenido del anuncio y el tiempo de pausa publicitario disponible. En esta guía de solución de problemas se explica cómo identificar y resolver estos problemas relacionados con la duración.

## Problemas de duración habituales
<a name="duration-mismatch-causes"></a>

Entre los problemas de duración más comunes se incluyen los siguientes:
+ La duración de la pausa publicitaria de los anuncios es superior a la disponible
+ Los marcadores de pausa publicitaria en el contenido son incorrectos y indican una duración incorrecta
+ No se alcanzó el umbral de personalización para la inserción de anuncios
+ Formato de duración incorrecto en las EXT-X-CUE-OUT etiquetas

## Requisitos de formato de duración
<a name="duration-format-requirements"></a>

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 | Status | 
| --- | --- | --- | 
| 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 | 

## Pasos de resolución
<a name="duration-mismatch-resolution"></a>

Para resolver problemas de discordancia de duración:

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

1. Comprueba que los marcadores de pausa publicitaria del contenido indican correctamente la duración prevista.

1. Compruebe que los parámetros de EXT-X-CUE-OUT duración utilizan un formato entero.

1. Considere ajustar el umbral de personalización si es apropiado para su caso de uso.

# MediaTailor solución de problemas de saltos y variables de sesión
<a name="troubleshooting-session-variables-skipping"></a>

Las variables de sesión desempeñan un papel fundamental en la segmentación y selección de los anuncios en AWS Elemental MediaTailor. La configuración incorrecta de las variables de sesión es una causa común de problemas de omisión de anuncios. En esta completa guía de solución de problemas, se explica cómo identificar y resolver los problemas relacionados con las variables de sesión que pueden impedir que los anuncios se inserten correctamente.

## Problemas frecuentes con las variables de sesión
<a name="session-variable-issues"></a>

Entre los problemas más comunes relacionados con las variables de sesión se incluyen los siguientes:
+ **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 de los 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 pueden resolver se sustituyen 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
<a name="session-variable-verification"></a>

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

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

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

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

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

## Solución de problemas de análisis UPID del SCTE-35
<a name="upid-parsing-troubleshooting"></a>

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 12 e incluir para un `segmentation_upid_type` 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

# MediaTailor omisión de anuncios, monitoreo y alertas
<a name="monitoring-ad-skipping-issues"></a>

La supervisión proactiva le ayuda a detectar y resolver los problemas de omisión de anuncios antes de que afecten significativamente a sus ingresos. AWS Elemental MediaTailor proporciona métricas y capacidades de registro integrales que permiten una supervisión eficaz del rendimiento de la inserción de anuncios. En esta guía, se explica cómo configurar una supervisión eficaz de los problemas de omisión de anuncios.

## CloudWatch Métricas clave que hay que supervisar
<a name="cloudwatch-metrics-monitoring"></a>

Configura CloudWatch alarmas para estas MediaTailor métricas clave:
+ `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

## Consultas avanzadas CloudWatch de Logs Insights
<a name="advanced-cloudwatch-queries"></a>

Utilice estas consultas especializadas para solucionar problemas de forma detallada:

### Análisis exhaustivo de las sesiones
<a name="comprehensive-session-analysis-query"></a>

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
```

### ¿Cómo encontrar la creatividad IDs
<a name="creative-id-identification-query"></a>

Para identificar los eventos creativos IDs de los de FILLED\$1AVAIL:

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

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

# MediaTailor y las mejores prácticas de prevención de saltos
<a name="preventing-ad-skipping-best-practices"></a>

La implementación de estas mejores prácticas ayuda a evitar problemas de omisión de anuncios antes de que se produzcan, lo que garantiza un mejor rendimiento de inserción de anuncios y una protección de los ingresos. AWS Elemental MediaTailor Estas medidas proactivas abordan las causas más comunes de omisión de anuncios y ayudan a mantener una publicación de anuncios uniforme.

## Medidas proactivas
<a name="proactive-measures"></a>
+ **Implemente la captura previa de anuncios: utilice** MediaTailor la función de captura previa de anuncios para garantizar que los anuncios se transcodifiquen antes de su reproducción. [Búsqueda previa de anuncios](prefetching-ads.md)Consulte para obtener detalles sobre la implementación
+ **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
+ **Optimice el rendimiento de ADS**: configure su servidor de decisiones publicitarias para que responda rápidamente y gestione los picos de tráfico

## Directrices de implementación
<a name="implementation-guidelines"></a>
+ **Implemente una gestión adecuada de los errores**: configure el contenido de la lista para rellenar las pausas publicitarias cuando no se puedan insertar 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
+ **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](https://aws.amazon.com/premiumsupport/) si observa patrones que indiquen problemas de transcodificación

# MediaTailor Guía de referencia para omitir anuncios
<a name="ad-skipping-reference-materials"></a>

Esta sección proporciona información de referencia completa sobre los motivos de omisión de anuncios y enlaces a la documentación relacionada con AWS Elemental MediaTailor. Utilice esta guía de referencia para comprender los significados específicos de los distintos motivos de omisión y encontrar recursos adicionales para la solución de problemas.

## Complete la referencia sobre los motivos de omisión de anuncios
<a name="complete-skip-reasons-reference"></a>

MediaTailor registra los motivos específicos por los que se omiten los anuncios en el mensaje de registro de `FILLED_AVAIL` eventos del grupo de `MediaTailor/AdDecisionServerInteractions` registros.


**Complete los motivos de omisión de anuncios**  

| Omitir el motivo | Description (Descripción) | 
| --- | --- | 
| NEW\$1CREATIVE | 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\$1NOT\$1FOUND | 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\$1ERROR | El proceso de transcodificación de anuncios detectó un error y no se completó. | 
| TRANSCODE\$1IN\$1PROGRESS | La transcodificación del anuncio aún está en curso y no está lista para su inserción. | 
| INTERNAL\$1ERROR | Se ha producido un MediaTailor error interno al gestionar el anuncio, lo que ha impedido su inserción. | 
| AVAIL\$1DURATION\$1EXCEEDED | El anuncio no cabe durante el resto de la pausa publicitaria. | 
| LEFTOVER\$1AVAIL\$1EXCEEDED\$1THRESHOLD | 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\$1PARSING\$1ERROR | La respuesta VAST del servidor de decisiones publicitarias contiene errores o tiene un formato incorrecto. | 
| ADS\$1TIMEOUT | El servidor de decisiones publicitarias no respondió dentro del período de espera configurado. | 
| MEDIA\$1FILE\$1UNAVAILABLE | No se puede acceder a los archivos multimedia publicitarios especificados en la respuesta de VAST. | 
| SESSION\$1INITIALIZATION\$1FAILED | La MediaTailor sesión no se pudo inicializar correctamente, a menudo debido a variables de sesión incorrectas. | 
| EARLY\$1CUE\$1IN | 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\$1VARIANT\$1MATCH | 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\$1MODEL\$1CREATIVE\$1MATCH | La creatividad publicitaria no cumple los requisitos de modelo o formato esperados para la configuración de reproducción actual. | 
| REJECTED\$1REPLICA\$1VAST | La respuesta de VAST se rechazó debido a las políticas de detección de contenido duplicado o réplica. | 
| INVALID\$1VAST\$1WRAPPER\$1AD | El anuncio envoltorio VAST contiene elementos envoltorios no válidos o con un formato incorrecto que impiden que el anuncio se inserte correctamente. | 
| IMPORT\$1ERROR | 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\$1IN\$1PROGRESS | El proceso de importación de anuncios está actualmente en curso y aún no se ha completado. | 

## Recursos relacionados
<a name="related-resources"></a>

Para obtener más información sobre cómo solucionar problemas de omisión de anuncios, consulta estos temas relacionados:
+ [MediaTailor variables de anuncios dinámicos para solicitudes de ADS](variables.md)- Guía completa sobre las variables dinámicas de los anuncios en MediaTailor
+ [Búsqueda previa de anuncios](prefetching-ads.md)- Cómo implementar la captura previa de anuncios para evitar omisiones relacionadas con la transcodificación
+ [Monitorización AWS Elemental MediaTailor con CloudWatch métricas de Amazon](monitoring-cloudwatch-metrics.md) CloudWatch - MediaTailor Supervisión con métricas
+ [Visualización de AWS Elemental MediaTailor los registros](monitoring-through-logs.md)- ¿Cómo ver y analizar MediaTailor los registros
+ [Solución de problemas de flujo de MediaTailor eventos](troubleshooting-event-flow.md)- Comprender el flujo de eventos de inserción de anuncios