View a markdown version of this page

MediaTailor pasar parámetros a ADS - AWS Elemental MediaTailor
Uso 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.

MediaTailor pasar parámetros a ADS

AWS Elemental MediaTailor admite la configuración de variables dinámicas en MediaTailor las solicitudes al ADS mediante los siguientes pasos.

Métodos de inicialización de la sesión

MediaTailor admite varios métodos para la inicialización de la sesión y la transferencia de parámetros:

  1. POST con el cuerpo de la solicitud: 

    POST <master>.m3u8
{
    "adsParams": {"param1": "value1", "param2": "value2"},
    "playerParams": {"param3": "value3"}
}

  2. Parámetros de consulta en la URL: 

    GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
importante

Solo puede especificar los parámetros una vez, en el momento de la inicialización. Los alias de configuración se resuelven en valores reales antes de reenviarlos.

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

  1. Colabore con el ADS para determinar la información desde la que debe responder a una consulta publicitaria. AWS Elemental MediaTailor

  2. Cree una configuración MediaTailor que utilice una plantilla de URL de solicitud de ADS que cumpla los requisitos del 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]

  3. 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 reproductor para inicializar la sesión determina si el reproductor (cliente) o MediaTailor (servidor) proporciona informes de seguimiento de los anuncios de la sesión. Para obtener información sobre estas dos opciones, consulte Datos de generación 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:

    • (Opción) Solicita la generación de informes sobre el seguimiento de los 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:

      En los siguientes ejemplos se muestran las solicitudes entrantes de HLS y DASH a. AWS Elemental MediaTailor MediaTailor utiliza la deviceType de su solicitud al ADS y la auth_token de 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

    • (Opción) Solicita un informe de seguimiento de los anuncios del lado del cliente: proporciona parámetros para el ADS contenido en un objeto. adsParams

      Ejemplo de HLS:

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

      Ejemplo de DASH:

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

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

ejemplo MediaTailor solicitudes con variables de anuncio

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

Uso avanzado

Puede personalizar la solicitud de ADS de muchas formas con datos del reproductor y de la sesión. Solo necesitas 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]