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
<a name="variables-player"></a>

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

1. (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`

1. 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.