Uso de variables de anuncios dinámicos en MediaTailor - AWS Elemental MediaTailor
Pasar los parámetros al ADSUso avanzado

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.

Uso de variables de anuncios dinámicos en MediaTailor

La AWS Elemental MediaTailor la solicitud al servidor de decisiones publicitarias (ADS) incluye información sobre la sesión de visualización actual, lo que le ayuda a ADS elegir los mejores anuncios para su respuesta. Cuando configuras la ADS plantilla en tu MediaTailor configuración, puedes 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 se MediaTailor espera deADS.

  • Variables de dominio: variables dinámicas que se pueden usar para URL dominios, como la parte my-ads-server.com del URL http://my-ads-server.com. Para obtener más información, consulte Uso de variables de dominio para configurar múltiples fuentes de contenido y anuncios.

  • 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 le ayudan ADS a determinar qué anuncios MediaTailor deberían 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 los parámetros al ADS

Para pasar la información de la sesión y del jugador al ADS

  1. Trabaja con él ADS para determinar la información que necesita para que pueda responder a una consulta publicitaria de AWS Elemental MediaTailor.

  2. Crea una configuración MediaTailor que utilice una ADS solicitud de plantilla URL que cumpla los ADS requisitos. En elURL, incluya parámetros estáticos e incluya marcadores de posición para los parámetros dinámicos. Introduzca su plantilla URL en el campo del servidor de decisiones publicitarias de la configuración.

    En el siguiente ejemploURL, la plantilla correlation proporciona los datos de la sesión y deviceType los datos del jugador:

    https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]

  3. En el reproductor, configure la solicitud de inicio de sesión para AWS Elemental MediaTailor para proporcionar parámetros para los datos del jugador. 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 los dos ejemplos, userID las llamadas están destinadas al origen ADS y auth_token están destinadas al origen:

    • (Opcional) Solicita informes de seguimiento de anuncios en el servidor: añade un prefijo a los parámetros que quieres enviar MediaTailor al servidor. ADS ads Deja el prefijo desactivado para los parámetros que quieras enviar MediaTailor al servidor de origen:

      Los siguientes ejemplos muestran las solicitudes entrantes para HLS y DASH para AWS Elemental MediaTailor. MediaTailor utiliza el deviceType en su solicitud al servidor de origen ADS y el auth_token en su solicitud al servidor de origen.

      HLSejemplo:

      GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh

      DASHejemplo:

      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 interior de un objeto. adsParams

      HLSejemplo:

      POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

      DASHejemplo:

      POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

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

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

  • MediaTailor llama 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.

    • HLSejemplo:

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

    • DASHejemplo:

      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

Puedes personalizar la ADS solicitud de muchas formas con los datos del jugador y de la sesión. El único requisito es incluir el ADS nombre del servidor.

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]