View a markdown version of this page

MediaTailor meneruskan parameter ke ADS - AWS Elemental MediaTailor
Penggunaan lanjutan

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

MediaTailor meneruskan parameter ke ADS

AWS Elemental MediaTailor mendukung pengaturan variabel dinamis dalam MediaTailor permintaan ke ADS menggunakan langkah-langkah berikut.

Metode inisialisasi sesi

MediaTailor mendukung beberapa metode untuk inisialisasi sesi dan penerusan parameter:

  1. POST dengan Badan Permintaan: 

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

  2. Parameter Kueri di URL: 

    GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
penting

Anda hanya dapat menentukan parameter sekali, pada waktu inisialisasi. Alias konfigurasi diselesaikan ke nilai aktual sebelum diteruskan.

Untuk meneruskan informasi sesi dan pemain ke ADS

  1. Bekerja dengan ADS untuk menentukan informasi yang dibutuhkan untuk menanggapi permintaan iklan AWS Elemental MediaTailor.

  2. Buat konfigurasi MediaTailor yang menggunakan URL permintaan ADS template yang memenuhi persyaratan ADS. Dalam URL, sertakan parameter statis dan sertakan placeholder untuk parameter dinamis. Masukkan URL template Anda di bidang server keputusan iklan konfigurasi.

    Dalam contoh URL template berikut, correlation menyediakan data sesi, dan deviceType menyediakan data pemain: 

    https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]

  3. Pada pemutar, konfigurasikan permintaan inisiasi sesi AWS Elemental MediaTailor untuk menyediakan parameter untuk data pemain. Sertakan parameter Anda dalam permintaan inisiasi sesi, dan hilangkan dari permintaan berikutnya untuk sesi tersebut.

    Jenis panggilan yang dilakukan pemain untuk menginisialisasi sesi menentukan apakah pemain (klien) atau MediaTailor (server) menyediakan pelaporan pelacakan iklan untuk sesi tersebut. Untuk informasi tentang dua opsi ini, lihatMelaporkan data pelacakan iklan.

    Lakukan salah satu jenis panggilan berikut, tergantung pada apakah Anda menginginkan pelaporan pelacakan iklan sisi server atau klien. Dalam kedua contoh panggilan, userID ditujukan untuk ADS dan auth_token dimaksudkan untuk asal:

    • (Opsi) Panggilan untuk pelaporan pelacakan iklan sisi server — Awali parameter yang ingin Anda ki MediaTailor rim ke ADS. ads Biarkan awalan mati untuk parameter yang MediaTailor ingin Anda kirim ke server asal:

      Contoh berikut menunjukkan permintaan masuk untuk HLS dan DASH ke AWS Elemental MediaTailor. MediaTailor menggunakan deviceType dalam permintaannya ke ADS dan auth_token dalam permintaannya ke server asal.

      Contoh HLS:

      GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh

      Contoh DASH:

      GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh

    • (Opsi) Panggilan untuk pelaporan pelacakan iklan sisi klien - Menyediakan parameter untuk ADS di dalam objek. adsParams

      Contoh HLS:

      POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

      Contoh DASH:

      POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

Saat pemain memulai sesi, ganti AWS Elemental MediaTailor variabel dalam URL permintaan ADS template dengan data sesi dan ads parameter pemain. Ini melewati parameter yang tersisa dari pemain ke server asal.

contoh MediaTailor permintaan dengan variabel iklan

Contoh berikut menunjukkan panggilan ke ADS dan server asal dari AWS Elemental MediaTailor yang sesuai dengan contoh panggilan inisialisasi sesi pemain sebelumnya:

  • MediaTailor memanggil ADS dengan data sesi dan jenis perangkat pemain: 

    https://my.ads.server.com/path?correlation=896976764&deviceType=ipad

  • MediaTailor memanggil server asal dengan token otorisasi pemain.

    • Contoh HLS:

      https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

    • Contoh DASH:

      https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

Penggunaan lanjutan

Anda dapat menyesuaikan permintaan ADS dengan berbagai cara dengan data pemain dan sesi. Anda hanya perlu memasukkan nama host ADS.

Contoh berikut menunjukkan beberapa cara untuk menyesuaikan permintaan Anda:

  • Gabungkan parameter pemain dan parameter sesi untuk membuat parameter baru. Contoh: 

    https://my.ads.com?key1=[player_params.value1][session.id]

  • Gunakan parameter pemain sebagai bagian dari elemen jalur. Contoh:

    https://my.ads.com/[player_params.path]?key=value

  • Gunakan parameter pemain untuk meneruskan elemen jalur dan kunci itu sendiri, bukan hanya nilai. Contoh: 

    https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]