Mengaktifkan iklan yang dapat dilewati di streaming VOD

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 Meminta streaming VOD DAI untuk mengetahui informasi selengkapnya.

Membuat permintaan untuk 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 aliran data.
{VIDEO_ID}	ID video streaming.

Parameter isi

dai-sas

Tetapkan 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 dilewati

Untuk menangani iklan yang dilewati, gunakan informasi dalam struct Ad atau AdBreak, bergantung pada apakah Anda melewati iklan saat ini atau seluruh jeda iklan. Ambil nilai start dan tambahkan nilai duration, lalu cari titik tersebut dalam aliran data. Subpesan SkipMetadata juga menyertakan nilai offset, yang merupakan nilai dalam detik 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 di streaming. start (angka) Posisi dalam streaming tempat iklan dimulai, dalam detik. duration (angka) Durasi iklan, dalam detik. skip_metadata (object(SkipMetadata)) Metadata opsional untuk iklan yang dapat dilewati. Jika ditetapkan, ini menunjukkan bahwa iklan dapat dilewati dan menyertakan petunjuk tentang cara menangani UI lewati dan peristiwa pelacakan. offset (angka) Offset menunjukkan jumlah waktu dalam detik setelah iklan yang harus ditunggu pemutar untuk merender tombol lewati. Dihilangkan jika tidak diberikan di 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, lakukan ping ke URL peristiwa lewati yang disertakan dalam respons streaming. Subpesan ini disertakan dalam subpesan SkipMetadata.

Persyaratan tombol Lewati

Untuk iklan yang dapat dilewati, render tombol lewati dengan persyaratan desain berikut. Ketidakpatuhan terhadap persyaratan ini dapat menyebabkan pembatasan diberlakukan pada iklan Google yang ditayangkan ke situs atau aplikasi Anda.

Penghitung mundur

Iklan tidak boleh dilewati hingga waktu skipoffset yang ditentukan di VAST. Selama periode yang tidak dapat dilewati ini, Anda harus menampilkan pemberitahuan kepada pengguna yang memberi tahu mereka bahwa iklan dapat dilewati dalam X detik. Pemberitahuan harus diterjemahkan ke dalam bahasa pengguna.

Posisi tombol Lewati

Untuk bahasa dari kiri ke kanan, tempatkan tombol lewati di sisi kanan bawah pemutar video. Untuk bahasa 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 santai.

Teks dan ikon

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

Aksesibilitas

Pengguna harus dapat membuka 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 lokalitas pengguna.