Dengan Ad Break API Penyisipan Iklan Dinamis (DAI), Anda dapat membuat dan mengelola data penargetan iklan dan pengaturan waktu jeda iklan berikutnya di livestream Anda.
Dengan DAI Ad Break API, Anda dapat melakukan hal berikut:
- Meningkatkan rasio pengisian iklan selama traffic puncak: Berikan lebih banyak waktu kepada layanan DAI untuk memilih iklan dengan hasil tertinggi untuk acara live Anda. Sebaiknya gunakan DAI Ad Break API jika acara livestream Anda memiliki konkurensi tinggi, tag iklan dinamis, atau iklan dengan latensi tinggi.
- Kontrol penuh jeda iklan Anda: Buat, perbarui, dan hapus jeda iklan di awal, yang menawarkan fleksibilitas lebih besar daripada sinyal iklan dalam manifes dan rasio pengisian yang lebih tinggi untuk penayangan pod dibandingkan dengan keputusan tepat waktu.
- Memberikan pengalaman penonton yang lancar: Minimalkan error pemutaran terkait iklan seperti jeda iklan yang kurang terisi atau terlalu penuh dengan memberikan informasi jeda yang akurat.
Panduan ini menjelaskan metode DAI Ad Break API dan memandu Anda melalui siklus proses jeda iklan untuk alur Layanan Lengkap DAI dan Penayangan Pod.
Mempelajari metode API jeda iklan DAI
API ini mengekspos metode standar berikut untuk mengelola resource AdBreak:
Create: Menentukan entityAdBreakbaru untuk entityLiveStreamEvent. Secara opsional, tetapkan propertiexpectedStartTimeuntuk menjadwalkan keputusan iklan agar dimulai dalam waktu 60 detik sebelum jeda iklan dimulai.Get: Mengambil detail entitasAdBreaktertentu, termasuk status jeda iklan dan metadata pengaturan waktu.List: Menampilkan daftar entityAdBreakyang sebelumnya dibuat dengan API untuk entityLiveStreamEventtertentu, yang diurutkan dalam urutan kronologis terbalik. Perhatikan bahwa API tidak menampilkan jeda iklan yang hanya ditentukan dalam manifes streaming konten.Update: Mengubah entityAdBreakyang ada sebelum keputusan iklan dimulai.Delete: Membatalkan keputusan iklan untuk entitasAdBreakyang dibuat sebelumnya.
Memahami siklus proses jeda iklan
Entity AdBreak memiliki status berikut:
BREAK_STATE_UNSPECIFIED: Status default.BREAK_STATE_SCHEDULED: Jeda iklan telah berhasil dibuat dan dijadwalkan untuk keputusan iklan.BREAK_STATE_DECISIONED: Layanan DAI telah memulai proses pemilihan iklan untuk jeda iklan. Anda tidak dapat mengubah jeda iklan, tetapi masih dapat membatalkan jeda iklan dengan potensi efek buruk pada server iklan.
BREAK_STATE_COMPLETE: Jeda iklan telah ditayangkan kepada pengguna.BREAK_STATE_EXPIRED: Jeda iklan berakhir sebelum ditayangkan. Hanya berlaku jika Anda mengaktifkan penjadwalan beberapa jeda di acara livestream. Untuk mengetahui detailnya, lihat Setelan jeda iklan mid-roll. Secara default, jeda iklan akan berakhir 30 menit setelah nilai kolomexpectedStartTime, atau 30 menit setelah penentuan dimulai jika Anda tidak menetapkan kolomexpectedStartTime. Anda dapat menyesuaikan durasi ini menggunakan kolomexpireDuration.
Diagram berikut menunjukkan linimasa entity AdBreak, dari pembuatan
hingga penyelesaian.

Anda dapat membuat entity AdBreak dari 1 hingga 300 menit sebelum jeda iklan
diperkirakan akan dimulai.
- Hindari membuat jeda iklan kurang dari satu menit sebelum perkiraan waktu mulai jeda, karena DAI Google mungkin tidak memiliki cukup waktu untuk membuat keputusan iklan, sehingga menyebabkan rasio pengisian iklan yang lebih rendah.
- Jangan membuat jeda iklan lebih dari 6 jam sebelum perkiraan waktu mulai jeda, karena server iklan mungkin akan membatalkan iklan yang diminta.
Bagian berikut membahas transisi status jeda iklan dalam alur Layanan Lengkap DAI dan Penayangan Pod.
Memahami alur DAI Layanan penuh
DAI Layanan Lengkap Google mengelola manifes konten dan pod iklan.
Untuk penargetan iklan kustom, gunakan DAI Ad Break API untuk membuat entity AdBreak
sebelum penanda iklan yang sesuai dalam manifes livestream konten.
- Waktu tunggu ini memungkinkan layanan DAI Google menggunakan data
AdBreakAnda untuk keputusan iklan. - Saat Google DAI mendeteksi penanda iklan manifes, sistem akan menggunakan keputusan iklan dengan data entity
AdBreakdan mentransisikan status entity keBREAK_STATE_COMPLETE.
Saat mengaktifkan penjadwalan multi-jeda di acara livestream, Anda dapat menetapkan kolom matchParams di entity AdBreak. Proses ini memungkinkan DAI Google mencocokkan
penanda iklan manifes yang terdeteksi dengan jeda iklan dalam status BREAK_STATE_SCHEDULED atau
BREAK_STATE_DECISIONED.

Memahami alur penyajian Pod
Dalam alur ini, Anda mengelola manifes livestream konten atau menggunakan layanan manipulasi manifes pihak ketiga untuk mendeteksi penanda iklan dalam manifes.
Panggil DAI Ad Break API sebelum waktu mulai jeda iklan yang diharapkan untuk membuat
entitas AdBreak sebelum Anda perlu meminta segmen pod iklan atau manifes
iklan.
Saat video stitcher mendeteksi penanda iklan manifes dan membuat permintaan segmen iklan dengan ID jeda iklan, DAI Google akan menggunakan data AdBreak dengan ID yang sama untuk keputusan iklan.
Setelah klien Anda meminta media iklan, entitas AdBreak yang Anda buat melalui
API akan beralih ke status BREAK_STATE_COMPLETE.

Membuat permintaan pertama Anda
Untuk menyiapkan akses API dan membuat permintaan pertama Anda, lihat Menggunakan DAI Ad Break API.