View a markdown version of this page

MediaTailor variabili del giocatore per le richieste ADS - AWS Elemental MediaTailor

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

MediaTailor variabili del giocatore per le richieste ADS

AWS Elemental MediaTailor invia i dati ricevuti dal giocatore all'ADS quando AWS Elemental MediaTailor configuri la configurazione per specificare le variabili nell'URL ADS del modello. player_params.<query_parameter_name> Ad esempio, se il giocatore invia un parametro di query indicato user_id nella richiesta a MediaTailor, per passare tali dati nella richiesta ADS, includi [player_params.user_id] nella configurazione dell'URL ADS.

Questo ti consente di controllare i parametri di query inclusi nella richiesta ADS. Generalmente si aggiunge un parametro di query speciale che l'ADS riconosce all'URL della richiesta ADS e si forniscono coppie chiave-valore come valore del parametro.

Gli esempi utilizzati nella procedura seguente usano le seguenti coppie chiave-valore:

  • param1 con il valore value1:

  • param2 con il valore value2:

Per aggiungere parametri di query come coppie chiave-valore

  1. In AWS Elemental MediaTailor, configura l'URL del modello di richiesta ADS in modo che faccia riferimento ai parametri. L'URL seguente mostra l'inclusione dei parametri di esempio: 

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

  2. (Facoltativo) Per i report sul tracciamento degli annunci sul lato server, URL-encode le coppie chiave-valore sul player. Quando MediaTailor riceve la richiesta di inizializzazione della sessione, inserisce i valori una volta prima di URL-decodes sostituirli nell'URL della richiesta ADS.

    Nota

    Se l'ADS richiede un URL-encoded valore, tale valore URL-encode viene visualizzato due volte sul lettore. In questo modo, la decodifica effettuata da MediaTailor restituisce un valore codificato una volta per l'ADS.

    Ad esempio, se la rappresentazione decodificata dei valori inviati all'ADS è, allora la rappresentazione èparam1=value1:&param2=value2:. URL-encoded param1=value1%3A&param2=value2%3A

  3. Nella chiamata di inizializzazione della sessione dal giocatore, passate le coppie chiave-valore a MediaTailor come valore di un singolo parametro di interrogazione. Le seguenti chiamate di esempio forniscono le coppie chiave-valore di esempio per il reporting del tracciamento degli annunci lato server e lato client.

    • Esempi di richieste di segnalazione sul tracciamento degli annunci sul lato server, utilizzando coppie URL-encoded

      HLS:

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

      DASH:

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

    • Esempio di richiesta di segnalazione sul tracciamento degli annunci sul lato client, senza URL-encoding

      HLS:

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

      DASH:

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

Per la segnalazione lato server, MediaTailor decodifica i parametri quando viene ricevuta la richiesta del giocatore. Per i report sul lato client, non altera i parametri ricevuti nel payload JSON. MediaTailor invia la seguente richiesta all'ADS:

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

In questo modo, le coppie chiave-valore param2 e param1 vengono incluse come parametri di query di prima classe nella richiesta ADS.