Pilih preferensi cookie Anda

Kami menggunakan cookie penting serta alat serupa yang diperlukan untuk menyediakan situs dan layanan. Kami menggunakan cookie performa untuk mengumpulkan statistik anonim sehingga kami dapat memahami cara pelanggan menggunakan situs dan melakukan perbaikan. Cookie penting tidak dapat dinonaktifkan, tetapi Anda dapat mengklik “Kustom” atau “Tolak” untuk menolak cookie performa.

Jika Anda setuju, AWS dan pihak ketiga yang disetujui juga akan menggunakan cookie untuk menyediakan fitur situs yang berguna, mengingat preferensi Anda, dan menampilkan konten yang relevan, termasuk iklan yang relevan. Untuk menerima atau menolak semua cookie yang tidak penting, klik “Terima” atau “Tolak”. Untuk membuat pilihan yang lebih detail, klik “Kustomisasi”.

Menggunakan variabel iklan dinamis di MediaTailor

Mode fokus
Menggunakan variabel iklan dinamis di MediaTailor - AWS Elemental MediaTailor

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

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

AWS Elemental MediaTailor Permintaan ke server keputusan iklan (ADS) mencakup informasi tentang sesi penayangan saat ini, yang membantu ADS memilih iklan terbaik untuk diberikan dalam tanggapannya. Saat mengonfigurasi template ADS dalam MediaTailor konfigurasi, Anda dapat menyertakan variabel dinamis, yang juga dikenal sebagai makro. Variabel dinamis adalah string yang dapat diganti.

Variabel dinamis dapat mengambil bentuk berikut:

  • Nilai statis — Nilai yang tidak berubah dari satu sesi ke sesi berikutnya. Misalnya, jenis respons yang MediaTailor diharapkan dari ADS.

  • Variabel domain — Variabel dinamis yang dapat digunakan untuk domain URL, seperti my-ads-serverbagian.com dari URL http://my-ads-server.com. Untuk detailnya, lihat Menggunakan variabel domain.

  • Data sesi — Nilai dinamis yang disediakan oleh MediaTailor untuk setiap sesi, misalnya, ID sesi. Untuk detailnya, lihat Menggunakan variabel sesi.

  • Data pemain — Nilai dinamis yang disediakan oleh pemain untuk setiap sesi. Ini menjelaskan penampil konten dan membantu ADS menentukan iklan mana yang MediaTailor harus dimasukkan ke dalam aliran. Untuk detailnya, lihat Menggunakan variabel pemain.

Meneruskan parameter ke ADS

Langkah-langkah berikut menjelaskan cara mengatur variabel dinamis dalam MediaTailor permintaan ke ADS.

Untuk meneruskan informasi sesi dan pemain ke ADS
  1. Bekerja dengan ADS untuk menentukan informasi yang dibutuhkan sehingga dapat merespons kueri iklan dari 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

Parameter kueri manifes mendukung karakter dan batasan

Anda dapat menggunakan karakter berikut dalam parameter kueri yang digunakan dalam permintaan manifes:

  • Alfanumerik (A-Z, a-z, 0-9)

  • Periode (.)

  • Tanda hubung (-)

  • Garis bawah (_)

  • Garis miring belakang (\)

Keterbatasan panjang

Panjang total semua parameter kueri manifes (kunci dan nilai digabungkan) tidak boleh melebihi 2000 karakter.

Karakter yang tidak didukung

Anda tidak dapat menggunakan karakter berikut dalam parameter kueri manifes: : ? & = % / (garis miring maju)

Batasan panjang parameter kueri ADS

Batasan panjang berikut berlaku untuk parameter kueri yang digunakan dalam permintaan ke ADS:

  • Nama parameter ADS: 10000 karakter

  • Nilai parameter ADS: 25000 karakter

  • URL IKLAN: 25000 karakter

Penggunaan lanjutan

Anda dapat menyesuaikan permintaan ADS dengan berbagai cara dengan data pemain dan sesi. Satu-satunya persyaratan adalah memasukkan 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]

Untuk informasi selengkapnya tentang penggunaan variabel domain, sesi, dan pemain dinamis, pilih topik yang berlaku.

Di halaman ini

PrivasiSyarat situsPreferensi cookie
© 2025, Amazon Web Services, Inc. atau afiliasinya. Semua hak dilindungi undang-undang.