Mempelajari DAI Ad Break API

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 entity AdBreak baru untuk entity LiveStreamEvent. Secara opsional, tetapkan properti expectedStartTime untuk menjadwalkan keputusan iklan agar dimulai dalam waktu 60 detik sebelum jeda iklan dimulai.
  • Get: Mengambil detail entitas AdBreak tertentu, termasuk status jeda iklan dan metadata pengaturan waktu.
  • List: Menampilkan daftar entity AdBreak yang sebelumnya dibuat dengan API untuk entity LiveStreamEvent tertentu, yang diurutkan dalam urutan kronologis terbalik. Perhatikan bahwa API tidak menampilkan jeda iklan yang hanya ditentukan dalam manifes streaming konten.
  • Update: Mengubah entity AdBreak yang ada sebelum keputusan iklan dimulai.
  • Delete: Membatalkan keputusan iklan untuk entitas AdBreak yang 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 kolom expectedStartTime, atau 30 menit setelah penentuan dimulai jika Anda tidak menetapkan kolom expectedStartTime. Anda dapat menyesuaikan durasi ini menggunakan kolom expireDuration.

Diagram berikut menunjukkan linimasa entity AdBreak, dari pembuatan hingga penyelesaian.

Entitas jeda iklan 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 AdBreak Anda untuk keputusan iklan.
  • Saat Google DAI mendeteksi penanda iklan manifes, sistem akan menggunakan keputusan iklan dengan data entity AdBreak dan mentransisikan status entity ke BREAK_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.

Entitas jeda iklan dari pembuatan hingga penyelesaian dalam alur DAI Layanan penuh.

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.

Status selesai entitas jeda iklan.

Membuat permintaan pertama Anda

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