Iklan VOD yang dapat dilewati

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

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.
start (angka) Posisi dalam streaming tempat jeda dimulai, dalam detik.
duration (angka) Durasi jeda iklan, dalam detik.
ads (object(Ad)) Daftar Iklan dalam aliran data.
start (angka) Posisi di streaming tempat iklan dimulai, dalam detik.
duration (angka) Durasi iklan, dalam detik.
skip_metadata (object(SkipMetadata)) Metadata opsional untuk iklan yang dapat dilewati. Jika disetel, parameter ini menunjukkan iklan dapat dilewati dan menyertakan petunjuk cara menangani UI lewati dan peristiwa pelacakan.
offset (number) Offset menunjukkan jumlah waktu dalam detik pada iklan yang harus ditunggu pemain untuk merender tombol lewati. Dihapus jika tidak disediakan dalam VAST.
tracking_url (string) URL yang harus di-ping pada peristiwa lewati.

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.