Mulai menggunakan SGAI untuk live stream

Penyisipan iklan yang dipandu server (SGAI) menyediakan manifes pod iklan yang siap digabungkan di perangkat klien. Jika Anda telah mengaktifkan DAI Penayangan Pod di jaringan Google Ad Manager, Anda memiliki akses untuk menggunakan SGAI. Jika Anda belum mengaktifkan DAI Penayangan Pod, hubungi Account Manager Anda.

Dengan SGAI, Anda menggunakan endpoint API Penayangan pod untuk membuat streaming yang mengambil metadata iklan dan manifes pod iklan.

Jika memiliki server manipulasi manifes, Anda dapat membuat URL manifes pod iklan dan menyisipkan penanda iklan yang berisi informasi manifes pod iklan di streaming konten Anda, sesuai dengan spesifikasi pilihan Anda.

Atau, Anda dapat menjadwalkan jeda iklan menggunakan mekanisme lain selain penanda iklan dalam manifes streaming. Dalam kasus ini, aplikasi Anda dapat memproses peristiwa lain, misalnya, interaksi pengguna dengan streaming, aplikasi itu sendiri, atau notifikasi push. Setelah peristiwa ini, aplikasi dapat membuat URL manifes pod iklan dan memberi tahu pemutar untuk mulai memuat manifes pod iklan.

Prasyarat

Sebelum melanjutkan, pastikan Anda memiliki hal berikut:

• DAI Penayangan Pod diaktifkan di jaringan Google Ad Manager Anda.
• Peristiwa livestream dengan jenis Manifes penayangan pod. Untuk membuat peristiwa, lihat Menyiapkan livestream untuk DAI.

Mengikuti rekomendasi

Sebelum Anda membuat URL manifes pod iklan, sebaiknya Anda memanggil Early Ad Break Notification (EABN) API untuk menentukan durasi yang diharapkan, informasi penargetan, dan parameter lain dari setiap jeda iklan.

Untuk streaming produksi dan pengujian, panggil EABN API, terutama jika jaringan iklan Anda memiliki kampanye terprogram. Untuk mengetahui informasi selengkapnya, lihat Fitur dan panduan untuk Langsung Terprogram.

Membuat permintaan pendaftaran streaming

Saat pengguna memulai streaming konten di aplikasi pemutar video Anda, buat permintaan pendaftaran streaming dengan parameter penargetan untuk membuat sesi streaming di Ad Manager. Untuk mengetahui detail tentang cara membuat permintaan pendaftaran streaming, lihat Metode:stream. Setelah itu, Anda akan menerima data respons dari permintaan tersebut.

Contoh berikut membuat permintaan pendaftaran streaming:

HTTP teks biasa

• Permintaan:

authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2

• Respons:

{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

Shell

• Command line:

curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"

• Output:

{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

JavaScript

• Menggunakan Fetch API:

const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);

• Log konsol:

{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

Memeriksa metadata jeda iklan

Setelah membuat permintaan pendaftaran streaming, periksa metadata iklan. Untuk memeriksa, Anda menetapkan timer menggunakan polling_frequence dalam respons streaming pada langkah pendaftaran untuk memanggil metadata iklan. Untuk setiap pemeriksaan, Anda mungkin menerima daftar iklan sebagian dengan metadata saat iklan tersedia.

Membuat URL manifes pod iklan

Buat URL untuk resource pod dari Pod Serving API. Setelah itu, teruskan URL ke pemutar video untuk mulai memuat pod iklan.

Contoh berikut menunjukkan struktur URL manifes pod iklan:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/ad_break_id/ab101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

Catatan: Parameter jeda iklan, seperti ad_break_id, duration, cust_params dan scte35 harus sama untuk semua klien yang menonton livestream yang sama, sedangkan ID streaming bersifat unik untuk setiap klien. Jika Anda memilih untuk membuat URL manifes pod iklan di sisi server dan menyisipkan URL yang dibuat dalam manifes streaming, ikuti dokumentasi server manipulator manifes Anda tentang cara mengirimkan ID streaming dari klien dan membuat parameter jeda iklan lainnya.

Anda dapat menghitung parameter URL manifes pod iklan berdasarkan informasi jeda iklan yang diambil dari pemutar video atau notifikasi server. Untuk mengetahui persyaratan parameter ini, lihat Metode: manifes pod.

Memutar manifes pod iklan

Di aplikasi pemutar video klien, mulai pemutaran streaming konten dengan pemutar video utama dan ikuti dokumentasi pemutar video Anda tentang cara mengamati jadwal pemutaran dan iklan, jika relevan.

Jika Anda membuat URL manifes pod iklan dan menyisipkannya dalam manifes di sisi server, amati peristiwa jeda iklan mendatang pemutar video, dan pastikan untuk berlangganan peristiwa id3 selama setiap pemutaran jeda iklan. Jika Anda menjadwalkan peristiwa jeda iklan dari sisi klien, berlangganan peristiwa id3 saat pembuatan.

Melaporkan tayangan dan peristiwa iklan

Saat pemutar video memutar pod iklan dan menemukan metadata berwaktu id3, dengarkan peristiwa iklan yang dipicu pemutar video dan proses peristiwa tersebut untuk mengirim ping verifikasi media.

Penting: Jangan menunda ping ke URL verifikasi media. Sebaiknya kirim ping segera dan tidak lebih dari satu menit.