Utilizzo delle variabili del giocatore

Per configurare AWS Elemental MediaTailor per l'invio dei dati ricevuti dal lettore all'ADS, nell'URL ADS modello, specifica le variabili 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, configurare l'URL modello della 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 il reporting di tracciamento degli annunci lato server, codificare nell'URL le coppie chiave-valore nel lettore. Quando MediaTailor riceve la richiesta di inizializzazione della sessione, decodifica i valori una volta prima di sostituirli nell'URL della richiesta ADS.

   Nota

   Se l'ADS richiede un valore con codifica URL, codificare due volte il valore nell'URL 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 è param1=value1:&param2=value2:, la rappresentazione con codifica URL è param1=value1%3A&param2=value2%3A.

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

   • Esempio di richieste di reporting degli annunci lato server, usando coppie con codifica URL

     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 reporting del tracciamento degli annunci lato client, senza codifica URL

     HLS:

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

     DASH:

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

Per i report sul lato server, MediaTailor decodifica i parametri quando viene ricevuta la richiesta del giocatore. Per i report 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.