View a markdown version of this page

PRE_ADS_REQUEST - AWS Elemental MediaTailor
Saat terbakarInputNamespace 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_REQUEST

Saat terbakar

MediaTailor menjalankan fungsi yang dipetakan menjadi PRE_ADS_REQUEST sekali 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.*, dan adsRequest.* (url, metode, header, badan). 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 Mengganti variabel yang tersedia 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.
adsRequest.* String Mengganti permintaan ADS untuk jeda iklan ini saja. 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 pada 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 antar 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 avail.

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.