Mengaktifkan materi iklan JavaScript VPAID 2

IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2. Saat mengaktifkan dukungan, ada dua perbedaan utama yang perlu diperhatikan antara spesifikasi VPAID 2 dan cara IMA SDK mendukung VPAID 2. Perbedaan ini tidak memengaruhi kode penerapan pemutar atau SDK, tetapi penting bagi penulis materi iklan JavaScript VPAID 2, karena materi iklan dapat memunculkan error atau tidak berfungsi seperti yang diharapkan saat dirender oleh IMA HTML5 SDK.

Prasyarat

Untuk mengikuti panduan ini, mulailah dengan aplikasi yang memiliki hal berikut:

  • Pemutar video HTML5 dengan IMA HTML5 SDK yang terintegrasi. Jika Anda belum memilikinya, lihat artikel Menyiapkan IMA SDK.
  • URL tag iklan VAST yang mengarah ke materi iklan JavaScript VPAID 2.

Panduan bermanfaat

  • Jika Anda belum memahami VPAID 2, Anda dapat membaca selengkapnya di halaman VPAID IAB.

Mengaktifkan dukungan VPAID 2

Untuk mengaktifkan dukungan JavaScript VPAID 2, panggil metode berikut sebelum menginisialisasi AdDisplayContainer Anda:

google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
...
var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
...

Mode VPAID yang tersedia adalah sebagai berikut:

  • ENABLED - Mengizinkan iklan VPAID dengan setelan default.
  • INSECURE - Mengizinkan iklan VPAID dalam mode tidak aman. Untuk mengetahui informasi selengkapnya, lihat Keamanan IFrame dan Elemen proxy pemutar video.
  • DISABLED - Iklan VPAID tidak diputar. Jika iklan yang diminta menampilkan materi iklan VPAID, error akan ditampilkan.

Untuk mengetahui informasi selengkapnya tentang mode VPAID, lihat dokumentasi API untuk ImaSdkSettings.VpaidMode.

Peringatan dukungan VPAID 2

Keamanan IFrame

Secara default, IMA SDK menggunakan iframe aman, bukan iframe ramah (domain yang sama) atau skrip dalam halaman untuk merender materi iklan JavaScript VPAID 2. Artinya, jika materi iklan berharap untuk mengakses DOM halaman induk, maka berpotensi menyebabkan error. Untuk merender iklan di iframe ramah, Anda dapat menggunakan ImaSdkSettings.setVpaidMode(...) seperti berikut:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

Elemen proxy pemutar video

Untuk keamanan dan fungsi seluler yang tepat, dalam mode ENABLED, IMA HTML5 SDK tidak menyediakan elemen video sebenarnya ke iklan; melainkan menyediakan elemen proxy yang meniru sebagian besar fungsi elemen video normal. Untuk materi iklan yang hanya memanggil metode API yang didukung, tidak akan ada perubahan perilaku dalam rendering materi iklan. Dalam mode VpaidMode.INSECURE, SDK menyediakan elemen pemutar video, bukan proxy.

Berikut adalah metode, pemroses, dan atribut yang tersedia di elemen proxy video:

Metode

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

Jenis peristiwa untuk addEventListener

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

Atribut

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

FAQ

Apakah materi iklan JavaScript VPAID 2 didukung di SDK iOS atau Android?
IMA HTML5 SDK adalah satu-satunya platform IMA SDK yang mendukung materi iklan JavaScript VPAID 2.
Apakah ini mengaktifkan materi iklan VPAID di IMA HTML5 SDK?
Ya, IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2.