Menggunakan variabel pemain

Untuk mengonfigurasi AWS Elemental MediaTailor untuk mengirim data yang diterima dari pemain ke ADS, di URL ADS template, tentukan player_params.<query_parameter_name> variabel. Misalnya, jika pemain mengirimkan parameter kueri yang disebutkan user_id dalam permintaannya ke MediaTailor, untuk meneruskan data tersebut dalam permintaan ADS, sertakan [player_params.user_id] dalam konfigurasi URL ADS.

Ini memungkinkan Anda untuk mengontrol parameter kueri yang disertakan dalam permintaan ADS. Biasanya, Anda menambahkan parameter kueri khusus yang dikenali ADS ke URL permintaan ADS dan memberikan pasangan nilai kunci sebagai nilai parameter.

Contoh yang digunakan dalam prosedur berikut menggunakan pasangan kunci-nilai berikut:

• param1 dengan nilai nilai1:

• param2 dengan nilai nilai2:

Untuk menambahkan parameter kueri sebagai pasangan kunci-nilai

1. DiAWS Elemental MediaTailor, konfigurasikan URL templat permintaan ADS untuk mereferensikan parameter. URL berikut menunjukkan penyertaan parameter contoh:

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

2. (Opsional) Untuk pelaporan pelacakan iklan sisi server, url-encode pasangan nilai kunci pada pemutar. Saat MediaTailor menerima permintaan inisialisasi sesi, URL menerjemahkan nilai satu kali sebelum menggantinya ke URL permintaan ADS.

   catatan

   Jika ADS Anda memerlukan nilai yang disandikan URL, url-encode nilai dua kali pada pemutar. Dengan cara ini, decoding yang dilakukan dengan MediaTailor menghasilkan nilai yang pernah dikodekan untuk ADS.

   Misalnya, jika representasi decoded dari nilai yang dikirim ke ADS adalahparam1=value1:&param2=value2:, maka representasi yang disandikan URL adalah. param1=value1%3A&param2=value2%3A

3. Dalam panggilan inisialisasi sesi dari pemain, berikan pasangan kunci-nilai ke MediaTailor sebagai nilai parameter kueri tunggal. Contoh panggilan berikut memberikan contoh pasangan nilai kunci untuk pelaporan pelacakan iklan sisi server dan klien.

   • Contoh permintaan untuk pelaporan pelacakan iklan sisi server - menggunakan pasangan yang disandikan URL

     HLS:

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

     TANDA HUBUNG:

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

   • Contoh permintaan untuk pelaporan pelacakan iklan sisi klien - tanpa pengkodean URL

     HLS:

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

     TANDA HUBUNG:

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

Untuk pelaporan sisi server, MediaTailor menerjemahkan parameter saat permintaan pemain diterima. Untuk pelaporan sisi klien, itu tidak mengubah parameter yang diterima di payload JSON. MediaTailor mengirimkan permintaan berikut ke ADS:

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

Dengan cara ini, pasangan param2 nilai kunci param1 dan kunci disertakan sebagai parameter kueri kelas satu dalam permintaan ADS.