Menggunakan variabel pemain - AWS Elemental MediaTailor

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan variabel pemain

Untuk mengkonfigurasi AWS Elemental MediaTailor untuk mengirim data yang diterima dari pemain keADS, dalam template ADSURL, 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 ADS permintaan, sertakan [player_params.user_id] dalam ADS URL konfigurasi.

Ini memungkinkan Anda untuk mengontrol parameter kueri yang termasuk dalam ADS permintaan. Biasanya, Anda menambahkan parameter kueri khusus yang ADS mengenali ADS permintaan URL dan memberikan pasangan kunci-nilai 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. Masuk AWS Elemental MediaTailor, konfigurasikan template ADS permintaan URL untuk mereferensikan parameter. Berikut ini URL menunjukkan dimasukkannya 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 kunci-nilai pada pemain. Ketika MediaTailor menerima permintaan inisialisasi sesi, itu URL -decode nilai sekali sebelum menggantinya ke dalam permintaan. ADS URL

    catatan

    Jika Anda ADS membutuhkan nilai URL -encoded, URL -encode nilai dua kali pada pemain. Dengan cara ini, decoding yang dilakukan dengan MediaTailor menghasilkan nilai yang pernah dikodekan untuk. ADS

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

  3. Dalam panggilan inisialisasi sesi dari pemain, berikan pasangan kunci-nilai 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 -encoded URL

      HLS:

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

      DASH:

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

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

      HLS:

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

      DASH:

      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 keADS:

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