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 informasi tentang pemformatan yang didukung untuk parameter kueri, lihat Parameter kueri manifes mendukung karakter dan batasan danBatasan panjang parameter kueri ADS.
-
Untuk penyesuaian tambahan pada permintaan ADS, lihat. Penggunaan lanjutan
Untuk meneruskan informasi sesi dan pemain ke ADS
-
Bekerja dengan ADS untuk menentukan informasi yang dibutuhkan sehingga dapat merespons kueri iklan dari AWS Elemental MediaTailor.
-
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, dandeviceType
menyediakan data pemain:https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
-
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 danauth_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 danauth_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.