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à.
La AWS Elemental MediaTailor richiesta all'Ad Decision Server (ADS) include informazioni sulla sessione di visualizzazione corrente, che aiutano l'ADS a scegliere gli annunci migliori da fornire in 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.
Passaggio dei parametri all'ADS
I passaggi seguenti descrivono come impostare le variabili dinamiche nelle MediaTailor richieste all'ADS.
-
Per informazioni sulla formattazione supportata per i parametri di query, consulta Caratteri e limitazioni supportati dal parametro di query manifesto eLimiti alla lunghezza dei parametri di interrogazione ADS.
-
Per ulteriori personalizzazioni alla richiesta ADS, consulta. Utilizzo avanzato
Per passare le informazioni relative alla sessione e al lettore all'ADS
-
Collabora con ADS per determinare le informazioni di cui ha bisogno in modo che possa rispondere a una richiesta di annuncio inviata 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 edeviceType
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 eauth_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 eauth_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.
Esempio 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
-
Caratteri e limitazioni supportati dal parametro di query manifesto
È possibile utilizzare i seguenti caratteri nei parametri di query utilizzati nelle richieste manifest:
-
Alfanumerico (A-Z, a-z, 0-9)
-
Periodi (.)
-
Trattini (-)
-
Sottolineature (_)
-
Barre posteriori (\)
Limiti di lunghezza
La lunghezza totale di tutti i parametri di query del manifesto (la chiave e il valore combinati) non deve superare i 2000 caratteri.
Caratteri non supportati
Non è possibile utilizzare i seguenti caratteri nei parametri della query del manifesto: :
?
&
=
%
/
(barra diretta)
Limiti alla lunghezza dei parametri di interrogazione ADS
Le seguenti limitazioni di lunghezza si applicano ai parametri di query utilizzati nelle richieste all'ADS:
-
Nome del parametro ADS: 10000 caratteri
-
Valore del parametro ADS: 25000 caratteri
-
URL ADS: 25000 caratteri
Utilizzo avanzato
È possibile personalizzare la richiesta ADS in molti modi con i dati relativi al lettore e alla sessione. L'unico requisito è 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]
Per ulteriori informazioni sull'utilizzo delle variabili dinamiche di dominio, sessione e player, seleziona l'argomento pertinente.