Mempelajari Stream Activity Monitor API

Dengan API Pemantauan Aktivitas Streaming (SAM) Penyisipan Iklan Dinamis (DAI), Anda dapat memeriksa dan memecahkan masalah sesi penayangan livestream dan video on demand (VOD) individual.

Untuk memeriksa dan memecahkan masalah sesi penayangan livestream atau VOD individual secara visual, gunakan Pemantauan Aktivitas Streaming di UI Google Ad Manager. Untuk mengambil data diagnostik sesi secara terprogram, gunakan resource networks.daiSessions Ad Manager API.

Memahami kasus penggunaan

Dengan SAM API, Anda dapat mengotomatiskan diagnostik streaming dan menyelesaikan masalah penayangan iklan di seluruh integrasi DAI, seperti berikut:

  • Verifikasi pembuatan sesi streaming: Konfirmasi parameter, mode penggabungan STITCHED atau POD_SERVING, mode pelaporan, dan metadata konten yang diterima Google DAI saat membuat sesi livestream atau VOD.
  • Audit permintaan dan respons iklan: Periksa tag iklan Video Ad Serving Template (VAST) dan Video Multiple Ad Playlist (VMAP) keluar, kode status HTTP, latensi respons, isi respons XML mentah, dan rantai pengalihan wrapper.
  • Memecahkan masalah keputusan dan materi iklan pod iklan: Verifikasi iklan yang dipilih atau dihapus oleh DAI Google untuk setiap pod, durasi setiap iklan dalam pod, dan sistem iklan sumber materi iklan.
  • Lacak eksekusi pengambilan data di awal iklan: Tentukan apakah DAI Google mengambil data di awal pod iklan dan periksa tahap pengambilan data di awal setiap pod iklan.
  • Memvalidasi panggilan DAI Ad Break API dan DAI API penayangan Pod: Periksa eksekusi jeda yang sebenarnya, durasi iklan yang ditayangkan, dan durasi slate yang disisipkan terhadap panggilan API, seperti DAI Ad Break API dan DAI API penayangan Pod.
  • Verifikasi pelacakan peristiwa iklan: Konfirmasi apakah ping pelacakan sisi klien atau sisi server berhasil dan periksa respons HTTP dari server iklan.
  • Otomatiskan pemantauan dan pemberitahuan sesi: Mengurai entri temuan terstruktur dengan tingkat keparahan INFO, WARNING, atau ERROR untuk mendeteksi masalah pemutaran atau monetisasi dalam pengujian integrasi otomatis dan pipeline pemantauan produksi.

Mempelajari resource tingkat teratas

SAM API adalah bagian dari REST API Google Ad Manager (Beta) di endpoint admanager.googleapis.com dan mengekspos metode hanya baca networks.daiSessions.get. Anda dapat mengkueri resource DaiSession dengan ID sesi DAI atau kunci debug kustom. DAI menyimpan data sesi hingga tiga hari setelah pemutaran.

SAM API tidak mendukung pencantuman semua resource DaiSession di jaringan Google Ad Manager.

Memeriksa respons streaming DAI dengan SAM

Untuk memverifikasi cara DAI Google memproses permintaan streaming Anda, periksa respons DaiSession:

  • DAI API layanan lengkap: Periksa kolom creationContext.streamCreateRequest untuk memverifikasi panggilan pendaftaran streaming, periksa peta adSelections dan adPods untuk meninjau keputusan iklan, dan periksa peta adBreaks untuk mengonfirmasi durasi iklan gabungan, materi iklan slate, dan konten dasar.
  • DAI API penayangan pod: Pastikan kolom creationContext.stitchingType ditetapkan ke nilai POD_SERVING, periksa kembali kolom adBreakId di peta adPods dan adBreaks dengan panggilan permintaan manifes pod atau segmen pod, dan periksa beacon sisi server atau verifikasi media di peta trackingPings.
  • DAI Ad Break API: Cocokkan nilai breakSequence objek AdBreak dengan properti AdBreak.breakSequence.

Membuat permintaan pertama Anda

Untuk menyiapkan autentikasi dan mengambil resource sesi DAI, lihat Menggunakan Stream Activity Monitor API.