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 Introducción e implementación de la inserción de anuncios guiada por servidor
AWS Elemental MediaTailor La inserción de anuncios guiada por el servidor (SGAI) ofrece una alternativa a la inserción de anuncios en el servidor, ya que hace referencia a los anuncios como listas de reproducción independientes en lugar de agruparlos directamente en las listas de reproducción multimedia. Este enfoque mejora el rendimiento gracias a los manifiestos que se pueden almacenar en caché y permite una mayor escalabilidad.
Para obtener información sobre cómo utilizar la inserción de anuncios guiada por el servidor con MediaTailor, elige el tema correspondiente de la siguiente lista.
## Actívala en la configuración de reproducción
Para que los reproductores puedan utilizar la inserción de anuncios guiada por el servidor, debes `Insertion Mode` configurarla `PLAYER_SELECT` en la configuración de MediaTailor reproducción. Esto permite a los jugadores seleccionar la inserción de anuncios agrupados o guiados en el momento de inicializar la sesión.
## Crea una sesión guiada por el servidor
Al crear sesiones de reproducción, elija el modo guiado. La forma de hacerlo depende de si los jugadores utilizan sesiones implícitas o explícitas.
### Sesiones guiadas por el servidor creadas implícitamente
Añádalo `aws.insertionMode=GUIDED` a la solicitud de lista de reproducción multivariante del HLS. Ejemplo:
```
playback-endpoint/v1/master/hashed-account-id/origin-id/index.m3u8?aws.insertionMode=GUIDED
```
Donde:
+ `playback-endpoint` es el punto de enlace de reproducción único que generó AWS Elemental MediaTailor cuando creó la configuración.
Ejemplo
```
https://777788889999.mediatailor.us-east-1.amazonaws.com
```
+ `hashed-account-id`es tu ID. Cuenta de AWS
Ejemplo
```
777788889999
```
+ `origin-id` es el nombre que asignó al crear la configuración.
Ejemplo
```
myOrigin
```
+ `index.m3u8`o es el nombre del manifiesto de la secuencia de pruebas más su extensión de archivo. Defina esto de tal forma que pueda obtener un manifiesto totalmente identificado cuando lo añada al origen de contenido de vídeo que configuró en [Paso 4: Crear una configuración](getting-started-ad-insertion.md#getting-started-add-mapping).
Utilizando los valores de los ejemplos anteriores, los valores completos URLs son los siguientes.
+ Ejemplo:
```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/777788889999/myOrigin/index.m3u8?aws.insertionMode=GUIDED
```
### Sesiones guiadas por el servidor creadas de forma explícita
`insertionMode=GUIDED`Añádalos a los metadatos JSON que el reproductor envía en HTTP `POST` al punto final del prefijo de inicialización de la sesión de la MediaTailor configuración.
En el siguiente ejemplo, se muestra la estructura de los metadatos de JSON:
```
{
# other keys, e.g. "adsParams"
"insertionMode": "GUIDED" # this can be either GUIDED or STITCHED
}
```
Con estos metadatos de inicialización, la sesión de reproducción utilizará la inserción de anuncios guiada por el servidor.
# Seguimiento de anuncios con SGAI
SGAI admite el seguimiento de anuncios tanto del lado del servidor como del lado del cliente. El modo de generación de informes se establece al inicializar la sesión. El modo no puede cambiar durante la sesión.
Seguimiento del lado del servidor (predeterminado)
MediaTailor activa balizas VAST automáticamente cuando el jugador solicita segmentos de anuncios. Los anuncios URIs de la lista de activos contienen metadatos de balizas cifrados (`awsBeaconData`,`awsBeaconDomain`,`awsConfigurationName`). El jugador debe admitir la sustitución de `#EXT-X-DEFINE:QUERYPARAM` variables por HLS. La respuesta a la lista de activos no incluye ninguna `TRACKING` sección.
Para obtener más información sobre cómo funciona la baliza SGAI del lado del servidor, consulte. [Seguimiento del lado del servidor con inserción de anuncios guiada por el servidor (SGAI)](ad-reporting-server-side-sgai.md)
Seguimiento del lado del cliente
`aws.reportingMode=CLIENT`Añádalo a su solicitud de inicialización de sesión. La respuesta de la lista de activos incluye una `TRACKING` sección con una baliza URLs que el reproductor activa durante la reproducción del anuncio. El punto final de la `GetTracking` API *no* se utiliza para las sesiones de SGAI. En cambio, cada respuesta a la lista de activos incluye directamente los datos de seguimiento. Los datos de seguimiento utilizan el mismo esquema JSON que la respuesta de seguimiento de la inserción de anuncios en el servidor (SSAI).
Para obtener más información, consulte [Inserción de anuncios guiada por el servidor](ad-reporting-client-side.md#ad-reporting-client-side-best-practices-sgai).
# Búsqueda previa guiada con palpitaciones manifiestas
Para las transmisiones de SGAI en directo, puedes habilitar la búsqueda previa de anuncios basada en manifiestos añadiendo a tu solicitud de inicialización de sesión: `aws.guidedPrefetchMode=MANIFEST`
```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/777788889999/myOrigin/index.m3u8?aws.insertionMode=GUIDED&aws.guidedPrefetchMode=MANIFEST
```
Cuando está habilitada, MediaTailor añade un identificador de sesión (`?aws.sessionId=`) como parámetro de consulta a cada URL del manifiesto multimedia intersticial () de la lista de reproducción multivariante. `/v1/i-media` Cada vez que el reproductor actualiza un manifiesto multimedia, la solicitud llega MediaTailor con el identificador de sesión, que se utiliza para poner en cola las solicitudes de captura previa para las MediaTailor próximas pausas publicitarias.
+ El `aws.guidedPrefetchMode` parámetro acepta dos valores: `MANIFEST` (activado) y `OFF` (desactivado, predeterminado).
+ El modo de captura previa guiada solo es válido para las sesiones SGAI. Si se utiliza con sesiones cosidas, se produce un error.
+ DASH aún no admite el modo de captura previa guiada.
+ La captura previa guiada es independiente del modo de generación de informes: las balizas se disparan en el momento de la reproducción, no en el momento de la captura previa.
+ **No almacene en caché los manifiestos de i-media en su CDN cuando utilice la captura previa guiada.** El mecanismo de captura previa depende de que las solicitudes de actualización del manifiesto del reproductor lleguen directamente. MediaTailor Si tu CDN almacena en caché `/v1/i-media` las respuestas, MediaTailor no recibe las solicitudes de latidos y no puede activar la captura previa.
# MediaTailor matriz de compatibilidad de funciones de inserción de anuncios guiadas por servidor
AWS Elemental MediaTailor ofrece dos métodos de inserción de anuncios con diferentes funciones compatibles. La inserción de anuncios guiada por el servidor funciona de forma diferente a la inserción de anuncios en el servidor, lo que afecta a la compatibilidad con algunas funciones. MediaTailor Usa esta tabla para saber qué funciones funcionan con cada método de inserción de anuncios.
**Compatibilidad de funciones por método de inserción de anuncios**
| Característica | Inserción de anuncios en el lado del servidor (SSAI) | Inserción de anuncios guiada por el servidor (SGAI) |
| --- | --- | --- |
| Búsqueda previa de anuncios | ✓ Compatible | No se admite todavía |
| Supresión de anuncios | ✓ Compatible | No aplicable |
| Comportamiento del anuncio previo a la publicación | Controlado por configuración MediaTailor | Controlado por MediaTailor configuración |
| Seguimiento de anuncios del lado del cliente | Utiliza la API GetTracking | Usa TRACKING la sección en la lista de activos (no se usa la GetTracking API) |
| Seguimiento de anuncios del lado del servidor | ✓ Compatible: las balizas se activan en función de /v1/segment las solicitudes que utilizan el ID de sesión | ✓ Compatible (solo con HLS): utiliza balizas sin sesión con datos de baliza cifrados integrados en el anuncio. URIs \$1EXT-X-DEFINE:QUERYPARAM Requiere HLS v11 o posterior. Aún no se admite DASH. |
| Decoración Ad-ID | ✓ Compatible | ✗ No compatible |
## Detalles de compatibilidad
### Búsqueda previa de anuncios
Actualmente, no se admite la captura previa de anuncios.
### Supresión de anuncios
Los métodos de inserción de anuncios guiados por el servidor no admiten la supresión de anuncios porque los jugadores solo buscan los anuncios a los que van a reproducir.
### Comportamiento previo a la publicación de anuncios
El horario de prepublicación de los anuncios funciona de forma diferente según los métodos de inserción:
+ **Inserción de anuncios en el servidor:** MediaTailor controla cuándo se reproducen los anuncios anticipados en función de los ajustes de configuración
+ **Inserción de anuncios guiada por el servidor:** MediaTailor inserta los anuncios prepublicados en la parte superior del manifiesto. El reproductor muestra primero estos anuncios y, a continuación, inicia el contenido
### Seguimiento de anuncios
El **seguimiento por parte del cliente** utiliza diferentes mecanismos en función del método de inserción de anuncios:
+ **Inserción de anuncios en el servidor (SSAI)**: utiliza el punto final de la API `GetTracking`
+ **Inserción de anuncios guiada por el servidor (SGAI):** MediaTailor proporciona información de seguimiento en la sección de cada respuesta a la `TRACKING` lista de activos. No se utiliza el punto final `GetTracking` de la API. La respuesta de inicialización de la sesión no incluye un`trackingUrl`.
El **seguimiento del lado del servidor** también difiere entre los métodos:
+ **Inserción de anuncios en el servidor (SSAI):** MediaTailor activa balizas cuando el jugador busca segmentos de anuncios agrupados utilizando el ID de sesión. `/v1/segment/`
+ **Inserción de anuncios guiada por el servidor (SGAI**): utiliza balizas sin sesión. MediaTailor MediaTailor incrusta datos de baliza cifrados (`awsBeaconData`,`awsBeaconDomain`,`awsConfigurationName`) en el manifiesto publicitario que devuelve en la lista de activos. URIs El manifiesto publicitario utiliza `#EXT-X-DEFINE:QUERYPARAM` etiquetas para que el jugador sustituya estos valores en segmentos. URLs Cuando el reproductor solicita cada segmento de anuncio, MediaTailor descifra los datos, activa la baliza correspondiente y redirige al segmento de contenido. Cuando los informes del lado del servidor están activos, MediaTailor omite la `TRACKING` sección de la respuesta a la lista de activos. Para obtener más información, consulte [Seguimiento del lado del servidor con inserción de anuncios guiada por el servidor (SGAI)](ad-reporting-server-side-sgai.md).
### Decoración de identificación publicitaria
La decoración de anuncios no es compatible con la inserción de anuncios guiada por el servidor porque los campos que rellenan X-AD-CREATIVE-SIGNALING los encabezados solo se conocen cuando se consulta la lista de activos, no cuando se escribe el manifiesto.
# MediaTailor configuración de inserción de anuncios guiada por servidor para transmisiones en directo
AWS Elemental MediaTailor La inserción de anuncios para contenido en directo guiada por el servidor ofrece importantes ventajas de rendimiento gracias a los manifiestos que se pueden almacenar en caché. La configuración del SGAI para el contenido en directo utiliza los mismos parámetros básicos que el VOD, con consideraciones específicas en relación con las características de la transmisión en directo y el procesamiento en tiempo real.
## Requisitos para la SGAI en directo
Antes de activar la SGAI para el contenido en directo, asegúrate de contar con lo siguiente:
+ Tu emisión en directo incluye marcadores DATERANGE con el formato correcto
+ La duración de las pausas publicitarias es uniforme y predecible
+ Su CDN está configurada para almacenar en caché los manifiestos de la SGAI de forma adecuada
+ Los reproductores admiten flujos de trabajo de inserción de anuncios guiados por el servidor
+ Tu servidor de decisiones publicitarias puede gestionar las solicitudes de contenido en directo en tiempo real
### Requisitos de los jugadores
Los jugadores deben estar configurados para gestionar correctamente los manifiestos en directo de la SGAI:
+ Support para flujos de trabajo de inserción de anuncios guiados por el servidor
+ Capacidad para procesar la guía de inserción de anuncios a partir de manifiestos
+ Manejo adecuado de la sincronización y temporización de las retransmisiones en directo
+ Para contenido HLS: Support para HLS versión 8 y EXT-X-DATERANGE con el atributo CLASS. Versión 11 para balizamiento del lado del servidor.
+ Para el contenido HLS: soporte para la sustitución de variables EXT-X-DEFINE
## Configuración de reproducción en directo
Para habilitar la SGAI para el contenido en directo, cree una configuración de reproducción que tenga los siguientes ajustes:
**Example Configuración de reproducción en directo SGAI**
```
{
"Name": "LiveSGAIConfig",
"VideoContentSourceUrl": "https://your-live-origin.com/live/stream.m3u8",
"AdDecisionServerUrl": "https://your-ads.com/ads",
"PersonalizationThresholdSeconds": 1,
"InsertionMode": "PLAYER_SELECT"
}
```
Las siguientes son consideraciones clave para la configuración de la SGAI en directo:
`VideoContentSourceUrl`
Debe apuntar a una transmisión HLS en directo con marcadores SCTE-35 DATERANGE correctamente formateados. La transmisión debe mantener la duración de los segmentos y las variantes de velocidad de bits consistentes.
## Solicitudes de manifiesto en directo de la SGAI
Los manifiestos activos de la SGAI utilizan el mismo patrón de URL que la inserción de anuncios tradicional:
```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/manifest.m3u8?aws.insertionMode=GUIDED
```
## Búsqueda previa basada en manifiestos para SGAI en vivo
En el caso de los flujos de trabajo de SGAI en tiempo real, puedes activar la captura previa basada en manifiestos para reducir la latencia del relleno de anuncios. Añade lo siguiente a la solicitud de manifiesto: `aws.guidedPrefetchMode=MANIFEST`
```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/manifest.m3u8?aws.insertionMode=GUIDED&aws.guidedPrefetchMode=MANIFEST
```
Cuando está habilitada, MediaTailor agrega un identificador de sesión (`?aws.sessionId=`) como parámetro de consulta a cada URL del manifiesto multimedia intersticial (`/v1/i-media`) de la lista de reproducción multivariante. Cada vez que el reproductor actualiza un manifiesto de i-media, la solicitud recibe el identificador de sesión, que se MediaTailor MediaTailor utiliza para identificar la sesión y poner en cola las solicitudes de captura previa para las próximas pausas publicitarias.
**importante**
**No guardes en caché los manifiestos multimedia en tu CDN cuando utilices la captura previa guiada.** El mecanismo de captura previa depende de que las solicitudes de actualización del manifiesto del reproductor lleguen directamente. MediaTailor Si tu CDN almacena en caché y publica `/v1/i-media` las respuestas, no recibe las solicitudes de latidos y MediaTailor no puede activar la captura previa. Configura tu CDN para que transfiera las `/v1/i-media/*` solicitudes hasta MediaTailor que esté en uso. `aws.guidedPrefetchMode=MANIFEST`
La captura previa guiada es independiente del modo de generación de informes. Tanto si utilizas el seguimiento del lado del servidor (predeterminado) como del lado del cliente (), las balizas se activan `aws.reportingMode=CLIENT` en el momento de la reproducción, no cuando los anuncios están precargados. Para obtener información general sobre cómo funciona la captura previa de anuncios, consulte. MediaTailor [Búsqueda previa de anuncios](prefetching-ads.md)
## Probando la configuración en vivo de SGAI
Verifique su configuración de SGAI en vivo con estos pasos de validación:
1. **Pruebe la generación de manifiestos**
Solicita la URL del manifiesto activo de la SGAI y verifica que devuelva contenido que se pueda almacenar en caché con las instrucciones de inserción de anuncios adecuadas.
1. **Verifica el almacenamiento en caché de la CDN**
Compruebe que su CDN almacena en caché los manifiestos de la SGAI de acuerdo con los valores TTL configurados.
1. **Pruebe la inserción de anuncios**
Comprueba que los jugadores pueden insertar anuncios correctamente siguiendo las instrucciones que se proporcionan en los manifiestos de la SGAI.
1. **Supervisa el rendimiento**
Utilice CloudWatch las métricas para verificar la reducción de la carga de origen y la mejora de las tasas de aciertos de la memoria caché.
# MediaTailor configuración de inserción de anuncios guiada por servidor para contenido VOD
AWS Elemental MediaTailor La inserción de anuncios para contenido de VOD guiada por el servidor ofrece importantes ventajas de rendimiento gracias a la alta capacidad de almacenamiento en caché de los manifiestos y a la reducción del procesamiento del servidor. La configuración de SGAI para el contenido de VOD aprovecha la naturaleza estática de los video-on-demand activos para maximizar la eficiencia del almacenamiento en caché y minimizar las solicitudes de origen, lo que lo hace ideal para bibliotecas de contenido de gran tamaño con patrones de visualización repetidos.
## Requisitos para el VOD SGAI
Antes de activar la SGAI para el contenido de VOD, asegúrese de contar con lo siguiente:
+ Su contenido de VOD incluye marcadores de anuncios con el formato correcto (SCTE-35 o metadatos temporizados)
+ El contenido se almacena en un origen fiable con una disponibilidad constante
+ Su CDN está configurada para almacenar en caché los manifiestos de SGAI con los valores TTL adecuados
+ Los reproductores admiten flujos de trabajo de inserción de anuncios guiados por el servidor
+ Tu servidor de decisiones publicitarias puede gestionar la segmentación y los metadatos específicos de VoD
### Requisitos de los jugadores
Los reproductores deben estar configurados para gestionar los manifiestos de VOD de la SGAI y la inserción de anuncios:
+ Support para flujos de trabajo de inserción de anuncios guiados por el servidor
+ Capacidad para procesar la guía de inserción de anuncios a partir de los manifiestos de VOD
+ Support para la inserción de anuncios en el lado del cliente durante la reproducción a la carta
+ Gestión adecuada de las operaciones de búsqueda en las pausas publicitarias
+ Support para el seguimiento de la duración y la posición del contenido
## Configuración de reproducción VOD
Para habilitar la SGAI para el contenido de VOD, cree una configuración de reproducción que tenga los siguientes ajustes:
**Example Configuración de reproducción SGAI VOD**
```
{
"Name": "VODSGAIConfig",
"VideoContentSourceUrl": "https://your-vod-origin.com/content/",
"AdDecisionServerUrl": "https://your-ads.com/ads",
"PersonalizationThresholdSeconds": 5,
"InsertionMode": "PLAYER_SELECT"
}
```
Las siguientes son consideraciones clave para la configuración de VOD SGAI:
`VideoContentSourceUrl`
Debe apuntar a su biblioteca de contenido de VOD con patrones de URL consistentes. Asegúrese de que el origen pueda gestionar el volumen de solicitudes esperado y ofrezca una entrega de contenido fiable.
`ConfigurationAliases`
Incluye parámetros específicos de VoD, como la duración del contenido, el género o la información sobre la serie, que se puedan utilizar para la segmentación de los anuncios sin que ello afecte a la capacidad de almacenamiento en caché de los manifiestos.
`ManifestProcessingRules`
Activa el paso a través de los marcadores de anuncios para conservar la información sobre la temporización del contenido original, lo que es especialmente importante en el caso del contenido de VOD con posiciones predefinidas de las pausas publicitarias.
## Solicitudes de manifiestos VOD de SGAI
Los manifiestos VOD de SGAI utilizan el mismo patrón de URL que los anuncios VOD tradicionales.
```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/content-path/manifest.m3u8?aws.insertionMode=GUIDED
```
## Segmentación de anuncios específica para VOD
El contenido de VOD ofrece oportunidades únicas de segmentación de anuncios:
### Segmentación por metadatos de contenido
Aproveche los metadatos del contenido de VOD para mejorar la segmentación de los anuncios:
+ **Género y categoría:** segmenta los anuncios en función del tipo de contenido (drama, comedia, documental)
+ **Clasificación del contenido:** asegúrate de que el contenido de los anuncios sea apropiado para la edad (clasificaciones G, PG, R)
+ **Serie y temporada: segmenta** los anuncios según la continuidad de la serie o el contenido relacionado
+ **Fecha de lanzamiento:** segmenta en función de la antigüedad del contenido (nuevos lanzamientos frente al contenido del catálogo)
+ **Duración del contenido:** ajusta la carga de anuncios en función de la longitud total del contenido
### Visualización de la segmentación contextual
Los patrones de visualización de VOD permiten la segmentación contextual de los anuncios:
+ **Hora del día: segmenta** los anuncios en función del momento en que se esté viendo el contenido
+ **Maratones:** ajusta la frecuencia de los anuncios para que los usuarios vean varios episodios
+ **Tasa de finalización:** segmentación basada en los patrones históricos de finalización del contenido del usuario
+ **Tipo de dispositivo:** optimice los formatos de anuncios para el dispositivo de visualización (TV, móvil, tableta)
## Probando la configuración de VOD de SGAI
Verifique su configuración de VOD de SGAI con estos pasos de validación:
1. **Pruebe la generación de manifiestos**
Solicita el manifiesto VOD de SGAI URLs para distintos tipos de contenido y comprueba que devuelvan contenido que se pueda almacenar en caché siguiendo las instrucciones de inserción de anuncios adecuadas.
1. **Verifica el almacenamiento en caché de la CDN**
Compruebe que su CDN almacene en caché los manifiestos de la SGAI de acuerdo con los valores TTL configurados y que logre altas tasas de aciertos de caché.
1. **Prueba la inserción de anuncios**
Comprueba que los jugadores pueden insertar anuncios correctamente siguiendo las instrucciones que se proporcionan en los manifiestos de la SGAI para distintos tipos de contenido de VOD.
1. **Pruebe las operaciones de búsqueda**
Comprueba que la búsqueda en el contenido de VOD funciona correctamente en las pausas publicitarias y mantiene la posición de reproducción adecuada.
1. **Supervisa el rendimiento**
Utiliza CloudWatch las métricas para comprobar la reducción de la carga de origen, la mejora de las tasas de aciertos de la caché y el éxito de las tasas de inserción de anuncios.
### Escenarios de prueba clave
Pruebe estos escenarios de VOD específicos:
+ **Contenido popular:** compruebe las altas tasas de aciertos de caché de los activos de VOD a los que se accede con frecuencia
+ **Contenido de formato largo:** pruebe la inserción de anuncios en películas o episodios largos con varias pausas publicitarias
+ **Contenido de la serie:** verifica que la segmentación de los anuncios sea coherente en todos los episodios de una serie
+ **Diferentes géneros:** prueba la segmentación de los anuncios en función del género y los metadatos del contenido
## Mejores prácticas de optimización de VOD y SGAI
Optimice su implementación de VOD de SGAI para obtener el máximo rendimiento:
### Optimización de caché
+ **Maximice los valores TTL:** utilice duraciones de caché más largas para los manifiestos de VOD, ya que el contenido no cambia
+ **Minimice las claves de caché:** reduzca las variaciones de las claves de caché para mejorar las tasas de aciertos
+ **Contenido popular previo al calentamiento: guarda** en caché los manifiestos de contenido VOD destacado o de moda
+ **Supervisa el rendimiento de la caché:** rastrea las tasas de aciertos de la caché y optimiza en función de los patrones de uso
### Optimización de la entrega de contenido
+ **Patrones de URL consistentes:** utilice estructuras de URL predecibles para un mejor almacenamiento en caché
+ **Estandarización de los metadatos:** garantice la coherencia de los metadatos del contenido para una segmentación de anuncios fiable
+ **Posicionamiento de las pausas publicitarias:** optimice la ubicación de las pausas publicitarias para lograr transiciones de contenido naturales
+ **Variantes de calidad:** asegúrate de que SGAI funcione en todas las variantes de velocidad de bits de tu contenido de VOD