Mulai menggunakan SGAI

Penyisipan iklan dengan panduan server (SGAI) menyediakan manifes pod iklan yang siap penggabungan di perangkat klien. Jika Anda telah mengaktifkan DAI Penayangan Pod di jaringan Ad Manager, Anda memiliki akses untuk menggunakan SGAI. Jika Anda tidak memiliki Penayangan Pod DAI diaktifkan, hubungi Account Manager Anda.

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

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

Atau, Anda dapat menjadwalkan jeda iklan menggunakan mekanisme lain daripada 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 iklan URL manifes pod 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 livestream dengan jenis Pod yang menyalurkan manifes. Untuk membuat peristiwa, lihat Siapkan livestream untuk DAI.

Ikuti 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 setiap jeda iklan.

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

Membuat permintaan pendaftaran streaming

Saat pengguna memulai streaming konten di aplikasi pemutar video, Anda akan melakukan streaming permintaan pendaftaran dengan parameter penargetan untuk membuat sesi streaming tentang 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

• 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

• Baris perintah:

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

Polling untuk metadata jeda iklan

Setelah membuat permintaan pendaftaran streaming, lakukan polling untuk metadata iklan. Kepada polling, Anda menyetel timer menggunakan polling_frequence dalam respons streaming di langkah pendaftaran untuk memanggil iklan metadata. Untuk setiap polling, Anda mungkin menerima sebagian daftar iklan dengan metadata seperti tersedia.

Membuat URL manifes pod iklan

Buat URL untuk resource pod Pod Serving API. Setelah itu, teruskan URL ke pemutar video untuk memulai 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/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

Catatan: Parameter jeda iklan, seperti pod_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 pada sisi server dan URL yang dihasilkan dalam manifes streaming, ikuti manipulator manifes Anda dokumentasi server tentang pengiriman ID aliran data dari klien dan membuat parameter jeda iklan lainnya.

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

Memutar manifes pod iklan

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

Jika Anda membuat URL manifes pod iklan dan memasukkannya ke dalam manifes pada sisi server, amati peristiwa jeda iklan yang akan datang pada pemutar video, dan pastikan berlangganan peristiwa ID3 selama setiap pemutaran jeda iklan. Jika Anda menjadwalkan iklan menghentikan peristiwa dari sisi klien, berlangganan ke peristiwa id3 saat pembuatan.

Melaporkan tayangan dan peristiwa iklan

Saat pemutar video memutar pod iklan dan menemukan metadata dengan waktu ID3, memproses peristiwa iklan yang dipicu pemutar video dan memprosesnya untuk mengirim ping verifikasi media.

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