Panduan ini menunjukkan cara menggunakan DAI API untuk meminta streaming VOD dengan iklan yang dapat dilewati, merender tombol lewati sesuai dengan persyaratan Google Ads, dan mengirim peristiwa pelacakan terkait.
Prasyarat
- Aplikasi yang menerapkan panggilan DAI API untuk streaming VOD. Lihat panduan streaming VOD DAI API untuk mengetahui informasi selengkapnya.
Membuat permintaan iklan yang dapat dilewati
Untuk meminta streaming VOD dengan iklan yang dapat dilewati, Anda harus meneruskan parameter dai-sas
dalam
permintaan streaming.
Endpoint API
POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded
Parameter jalur
{CMS_ID} |
ID CMS streaming. |
{VIDEO_ID} |
ID video streaming. |
Parameter isi
dai-sas |
Setel dai-sas=1 untuk mengaktifkan iklan yang dapat dilewati.
|
Contoh permintaan (cURL)
Untuk permintaan streaming HLS:
curl -X POST \
-d 'dai-sas=1' \
-H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Ganti 'dash'
di URL untuk streaming DASH:
https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Gunakan format berikut untuk menyertakan beberapa parameter streaming dalam isi permintaan Anda:
-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \
Menangani iklan yang dapat dilewati
Untuk menangani tindakan melewati iklan, gunakan informasi dalam struktur Ad
atau struktur AdBreak
, bergantung pada apakah Anda melewati iklan saat ini atau keseluruhan jeda iklan.
Ambil nilai start
dan tambahkan nilai duration
, lalu cari ke titik tersebut dalam
aliran data. Subpesan
SkipMetadata
juga menyertakan nilai offset
, yang merupakan nilai dalam
detik dari waktu sebelum iklan dapat dilewati. Subpesan SkipMetadata
hanya akan disertakan pada iklan yang dapat dilewati.
ad_breaks |
Daftar Jeda Iklan.
|
Contoh respons
{
...
"ad_breaks":[
{
...
"start":0,
"duration":10,
"ads":[
{
...
"start":0,
"duration":10,
"skip_metadata":{
"offset": 5,
"tracking_url": "https://example_skip_url.com"
}
}
}
}
Setelah iklan dilewati, ping ke URL peristiwa lewati yang disertakan dalam respons streaming.
Hal ini disertakan dalam subpesan SkipMetadata
.
Lewati persyaratan tombol
Untuk iklan yang dapat dilewati, render tombol lewati dengan persyaratan desain berikut. Kegagalan dalam memenuhi persyaratan ini dapat menyebabkan pembatasan penayangan iklan Google ke situs atau aplikasi Anda.
Penghitung mundur
Iklan tidak boleh dapat dilewati sampai waktu skipoffset
yang ditentukan dalam VAST.
Selama periode yang tidak dapat dilewati ini, Anda harus menampilkan pemberitahuan kepada pengguna yang menginformasikan
bahwa iklan dapat dilewati dalam X detik. Pemberitahuan harus diterjemahkan
ke dalam bahasa pengguna.
Posisi tombol lewati
Untuk bahasa yang ditulis dari kiri ke kanan, tempatkan tombol lewati di sisi kanan bawah pemutar video. Untuk bahasa yang ditulis dari kanan ke kiri, tempatkan tombol lewati di sisi kiri bawah pemutar video.
Ukuran tombol lewati
Tombol dan teks harus cukup besar agar dapat dibaca dengan jelas dalam pengalaman bersantai.
Teks dan ikon
Tombol lewati harus memiliki teks dan ikonografi. Anda dapat menggunakan ikon lewati berikutnya sebagai ikonografi Anda.
Aksesibilitas
Pengguna harus dapat memilih tombol lewati menggunakan keyboard atau remote control. Aplikasi harus memfokuskan tombol lewati setelah hitung mundur selesai.
Internasionalisasi
Sebaiknya terjemahkan teks lewati ke dalam bahasa pengguna.
Pod iklan
Tombol lewati dapat digunakan untuk melewati iklan saat ini di pod iklan, atau melewati seluruh pod.
Terjemahan 'Lewati iklan'
Gunakan
file skipAdTranslations.json
untuk menerjemahkan teks 'Lewati iklan' berdasarkan bahasa pengguna.