View a markdown version of this page

MediaTailor variables de jugador para solicitudes de ADS - 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.

MediaTailor variables de jugador para solicitudes de ADS

AWS Elemental MediaTailor envía los datos recibidos del reproductor al ADS cuando configuras la URL del ADS de la plantilla AWS Elemental MediaTailor para especificar player_params.<query_parameter_name> variables. Por ejemplo, si el jugador envía un parámetro de consulta mencionado user_id en su solicitud a MediaTailor, para transferir esos datos a la solicitud de ADS, inclúyalo [player_params.user_id] en la configuración de la URL del ADS.

Esto le permite controlar los parámetros de consulta que se incluyen en la solicitud de ADS. Normalmente, se añade un parámetro de consulta especial que el ADS reconoce a la URL de solicitud de ADS y se proporcionan pares de clave-valor como el 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, configura la URL de la plantilla de solicitud de ADS para que haga referencia a los parámetros. La siguiente 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 los informes de seguimiento de anuncios del lado del servidor, URL-encode los pares clave-valor del reproductor. Cuando MediaTailor recibe la solicitud de inicialización de la sesión, escribe los valores una vez antes de URL-decodes sustituirlos en la URL de la solicitud de ADS.

    nota

    Si tu ADS requiere un URL-encoded valor, URL-encode el valor será el doble para el reproductor. De esta forma, la decodificación realizada MediaTailor da como resultado un valor codificado una vez para el ADS.

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

  3. En la llamada de inicialización de sesión del jugador, pase 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 informes de seguimiento de anuncios en el servidor, utilizando pares URL-encoded

      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 informes de seguimiento de anuncios del lado del cliente, sin URL-encoding

      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 de JSON. MediaTailor envía la siguiente solicitud al ADS:

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

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