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 passaggio di parametri ad ADS
<a name="passing-paramters-to-the-ads"></a>

AWS Elemental MediaTailor supporta l'impostazione di variabili dinamiche nelle MediaTailor richieste all'ADS utilizzando i seguenti passaggi. 
+ Per informazioni sulla formattazione supportata per i parametri di query, vedere[MediaTailor riferimento ai parametri e limitazioni](parameter-comprehensive-reference.md).
+ Per gli alias di configurazione e le variabili di dominio, vedere. [MediaTailor panoramica degli alias di configurazione](configuration-aliases-overview.md)
+ Per ulteriori personalizzazioni alla richiesta ADS, consulta. [Utilizzo avanzato](#variables-advanced-usage)

**Metodi di inizializzazione della sessione**  
MediaTailor supporta diversi metodi per l'inizializzazione della sessione e il passaggio dei parametri: 

1. **POST con Request Body:**

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

1. **Parametri di interrogazione nell'URL:**

   ```
   GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
   ```

**Importante**  
È possibile specificare i parametri una sola volta, al momento dell'inizializzazione. Gli alias di configurazione si risolvono in valori effettivi prima dell'inoltro. 

**Per passare le informazioni relative alla sessione e al lettore all'ADS**

1. Collabora con ADS per determinare le informazioni di cui ha bisogno per rispondere a una richiesta di annuncio. AWS Elemental MediaTailor

1. Crea una configurazione MediaTailor che utilizzi un modello di URL di richiesta ADS che soddisfi i requisiti ADS. Nell'URL, includere parametri statici e segnaposto per i parametri dinamici. Immettere l'URL modello nel campo **Ad decision server (Server di annunci)** della configurazione. 

   Nel seguente URL modello di esempio, `correlation` fornisce i dati relativi alla sessione e `deviceType` fornisce i dati relativi al lettore: 

   ```
   https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
   ```

1. Nel lettore, configurare la richiesta di inizializzazione di sessione affinché AWS Elemental MediaTailor fornisca i parametri per i dati del lettore. Includere i parametri nella richiesta di inizializzazione di sessione e ometterli dalle richieste successive per la sessione. 

   Il tipo di chiamata che il giocatore effettua per inizializzare la sessione determina se il giocatore (client) o MediaTailor (server) fornisce report sul tracciamento degli annunci per la sessione. Per informazioni su queste due opzioni, consulta [Segnalazione e tracciamento dei dati](ad-reporting.md). 

   Effettuare uno dei seguenti tipi di chiamata, in base al reporting di tracciamento degli annunci desiderato (lato server o lato client). In entrambe le chiamate di esempio, `userID` è destinato all'ADS e `auth_token` è destinato all'origine:
   + (Opzione) Richiedi la segnalazione del tracciamento degli annunci sul lato server: inserisci come prefisso i parametri che desideri inviare all'ADS. MediaTailor `ads` Omettere il prefisso per i parametri che MediaTailor deve inviare al server di origine: 

     I seguenti esempi mostrano le richieste in arrivo per HLS e DASH to. AWS Elemental MediaTailor MediaTailor utilizza il `deviceType` nella sua richiesta all'ADS e `auth_token` nella sua richiesta al server di origine. 

     Esempio HLS:

     ```
     GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
     ```

     Esempio DASH:

     ```
     GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
     ```
   + (Opzione) Richiesta di report sul tracciamento degli annunci sul lato client: fornisci i parametri per l'ADS all'interno di un oggetto. `adsParams`

     Esempio HLS:

     ```
     POST master.m3u8
         {
             "adsParams": {
                "deviceType": "ipad"
            }
         }
     ```

     Esempio DASH:

     ```
     POST manifest.mpd
         {
             "adsParams": {
                "deviceType": "ipad"
            }
         }
     ```

Quando il giocatore avvia una sessione, AWS Elemental MediaTailor sostituisce le variabili nell'URL della richiesta ADS del modello con i dati della sessione e i parametri del giocatore. `ads` Passa i parametri rimanenti dal lettore al server di origine. 

**Example MediaTailor richieste con variabili pubblicitarie**  
Gli esempi seguenti mostrano le chiamate all'ADS e al server di origine da AWS Elemental MediaTailor che corrispondono agli esempi precedenti di chiamate di inizializzazione della sessione del lettore:   
+ MediaTailor chiama l'ADS con i dati della sessione e il tipo di dispositivo del giocatore: 

  ```
  https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
  ```
+ MediaTailor chiama il server di origine con il token di autorizzazione del giocatore.
  + Esempio HLS:

    ```
    https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh
    ```
  + Esempio DASH:

    ```
    https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh
    ```

## Utilizzo avanzato
<a name="variables-advanced-usage"></a>

È possibile personalizzare la richiesta ADS in molti modi con i dati relativi al lettore e alla sessione. Devi solo includere il nome host ADS. 

Di seguito sono forniti alcuni esempi di personalizzazione della richiesta: 
+ Concatenare i parametri del lettore e i parametri della sessione per creare nuovi parametri. Esempio: 

  ```
  https://my.ads.com?key1=[player_params.value1][session.id]
  ```
+ Usare un parametro del lettore come parte di un elemento di percorso. Esempio:

  ```
  https://my.ads.com/[player_params.path]?key=value
  ```
+ Usare i parametri del lettore per passare sia gli elementi del percorso che le chiavi stesse, anziché solo valori. Esempio: 

  ```
  https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]
  ```