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 pengiring. URL tag iklan dikonfigurasi dalam permintaan pembuatan sesi. Untuk mengetahui informasi selengkapnya, lihat membuat sesi live dan membuat sesi VOD.

Sebelum memulai

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

Pengantar

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

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 pemain 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 ditayangkan. 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 pelihat 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 sisi klien VOD

Objek interstisial ditampilkan sebagai respons atas permintaan pembuatan sesi VOD. Untuk mengetahui petunjuk cara membuat sesi VOD, lihat membuat sesi VOD.

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

Pelacakan iklan sisi klien langsung

Video Stitcher API terus menyisipkan iklan ke dalam 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 dalam elemen <EventStream> untuk setiap elemen <Period>.

Untuk detail selengkapnya, lihat Cara menangani pelacakan sisi klien langsung.

Iklan pengiring

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

Langkah selanjutnya