View a markdown version of this page

Post-ads tanggapan - AWS Elemental MediaTailor
Ketika itu menyalaInputNamespace keluaran diizinkanApa yang tidak dilihat kait iniKasus penggunaan yang khasPerilaku kegagalan

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

Post-ads tanggapan

Ketika itu menyala

MediaTailor menjalankan fungsi yang dipetakan POST_ADS_RESPONSE setelah menerima dan mengurai respons dari ADS, termasuk resolusi pengalihan pembungkus VAST. Fungsi ini melihat iklan yang diurai sebelum MediaTailor memilih iklan untuk disisipkan, jadi perubahan yang dilakukan di sini memengaruhi iklan mana yang mengisi jeda iklan.

Hook diaktifkan untuk semua protokol streaming (HLS dan DASH) dan semua mode pemutaran (live, VOD, dan pre-roll). Biasanya menyala sekali per jeda iklan. Untuk respons ADS yang mencakup beberapa jeda iklan sekaligus (seperti respons VMAP) dan untuk respons iklan yang telah diambil sebelumnya, hook diaktifkan saat mem MediaTailor proses respons, dan namespace avail input tidak ada. Gunakan $exists(avail) untuk memeriksa sebelum mengakses bidang yang tersedia.

Input

event.*,session.*,adsRequest.*, danadsResponse.*, ditambah avail.* ketika respons berlaku untuk jeda iklan tunggal. Untuk semua bidang yang tersedia, lihatReferensi bidang masukan.

Namespace keluaran diizinkan

Namespace Jenis yang diterima Bagaimana output digunakan
adsResponse.ads Array objek iklan Mengganti daftar iklan yang diurai untuk respons ini. MediaTailor mencocokkan setiap iklan yang dikembalikan dengan iklan asli adId dan melanjutkan ke pemilihan iklan dengan daftar yang dikembalikan.
temp.* Setiap Data sementara untuk meneruskan nilai antar langkah dalam eksekutor. Tidak bertahan.

Tulis kembali daftar iklan yang dimodifikasi keadsResponse.ads. Anda dapat:

  • Filter — mengembalikan subset dari iklan asli. Iklan yang Anda hilangkan tidak dipertimbangkan untuk disisipkan, dan durasi yang ditempati tersedia untuk diisi iklan lain.

  • Mengatur ulang — mengembalikan iklan dalam urutan yang berbeda. Urutan memengaruhi iklan mana yang mengisi jeda iklan terlebih dahulu.

  • U bah — durationSeconds ubahadSystem,adTitle,mediaFiles,, atau trackingEvents pada iklan. Iklan yang ditampilkan tidak berubah menyimpan semua metadata VAST aslinya.

  • Injeksi — tambahkan iklan yang tidak ada dalam respons asli. Entri baru harus mencakupadId,durationSeconds, danmediaFiles. Iklan yang diambil dengan VAST_REQUEST fungsi dalam pemanggilan kait yang sama adalah pengecualian: menambahkan iklan semacam itu sudah adId cukup, karena MediaTailor mengembalikan data VAST lengkap yang diurai dari iklan. Untuk informasi selengkapnya, lihat Permintaan VAST.

penting

Selalu gunakan konstruktor array JSONata atau paksaan array saat memfilter. Ekspresi filter seperti adsResponse.ads[adSystem != 'BLOCKED'] menghasilkan satu objek ketika tepat satu iklan cocok. Ini tidak menghasilkan nilai sama sekali ketika nol iklan cocok. Dalam hal ini kunci output dihilangkan dan filter tidak berpengaruh. Bungkus ekspresi dalam tanda kurung atau tambahkan: []

{
    "Output": {
        "adsResponse.ads": "{%adsResponse.ads[adSystem != 'BLOCKED'][]%}"
    }
}

Aturan berikut berlaku untuk daftar iklan yang dikembalikan:

  • Jika dua entri berbagi adId satu, kejadian pertama menang.

  • Entri yang tidak valid ditolak secara individual. Entri yang valid dalam output yang sama masih berlaku.

  • Jika entri yang disuntikkan adId bertabrakan dengan iklan dari respons ADS, iklan asli digunakan sebagai basis dan perubahan bidang Anda diterapkan di atasnya.

Apa yang tidak dilihat kait ini

Pengait ini berjalan sebelum pemilihan iklan, sehingga tidak melihat iklan yang disumbangkan oleh MediaTailor fitur lain nanti, dan tidak dapat menentukan iklan mana yang pada akhirnya akan dimasukkan, karena status transkode dan keputusan pengisian terjadi setelahnya. Untuk iklan yang diambil sebelumnya, hook diaktifkan saat mem MediaTailor proses respons prefetch itu sendiri. Pada jeda iklan berikutnya, iklan yang sebelumnya diambil sebelumnya digabungkan setelah hook ini berjalan, sehingga hook tidak melihatnya di sana. Untuk bertindak pada set iklan akhir, gunakanPRE_MANIFEST_INSERTION.

Kasus penggunaan yang khas

  • Filter iklan berdasarkan metadata, seperti menghapus iklan dari sistem iklan yang bersaing sehingga iklan tersebut tidak muncul dalam jeda iklan yang sama (pemisahan kompetitif).

  • Ambil iklan tambahan dari server iklan sekunder dengan VAST_REQUEST fungsi saat respons utama pendek, dan tambahkan ke daftar iklan.

  • Susun ulang iklan sehingga iklan pilihan mengisi jeda iklan terlebih dahulu.

  • Ubah peristiwa pelacakan atau metadata iklan sebelum penyisipan.

Perilaku kegagalan

Jika fungsi yang dilamp POST_ADS_RESPONSE irkan gagal karena alasan apa pun, seperti batas waktu, kesalahan ekspresi, atau output yang tidak valid, MediaTailor membuang output fungsi. Permintaan dilanjutkan dengan respons ADS asli, seolah-olah tidak ada fungsi yang dilampirkan. Jika input serial melebihi batas ukuran input, mele MediaTailor watkan pemanggilan kait sepenuhnya. Untuk batasan yang berlaku, lihatBatas.