View a markdown version of this page

MediaTailor variabel pemain untuk permintaan ADS - AWS Elemental MediaTailor

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

MediaTailor variabel pemain untuk permintaan ADS

AWS Elemental MediaTailor mengirimkan data yang diterima dari pemutar ke ADS saat Anda mengonfigurasi AWS Elemental MediaTailor untuk menentukan player_params.<query_parameter_name> variabel dalam URL ADS template. Misalnya, jika pemain mengirimkan parameter kueri yang diberi nama 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 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. Di AWS Elemental MediaTailor, konfigurasikan URL template 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, nilai kunci URL-encode berpasangan pada pemain. Ketika MediaTailor menerima permintaan inisialisasi sesi, itu nil URL-decodes ainya sekali sebelum menggantinya ke URL permintaan ADS.

    catatan

    Jika ADS Anda memerlukan URL-encoded nilai, nil URL-encode ainya dua kali pada pemutar. Dengan cara ini, decoding yang dilakukan oleh MediaTailor menghasilkan nilai yang pernah dikodekan untuk ADS.

    Misalnya, jika representasi diterjemahkan dari nilai yang dikirim ke ADS adalahparam1=value1:&param2=value2:, maka URL-encoded representasinya adalahparam1=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 kunci-nilai untuk pelaporan pelacakan iklan sisi server dan klien.

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

      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 URL-encoding

      HLS:

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

      TANDA HUBUNG:

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

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

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

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