Utilizzo delle variabili del giocatore - 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à.

Utilizzo delle variabili del giocatore

Per configurare AWS Elemental MediaTailor per inviare i dati ricevuti dal giocatore aADS, nel modello ADSURL, specificare player_params.<query_parameter_name> le variabili. Ad esempio, se il giocatore invia un parametro di query indicato user_id nella sua richiesta a MediaTailor, per passare i dati nella ADS richiesta, includi [player_params.user_id] nella ADS URL configurazione.

Ciò consente di controllare i parametri di interrogazione inclusi nella ADS richiesta. In genere, si aggiunge uno speciale parametro di query che ADS riconosce alla ADS richiesta URL e si forniscono coppie chiave-valore come valore del parametro.

Gli esempi utilizzati nella procedura seguente usano le seguenti coppie chiave-valore:

  • param1 con il valore value1:

  • param2 con il valore value2:

Per aggiungere parametri di query come coppie chiave-valore

  1. In AWS Elemental MediaTailor, configura il modello di ADS richiesta URL per fare riferimento ai parametri. Di seguito URL viene illustrata l'inclusione dei parametri di esempio: 

    https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

  2. (Facoltativo) Per la segnalazione del tracciamento degli annunci sul lato server, URL codifica le coppie chiave-valore sul player. Quando MediaTailor riceve la richiesta di inizializzazione della sessione, URL decodifica i valori una volta prima di sostituirli nella richiesta. ADS URL

    Nota

    Se hai ADS bisogno di un valore con URL codifica, codifica il valore due volte sul lettoreURL. In questo modo, la decodifica effettuata da MediaTailor restituisce un valore codificato una volta per. ADS

    Ad esempio, se la rappresentazione decodificata dei valori inviati a ADS èparam1=value1:&param2=value2:, allora la rappresentazione con codifica è. URL param1=value1%3A&param2=value2%3A

  3. Nella chiamata di inizializzazione della sessione dal player, passate le coppie chiave-valore a MediaTailor come valore di un singolo parametro di query. Le seguenti chiamate di esempio forniscono le coppie chiave-valore di esempio per il reporting del tracciamento degli annunci lato server e lato client.

    • Richieste di esempio per la segnalazione del tracciamento degli annunci sul lato server, utilizzando coppie con codifica URL

      HLS:

      <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

      DASH:

      <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

    • Esempio di richiesta di report sul tracciamento degli annunci sul lato client, senza codifica URL

      HLS:

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

      DASH:

      POST <manifest>.mpd
    {
        "adsParams": {
           "param1": "value1:",
           "param2": "value2:"
       }
    }

Per i report lato server, MediaTailor decodifica i parametri quando viene ricevuta la richiesta del giocatore. Per i report lato client, non altera i parametri ricevuti nel payload. JSON MediaTailor invia la seguente richiesta a: ADS

https://my.ads.com/<path>?param1=value1:&param2=value2:

In questo modo, param1 le coppie param2 chiave-valore vengono incluse nella richiesta come parametri di interrogazione di prima classe. ADS