MediaTailor passaggio di parametri ad ADS

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, vedereMediaTailor riferimento ai parametri e limitazioni.

• Per gli alias di configurazione e le variabili di dominio, vedere. MediaTailor panoramica degli alias di configurazione

• Per ulteriori personalizzazioni alla richiesta ADS, consulta. Utilizzo avanzato

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"}
   }

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

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

Utilizzo avanzato

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