Materi iklan JavaScript VPAID 2

IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2. Mengaktifkan dukungan mudah, tetapi ada dua perbedaan yang perlu diketahui antara spesifikasi VPAID 2 dan cara IMA SDK mendukung VPAID 2. Perbedaan ini tidak memengaruhi kode penerapan SDK atau pemutar, namun 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

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

Penjelasan dasar yang bermanfaat

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 informasi selengkapnya, lihat Keamanan IFrame dan Elemen proxy pemutar video.
  • DISABLED - Iklan VPAID tidak diputar. Jika iklan yang diminta mengembalikan materi iklan VPAID, error akan muncul.
Untuk informasi mode VPAID selengkapnya, lihat dokumentasi API untuk ImaSdkSettings.VpaidMode.

Peringatan dukungan VPAID 2

Keamanan iFrame

Secara default, IMA SDK menggunakan iframe aman, bukan iframe yang sesuai (domain yang sama) atau skrip dalam halaman untuk merender materi iklan JavaScript VPAID 2. Artinya, jika materi iklan ingin mengakses DOM halaman induk, hal ini berpotensi menyebabkan error. Untuk merender iklan dalam iframe yang sesuai, 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 sesuai, dalam mode ENABLED, IMA HTML5 SDK tidak memberikan elemen video yang sebenarnya ke iklan; tetapi, SDK ini memberikan elemen proxy yang meniru sebagian besar fungsi elemen video biasa. Untuk materi iklan yang hanya memanggil metode API yang didukung, seharusnya tidak 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 pada 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 ini mengaktifkan materi iklan VPAID di IMA HTML5 SDK?
Ya, IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2.