Seleziona le tue preferenze relative ai cookie

Utilizziamo cookie essenziali e strumenti simili necessari per fornire il nostro sito e i nostri servizi. Utilizziamo i cookie prestazionali per raccogliere statistiche anonime in modo da poter capire come i clienti utilizzano il nostro sito e apportare miglioramenti. I cookie essenziali non possono essere disattivati, ma puoi fare clic su \"Personalizza\" o \"Rifiuta\" per rifiutare i cookie prestazionali.

Se sei d'accordo, AWS e le terze parti approvate utilizzeranno i cookie anche per fornire utili funzionalità del sito, ricordare le tue preferenze e visualizzare contenuti pertinenti, inclusa la pubblicità pertinente. Per continuare senza accettare questi cookie, fai clic su \"Continua\" o \"Rifiuta\". Per effettuare scelte più dettagliate o saperne di più, fai clic su \"Personalizza\".

Utilizzo di variabili pubblicitarie dinamiche in MediaTailor

Modalità Focus
Utilizzo di variabili pubblicitarie dinamiche in MediaTailor - AWS Elemental MediaTailor

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

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 passare le informazioni relative alla sessione e al lettore all'ADS
  1. 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.

  2. 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]
  3. 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 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.

In questa pagina

PrivacyCondizioni del sitoPreferenze cookie
© 2025, Amazon Web Services, Inc. o società affiliate. Tutti i diritti riservati.