Iklan VOD yang dapat dilewati

Panduan ini menunjukkan cara menggunakan DAI API untuk meminta streaming VOD dengan iklan yang dapat dilewati, menampilkan 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 dai-sas di parameter 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 kolom isi:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Menangani iklan yang dapat dilewati

Untuk menangani tindakan melewati iklan, gunakan informasi di Ad struct atau AdBreak struct bergantung pada apakah Anda melewati iklan saat ini atau seluruh jeda iklan. Ambil nilai start dan tambahkan nilai duration, lalu cari ke titik tersebut di {i>stream <i}itu. Tujuan SkipMetadata subpesan juga menyertakan nilai offset, yang merupakan nilai di detik 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, di detik.
duration (angka) Durasi iklan, dalam detik.
skip_metadata (object(SkipMetadata)) Metadata opsional untuk dapat dilewati iklan. Jika disetel, iklan ini dapat dilewati dan mencakup petunjuk tentang cara menangani UI lewati dan peristiwa pelacakan.
offset (angka) Offset menunjukkan jumlah waktu dalam detik dalam iklan, pemutar harus menunggu untuk merender tombol lewati. Dihapus jika tidak disediakan dalam VAST.
tracking_url (string) URL yang seharusnya di-ping saat lewati peristiwa.

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 desain berikut lainnya. Kegagalan dalam memenuhi persyaratan ini dapat menyebabkan pembatasan ditempatkan di iklan Google yang ditayangkan 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 memberitahukan 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 pada sisi kiri bawah pemutar video.

Ukuran tombol lewati

Tombol dan teks harus cukup besar agar dapat dibaca dengan jelas pada saat bersandar pengalaman yang lancar bagi developer.

Teks dan ikon

Tombol lewati harus memiliki teks dan ikonografi. Anda dapat menggunakan lewati ikon material berikutnya sebagai ikonografi Anda.

Aksesibilitas

Pengguna harus dapat menavigasi ke tombol {i>pass <i}menggunakan {i>keyboard<i} atau pengendali jarak jauh. 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 untuk seluruh pod.

'Lewati iklan' terjemahan

Gunakan file skipAdTranslations.json untuk menerjemahkan 'Lewati iklan' teks berdasarkan bahasa lokal pengguna.