Mempelajari DAI Ad Break API

Dynamic Ads Insertion (DAI) Ad Break API memungkinkan Anda membuat dan mengelola data penargetan iklan dan waktu jeda iklan mendatang di live stream Anda.

Dengan DAI Ad Break API, Anda dapat melakukan hal berikut:

• Meningkatkan rasio pengisian iklan selama traffic puncak: Beri layanan Penyisipan Iklan Dinamis (DAI) lebih banyak waktu untuk memilih iklan dengan hasil tertinggi untuk acara live Anda. Sebaiknya gunakan DAI Ad Break API saat peristiwa livestream Anda memiliki konkurensi tinggi, tag iklan dinamis, atau iklan latensi tinggi.
• Kendalikan jeda iklan sepenuhnya: Buat, perbarui, dan hapus jeda iklan di awal, sehingga menawarkan fleksibilitas yang lebih besar daripada pensinyalan iklan dalam manifes dan rasio pengisian yang lebih tinggi untuk penayangan pod dibandingkan dengan pengambilan keputusan tepat waktu.
• Memberikan pengalaman menonton yang lancar: Minimalkan error pemutaran terkait iklan seperti pod iklan yang kurang atau terlalu banyak diisi dengan memberikan informasi jeda yang akurat.

Panduan ini menjelaskan metode DAI Ad Break API dan memandu Anda melalui siklus proses jeda iklan untuk alur Penayangan Pod dan Layanan Penuh DAI.

Mempelajari metode DAI Ad Break API

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 entity AdBreak tertentu, termasuk metadata waktu dan status jeda iklan.
• List: Menampilkan daftar entity AdBreak yang dibuat sebelumnya dengan API untuk entity LiveStreamEvent tertentu, yang diurutkan dalam urutan kronologis terbalik. Perhatikan bahwa API tidak menampilkan jeda iklan yang ditentukan hanya 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

Entitas 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.

Perhatian: Membatalkan jeda iklan selama status BREAK_STATE_DECISIONED mencegah server iklan menayangkan iklan, yang dapat berdampak negatif pada fungsi pembatasan frekuensi dan penganggaran server iklan.

• BREAK_STATE_COMPLETE: Jeda iklan telah ditayangkan kepada pengguna.

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

Anda dapat membuat entity AdBreak dari 1 hingga 300 menit sebelum jeda iklan diperkirakan dimulai.

• Hindari membuat jeda iklan kurang dari satu menit sebelum waktu mulai jeda yang diharapkan, karena Google DAI mungkin tidak memiliki cukup waktu untuk keputusan iklan, sehingga menyebabkan rasio pengisian iklan yang lebih rendah.
• Jangan membuat jeda iklan lebih dari 6 jam sebelum waktu mulai jeda yang diharapkan, karena server iklan dapat membatalkan validitas iklan yang diminta.

Catatan: Menonaktifkan acara live stream akan menghapus jeda iklan dalam status BREAK_STATE_SCHEDULED atau status BREAK_STATE_DECISIONED.

Bagian berikut membahas transisi status jeda iklan dalam alur Penayangan Pod dan Layanan Penuh DAI.

Memahami alur DAI Layanan lengkap

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 live streaming 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 entitas AdBreak dan mentransisikan status entitas ke BREAK_STATE_COMPLETE.

Perhatian: Saat Google DAI mendeteksi penanda iklan manifes dan entitas AdBreak memiliki status BREAK_STATE_SCHEDULED, sistem tidak menggunakan data AdBreak. Entitas AdBreak tetap dalam status BREAK_STATE_SCHEDULED hingga Anda memanggil metode penghapusan untuk membatalkan jeda iklan.

Memahami alur penayangan 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 yang diharapkan untuk jeda iklan, guna membuat entitas AdBreak sebelum Anda perlu meminta segmen pod iklan atau manifes iklan.

Saat penyambung video mendeteksi penanda iklan manifes dan membuat permintaan segmen iklan dengan ID jeda iklan, DAI Google menggunakan data AdBreak dengan ID yang sama untuk keputusan iklan.

Setelah klien Anda meminta media iklan, entitas AdBreak yang Anda buat melalui API akan bertransisi ke status BREAK_STATE_COMPLETE.

Membuat permintaan pertama Anda

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