Passaggio dei parametri all'ADS Utilizzo avanzato

Utilizzo di variabili pubblicitarie dinamiche in AWS Elemental MediaTailor

La richiesta di AWS Elemental MediaTailor al server di annunci (ADS) include informazioni sulla sessione di visualizzazione corrente, che consentono all'ADS di scegliere gli annunci migliori da fornire nella propria risposta. Quando configuri il modello ADS nella tua MediaTailor configurazione, puoi includere variabili dinamiche, note anche come macro. Le variabili dinamiche sono stringhe sostituibili.

Le variabili dinamiche possono assumere le seguenti forme:

Valori statici: valori che non cambiano da una sessione all'altra. Ad esempio, il tipo di risposta che MediaTailor si aspetta dall'ADS.
Variabili di dominio: variabili dinamiche che possono essere utilizzate per i domini URL, ad esempio la parte my-ads-server.com dell'URL http://my-ads-server.com. Per informazioni dettagliate, consultare Utilizzo di variabili di dominio.
Dati di sessione: valori dinamici forniti da MediaTailor per ogni sessione, ad esempio l'ID di sessione. Per informazioni dettagliate, consultare Utilizzo delle variabili di sessione.
Dati del giocatore: valori dinamici forniti dal giocatore per ogni sessione. Questi descrivono il visualizzatore di contenuti e aiutano l'ADS a determinare quali annunci MediaTailor devono essere inseriti nello stream. Per informazioni dettagliate, consultare Utilizzo delle variabili del giocatore.

Per ulteriori informazioni sull'utilizzo delle variabili dinamiche di dominio, sessione e player, seleziona l'argomento pertinente.

Argomenti

Passaggio dei parametri all'ADS

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

Interagire con l'ADS per determinare le informazioni di cui ha bisogno per poter rispondere a una query di annuncio da AWS Elemental MediaTailor.
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]
```
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 .

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 l'utente inizializza una sessione, AWS Elemental MediaTailor sostituisce le variabili nell'URL della richiesta ADS modello con i dati relativi alla sessione e i parametri ads del lettore. Passa i parametri rimanenti dal lettore al server di origine.

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

Le seguenti sezioni forniscono informazioni dettagliate per configurare i dati relativi alla sessione e al lettore.

Utilizzo avanzato

È possibile personalizzare la richiesta ADS in molti modi con i dati relativi al lettore e alla sessione. L'unico requisito è l'inclusione del 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]
```

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Integrazioni per il tracciamento degli annunci

Utilizzo di variabili di dominio