Mengaktifkan materi iklan JavaScript VPAID 2

IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2. Mengaktifkan dukungan itu mudah, tetapi ada dua perbedaan 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 menampilkan error atau tidak berfungsi seperti yang diharapkan saat dirender oleh IMA HTML5 SDK.

Prasyarat

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

Panduan dasar yang bermanfaat

Mengaktifkan dukungan VPAID 2

Untuk mengaktifkan dukungan JavaScript VPAID 2, panggil metode berikut sebelum melakukan inisialisasi AdDisplayContainer:

      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 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 informasi selengkapnya tentang mode VPAID, lihat dokumentasi API untuk ImaSdkSettings.VpaidMode.

Ketentuan 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 mengharapkan untuk mengakses DOM halaman induk, hal ini berpotensi menyebabkan error. Untuk merender iklan di iframe yang ramah, Anda dapat menggunakan ImaSdkSettings.setVpaidMode(...) seperti ini: 

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 yang sebenarnya ke iklan; sebagai gantinya, SDK ini menyediakan elemen proxy yang meniru sebagian besar fungsi elemen video normal. Untuk materi iklan yang hanya memanggil metode API yang didukung, tidak boleh ada perubahan perilaku dalam rendering materi iklan. Dengan 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 saat ini mendukung materi iklan JavaScript VPAID 2.
Apakah tindakan ini mengaktifkan materi iklan VPAID di IMA HTML5 SDK?
Ya, IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2.