Metadata iklan

Panduan ini menjelaskan fitur metadata iklan yang didukung dari Video Stitcher API. Metadata iklan diekstrak dari iklan VAST dalam respons tag iklan, yang berisi peristiwa pelacakan iklan dan iklan pendamping. URL tag iklan dikonfigurasi dalam permintaan pembuatan sesi. Untuk mengetahui informasi selengkapnya, lihat Mengelola sesi live dan Mengelola sesi VOD.

Sebelum memulai

Pastikan Anda memahami konsep dan terminologi pengantar di Video Stitcher API. Untuk mengetahui informasi selengkapnya, lihat ringkasan teknis.

Pengantar

Metadata iklan berisi peristiwa pelacakan iklan dan iklan pendamping yang terkait dengan iklan yang digabungkan. Peristiwa pelacakan iklan berisi ping callback yang digunakan untuk melacak iklan VAST dan interaksi penonton. Iklan pengiring adalah iklan untuk melengkapi iklan VAST induk. Dalam mode pelacakan sisi klien, Anda bertanggung jawab untuk memicu peristiwa berdasarkan perilaku penonton.

Pelacakan iklan sisi server

Dalam mode pelacakan sisi server, setiap URI segmen iklan digabungkan dalam URI pengalihan dan Video Stitcher API akan menangani pemrosesan peristiwa progres setiap kali pemutar meminta segmen tersebut. Namun, peristiwa aktivitas, seperti pause, tidak ditangani oleh Video Stitcher API.

Pelacakan iklan sisi klien

Dalam mode pelacakan sisi klien, klien bertanggung jawab untuk memicu peristiwa. Untuk detail selengkapnya, lihat dokumentasi peristiwa.

Peristiwa progres adalah peristiwa yang harus dipicu saat waktu yang ditentukan telah berlalu selama iklan. Misalnya, peristiwa Start harus dipicu di awal iklan. Untuk mengetahui detail selengkapnya tentang peristiwa progres, lihat objek peristiwa progres.

Peristiwa aktivitas adalah peristiwa yang harus dipicu saat penonton melakukan aktivitas tertentu. Misalnya, peristiwa pause harus dipicu saat penonton menjeda video iklan. Untuk mengetahui detail selengkapnya tentang peristiwa aktivitas, lihat objek peristiwa aktivitas.

Pelacakan iklan VOD dari sisi klien

Objek interstisial ditampilkan dalam respons permintaan pembuatan sesi VOD. Untuk petunjuk cara membuat sesi VOD, lihat cara membuat sesi VOD.

Interstisial berisi metadata untuk setiap iklan yang disisipkan. Saat mode pelacakan iklan klien diaktifkan, klien bertanggung jawab untuk memicu peristiwa pelacakan jika diperlukan. Untuk mengetahui detail selengkapnya, lihat objek interstisial.

Pelacakan iklan live dari sisi klien

Video Stitcher API terus menyisipkan iklan ke live stream; informasi metadata iklan dihasilkan setiap kali iklan baru disisipkan.

Untuk HLS, AdMetadataURI untuk mengambil metadata iklan dapat ditemukan di tag #EXT-X-DATERANGE.

Untuk DASH, AdMetadataURI untuk mengambil metadata iklan dapat ditemukan di elemen <EventStream> untuk setiap elemen <Period>.

Untuk mengetahui detail selengkapnya, lihat cara menangani pelacakan sisi klien secara real time.

Iklan pengiring

Iklan pengiring adalah iklan tambahan yang dapat muncul bersama dengan iklan linear yang disisipkan. Untuk detail selengkapnya, lihat objek iklan pendamping.

Langkah selanjutnya