Uso de variables de anuncios dinámicos en AWS Elemental MediaTailor

La solicitud de AWS Elemental MediaTailor dirigida al servidor de decisión de anuncios (ADS) incluye información sobre la sesión de visualización actual, que ayuda al ADS a elegir los mejores anuncios para proporcionarlos en su respuesta. Al configurar la plantilla ADS en su MediaTailor configuración, puede incluir variables dinámicas, también conocidas como macros. Las variables dinámicas son cadenas reemplazables.

Las variables dinámicas pueden adoptar las siguientes formas:

Valores estáticos: valores que no cambian de una sesión a la siguiente. Por ejemplo, el tipo de respuesta que MediaTailor espera del ADS.
Variables de dominio: variables dinámicas que se pueden usar para los dominios URL, como la parte my-ads-server.com de la URL http://my-ads-server.com. Para obtener más información, consulte Uso de variables de dominio.
Datos de sesión: valores dinámicos que proporciona cada sesión, MediaTailor por ejemplo, el ID de sesión. Para obtener más información, consulte Uso de variables de sesión.
Datos del jugador: valores dinámicos que proporciona el jugador para cada sesión. Estos describen al espectador del contenido y ayudan al ADS a determinar qué anuncios MediaTailor deben incluirse en la transmisión. Para obtener más información, consulte Uso de variables de reproductor.

Para obtener más información sobre el uso de variables dinámicas de dominio, sesión y reproductor, selecciona el tema correspondiente.

Temas

Pasar parámetros al ADS

Para pasar información de la sesión y el reproductor a ADS

Trabaje con el ADS para determinar la información que necesita para que pueda responder a una consulta de anuncios de AWS Elemental MediaTailor.
Cree una configuración MediaTailor que utilice una plantilla de URL de solicitud de ADS que cumpla con los requisitos de ADS. En la URL, incluya parámetros estáticos y marcadores de posición para los parámetros dinámicos. Especifique la URL de la plantilla en el campo Ad decision server (Servidor de decisión de anuncios) de la configuración.

En el siguiente ejemplo, la URL de la plantilla, correlation, proporciona datos de la sesión y deviceType proporciona datos del reproductor:
```
https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
```
En el reproductor, configure la solicitud de inicio de sesión para que AWS Elemental MediaTailor proporcione los parámetros para los datos del reproductor. Incluya los parámetros en la solicitud de inicio de sesión y omítalos en las solicitudes de sesión posteriores.

El tipo de llamada que realiza el jugador para inicializar la sesión determina si el jugador (cliente) o MediaTailor (servidor) proporciona informes de seguimiento de anuncios para la sesión. Para obtener información sobre estas dos opciones, consulte Datos de informes y seguimiento .

Realice uno de los siguientes tipos de llamadas, en función de si desea realizar informes de seguimiento de anuncios en el servidor o en el cliente. En ambas llamadas de ejemplo, userID es para el ADS y auth_token es para el origen:
- (Opcional) Solicita informes de seguimiento de anuncios en el servidor: añade un prefijo a los parámetros que quieres enviar MediaTailor al ADS. ads Suprima el prefijo para los parámetros que desee que MediaTailor envíe al servidor de origen:
  
  Los siguientes ejemplos muestran las solicitudes entrantes de HLS y DASH a. AWS Elemental MediaTailor MediaTailor usa el deviceType en su solicitud al ADS y el auth_token en su solicitud al servidor de origen.
  
  Ejemplo de HLS:
```
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
  Ejemplo de DASH:
```
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
- (Opcional) Solicita informes de seguimiento de anuncios por parte del cliente: proporciona parámetros para el ADS dentro de un objeto. adsParams
  
  Ejemplo de HLS:
```
POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```
  Ejemplo de DASH:
```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```

Cuando el reproductor inicia una sesión, AWS Elemental MediaTailor sustituye las variables de la URL de solicitud de ADS de plantilla por los datos de sesión y los parámetros ads del reproductor. Pasa los parámetros restantes del reproductor al servidor de origen.

Los siguientes ejemplos muestran las llamadas al ADS y al servidor de origen desde AWS Elemental MediaTailor que se corresponden con los ejemplos de llamada de inicialización de sesión del reproductor anterior:

MediaTailor llama al ADS con los datos de la sesión y el tipo de dispositivo del jugador:
```
https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
```

MediaTailor llama al servidor de origen con el token de autorización del jugador.

Ejemplo de HLS:


https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

Ejemplo de DASH:


https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

En las secciones siguientes se incluye información detallada sobre cómo configurar los datos de la sesión y del reproductor.

Uso avanzado

Puede personalizar la solicitud de ADS de muchas formas con datos del reproductor y de la sesión. El único requisito es incluir el nombre de host de ADS.

En los siguientes ejemplos se muestran algunas de las maneras en que puede personalizar su solicitud:

Concatenar los parámetros del reproductor y los parámetros de la sesión para crear nuevos parámetros. Ejemplo:
```
https://my.ads.com?key1=[player_params.value1][session.id]
```
Usar un parámetro de reproductor como parte de un elemento de ruta. Ejemplo:
```
https://my.ads.com/[player_params.path]?key=value
```
Usar parámetros del reproductor para pasar los elementos de ruta y las propias clave, en lugar de solo valores. Ejemplo:
```
https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]
```

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Integraciones de seguimiento de anuncios

Uso de variables de dominio