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 permite configurar variables dinámicas en las MediaTailor 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 el paso de parámetros:

  1. POST con cuerpo de 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 con los valores reales antes de reenviarlos.

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

  1. Trabaje con el ADS para determinar la información que necesita para responder a una consulta de anuncios. AWS Elemental MediaTailor

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

  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 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 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 reproductor. ads Pasa los parámetros restantes del reproductor al servidor de origen.

ejemplo MediaTailor solicitudes con variables de anuncios

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 necesita 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]