Uso de variables de reproductor - AWS Elemental MediaTailor

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 reproductor

Para configurar AWS Elemental MediaTailor para enviar los datos recibidos del reproductor a las ADS player_params.<query_parameter_name> variables especificadas en la plantilla ADSURL. Por ejemplo, si el reproductor envía un parámetro de consulta mencionado user_id en su solicitud a MediaTailor, para pasar esos datos en la ADS solicitud, inclúyalo [player_params.user_id] en la ADS URL configuración.

Esto te permite controlar los parámetros de consulta que se incluyen en la ADS solicitud. Normalmente, se añade a la ADS solicitud un parámetro de consulta especial que ADS reconozca URL y se proporcionan pares clave-valor como valor del parámetro.

Los ejemplos que se utilizan en el siguiente procedimiento utilizan los siguientes pares de clave-valor:

  • param1 con un valor de value1:

  • param2 con un valor de value2:

Para añadir parámetros de consulta como pares de clave-valor

  1. En AWS Elemental MediaTailor, configure la plantilla de ADS solicitud para que haga referencia URL a los parámetros. A continuación se URL muestra la inclusión de los parámetros de ejemplo: 

    https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

  2. (Opcional) Para crear informes de seguimiento de anuncios en el servidor, codifica los URL pares clave-valor del reproductor. Cuando MediaTailor recibe la solicitud de inicialización de la sesión, URL decodifica los valores una vez antes de sustituirlos en la solicitud. ADS URL

    nota

    Si ADS necesita un valor codificado en URL URL -, codifique el valor dos veces en el reproductor. De esta forma, la decodificación realizada MediaTailor da como resultado un valor codificado una vez para. ADS

    Por ejemplo, si la representación decodificada de los valores enviados al ADS esparam1=value1:&param2=value2:, entonces la representación URL codificada es. param1=value1%3A&param2=value2%3A

  3. En la llamada de inicialización de la sesión desde el reproductor, transfiera los pares clave-valor a MediaTailor como el valor de un único parámetro de consulta. Las siguientes llamadas de ejemplo proporcionan los pares de clave-valor de ejemplo para los informes de seguimiento de anuncios del lado del servidor y del cliente.

    • Ejemplos de solicitudes de creación de informes de seguimiento de anuncios en el servidor, mediante pares codificados URL

      HLS:

      <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

      DASH:

      <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

    • Ejemplo de solicitud de elaboración de informes sobre el seguimiento de anuncios por parte del cliente, sin codificación URL

      HLS:

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

      DASH:

      POST <manifest>.mpd
    {
        "adsParams": {
           "param1": "value1:",
           "param2": "value2:"
       }
    }

Para los informes del lado del servidor, MediaTailor decodifica los parámetros cuando se recibe la solicitud del jugador. En el caso de los informes del lado del cliente, no altera los parámetros recibidos en la carga útil. JSON MediaTailor envía la siguiente solicitud a: ADS

https://my.ads.com/<path>?param1=value1:&param2=value2:

De esta forma, los pares clave-valor param1 y los pares param2 clave-valor se incluyen como parámetros de consulta de primera clase en la solicitud. ADS