Mulai menggunakan SGAI

Penyisipan iklan terpandu server (SGAI) menyediakan manifes pod iklan yang siap untuk digabungkan di perangkat klien. Jika telah mengaktifkan DAI Penyertaan 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 membawa informasi manifes pod iklan di streaming konten, sesuai dengan spesifikasi pilihan Anda.

Atau, Anda dapat menjadwalkan jeda iklan menggunakan mekanisme yang berbeda dari 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:

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

Mengikuti rekomendasi

Sebelum membuat URL manifes pod iklan, sebaiknya Anda memanggil Early Ad Break Notification (EABN) API untuk menentukan durasi yang diharapkan, informasi penargetan, dan parameter lainnya 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 membuat permintaan pendaftaran streaming dengan parameter penargetan untuk membuat sesi streaming di Ad Manager. Untuk mengetahui detail tentang cara membuat permintaan pendaftaran streaming, lihat Method:stream. Setelah itu, Anda akan menerima data respons dari permintaan.

Contoh berikut membuat permintaan pendaftaran streaming:

HTTP teks biasa Shell JavaScript

• 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"
}

• 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"
}

• 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"
}

Mengadakan polling untuk metadata jeda iklan

Setelah Anda membuat permintaan pendaftaran streaming, lakukan polling untuk metadata iklan. Untuk melakukan polling, Anda menetapkan timer menggunakan polling_frequence dalam respons streaming pada langkah pendaftaran untuk memanggil metadata iklan. Untuk setiap polling, Anda mungkin menerima sebagian daftar iklan dengan metadata saat 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 live stream 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 dihasilkan dalam manifes streaming, ikuti dokumentasi server manipulator manifes Anda tentang cara mengirim 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 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 untuk 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, berlanggananlah ke 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 prosesnya untuk mengirim ping verifikasi media.

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