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 meneruskan.

Untuk meneruskan informasi sesi dan pemain ke ADS

  1. Bekerja dengan ADS untuk menentukan informasi yang diperlukan untuk merespons kueri iklan AWS Elemental MediaTailor.

  2. Buat konfigurasi MediaTailor yang menggunakan URL permintaan ADS template yang memenuhi persyaratan ADS. Di URL, sertakan parameter statis dan sertakan placeholder untuk parameter dinamis. Masukkan URL templat 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 pemain, konfigurasikan permintaan inisiasi sesi AWS Elemental MediaTailor untuk memberikan 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 apakah Anda menginginkan pelaporan pelacakan iklan sisi server atau klien. Dalam kedua contoh panggilan, userID ditujukan untuk ADS dan auth_token ditujukan untuk asal:

    • (Opsi) Panggilan untuk pelaporan pelacakan iklan sisi server — Awali parameter yang ingin Anda kirim MediaTailor ke ADS. ads Biarkan awalan mati untuk parameter yang ingin Anda kirim MediaTailor 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 — Berikan 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, AWS Elemental MediaTailor ganti variabel dalam URL permintaan ADS template dengan data sesi dan parameter pemainads. 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 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 menyertakan nama host ADS.

Contoh berikut menunjukkan beberapa cara agar Anda dapat 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 melewati elemen jalur dan kunci itu sendiri, bukan hanya nilai. Contoh: 

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