View a markdown version of this page

Pre-ads permintaan - AWS Elemental MediaTailor
Ketika itu menyalaInputNamespace keluaran diizinkanKasus penggunaan yang khasPerilaku kegagalan

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

Pre-ads permintaan

Ketika itu menyala

MediaTailor menjalankan fungsi yang dipetakan satu PRE_ADS_REQUEST kali per jeda iklan, segera sebelum mengirim permintaan ke ADS. Fungsi berjalan setiap kali peluang iklan ditemui selama pemrosesan manifes.

Input

Semua bidang dariPRE_SESSION_INITIALIZATION, plusavail.*,scte.*,asset.*, dan adsRequest.* (url, metode, header, body). Untuk semua bidang yang tersedia, lihatReferensi bidang masukan.

Namespace keluaran diizinkan

Namespace Jenis yang diterima Bagaimana output digunakan
player_params.* String, angka, boolean Mengganti parameter pemutar sesi untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melaluiMediaTailor variabel iklan dinamis untuk permintaan ADS.
session.* String, angka, boolean Mengganti variabel sesi untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui substitusi variabel dinamis.
avail.* String, angka, boolean Penggantian memanfaatkan variabel untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui substitusi variabel dinamis.
scte.* String, angka, boolean Mengganti variabel SCTE untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui substitusi variabel dinamis.
asset.* String, angka, boolean Mengganti variabel metadata aset (dari EXT-X-ASSET tag) untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui substitusi variabel dinamis. Untuk informasi selengkapnya tentang penanda iklan HLS, lihat Penanda iklan HLS.
adsRequest.* String Mengganti permintaan ADS hanya untuk jeda iklan ini. Bidang yang didukung: urlmethod,,headers.<name>,body. urlNilai diperlakukan sebagai template dan mendukung MediaTailor variabel iklan dinamis untuk permintaan ADS setelah fungsi berjalan. Tidak bertahan.
catatan

Semua output dari PRE_ADS_REQUEST hook adalah penggantian sementara — hanya berlaku untuk permintaan ADS jeda iklan saat ini dan tidak dipertahankan ke sesi.

Contoh - menulis ulang permintaan ADS: 

{
    "Output": {
        "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}",
        "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}"
    }
}

Ini menggantikan URL ADS dan menambahkan header khusus untuk jeda iklan saat ini.

Kasus penggunaan yang khas

  • Tulis ulang URL permintaan ADS untuk merutekan lalu lintas antara server iklan yang berbeda untuk A/B pengujian.

  • Tambahkan data pengayaan (segmen audiens, token identitas) ke URL atau header permintaan ADS.

  • Ubah parameter permintaan ADS secara kondisional berdasarkan data SCTE-35 sinyal atau indeks yang tersedia.

Perilaku kegagalan

Jika fungsi yang dilampirkan PRE_ADS_REQUEST gagal karena alasan apa pun MediaTailor , membuang output fungsi dan melanjutkan seolah-olah tidak ada fungsi yang dilampirkan. Permintaan ADS dikirim menggunakan sesi asli dan parameter permintaan tanpa modifikasi.