Pod Serve API menyediakan akses ke pod iklan video dengan kecepatan bit adaptif yang disiapkan sedemikian rupa sehingga dapat digabungkan langsung ke dalam playlist media HLS atau MPEG DASH yang ditampilkan kepada pengguna.
API ini ditujukan untuk penayang tingkat lanjut dan partner teknologi video. Penggunaan API ini dalam skala besar memerlukan desain dan penerapan alur kerja penayangan media canggih yang berada di luar cakupan dokumentasi ini.
Prasyarat
Sebelum memproses livestream melalui API Podserving DAI, Anda harus membuat peristiwa livestream menggunakan UI Google Ad Manager, atau API peristiwa langsung.
Komponen
Ada tiga komponen yang membentuk implementasi API Penayangan Pod: Google Ad Manager, pemutar video klien, dan server manipulasi manifes.
Ad Manager
Ad Manager bertanggung jawab untuk menayangkan iklan kepada pengguna dan dapat dikelola melalui SDK Ad Manager atau antarmuka webnya. Layanan tersebut memiliki tanggung jawab berikut:
- Menerima permintaan streaming dari pemutar video klien, mengambil keputusan iklan, dan memberikan rendisi agar sesuai dengan profil encoding konten
- Merespons permintaan segmen iklan dari pemutar video klien dan memberikan bagian pod iklan yang sesuai untuk pengguna tertentu
- Menerima dan memproses ping pelacakan dari pemutar video klien
Pemutar video klien
Pemutar video klien adalah aplikasi atau situs yang digunakan klien untuk memutar streaming video yang dihasilkan. Pemain memiliki tanggung jawab berikut:
- Melakukan inisialisasi resource streaming dari Ad Manager dan menerima objek streaming yang mewakili satu sesi pemutaran dari peristiwa livestream tertentu.
- Meminta manifes streaming dari server manipulasi manifes, yang memulai pemutaran
- Melakukan polling metadata pod iklan secara berkala dari Ad Manager yang menjelaskan peristiwa iklan yang disematkan dalam segmen iklan streaming
- Memproses peristiwa metadata dengan waktu yang dipicu oleh pemutar yang berisi ID media iklan. Setelah menemukan peristiwa ini, pemain meneruskannya ke Ad Manager untuk memverifikasi bahwa peristiwa iklan telah berhasil terjadi.
Untuk mempelajari lebih lanjut penerapan pemutar video klien yang benar, lihat panduan penayangan pod untuk platform Anda:
Untuk implementasi kustom, lihat panduan klien penayangan pod untuk DAI API.
Server manipulasi manifes
Server manipulasi manifes adalah server yang bertanggung jawab untuk menghosting manifes streaming yang disediakan ke pemutar video klien. Server memiliki tanggung jawab berikut:
- Menangani pengiriman manifes ke pemutar video klien
- Meminta template periode dari Ad Manager (khusus streaming DASH MPEG), untuk diisi dengan segmen iklan.
- Memasukkan URL segmen iklan yang dihosting Ad Manager ke dalam manifes streaming video (untuk HLS) atau periode iklan (untuk MPEG DASH) selama jeda iklan.
- Menyajikan manifes yang telah diubah ke pemutar video klien.
Untuk mempelajari lebih lanjut cara menerapkan server manipulator manifes kustom, lihat panduan manipulasi manifes.
Glosarium
- Peristiwa livestream: Peristiwa yang menyimpan data konfigurasi penting untuk livestream, seperti profil encoding. Acara livestream dibuat menggunakan Ad Manager.
- Objek streaming: Objek yang mewakili satu sesi pemutaran dari aset video tertentu. Properti penting mencakup ID aliran data dan URL verifikasi media.
- Pod iklan: Pengelompokan video iklan yang ditampilkan dalam jeda iklan
- Segmen iklan: File segmen media untuk jeda iklan
- Metadata pod iklan: Metadata untuk jeda iklan yang digunakan untuk merender UI iklan pada klien; misalnya, menyembunyikan tombol pencari selama iklan
- ID media iklan: Metadata yang dienkode sebagai tag ID3 dalam file segmen iklan. Metadata ini digunakan untuk mengidentifikasi kapan peristiwa terkait iklan tertentu terjadi selama pemutaran, seperti awal atau titik tengah iklan.