Materi iklan JavaScript VPAID 2

IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2. Mengaktifkan dukungan itu mudah, tetapi ada dua perbedaan yang harus diketahui antara spesifikasi VPAID 2 dan cara IMA SDK mendukung VPAID 2. Perbedaan ini tidak memengaruhi kode penerapan SDK atau pemutar, tetapi hal tersebut penting untuk penulis materi iklan VPAID 2 JavaScript, 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 terintegrasi. Jika Anda belum memilikinya, lihat panduan Memulai.
  • URL tag iklan VAST yang mengarah ke materi iklan JavaScript VPAID 2.

Pengantar yang 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 yang 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 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 yang sesuai (domain yang sama) atau skrip dalam halaman untuk merender materi iklan JavaScript VPAID 2. Artinya, jika materi iklan mengharapkan untuk mengakses DOM halaman induk, mungkin akan terjadi 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

Demi keamanan dan fungsi seluler yang tepat, dalam mode ENABLED IMA HTML5 SDK tidak memberikan elemen video yang sebenarnya ke iklan; tetapi menyediakan elemen proxy yang meniru sebagian besar fungsi elemen video normal. 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 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 akan mengaktifkan materi iklan VPAID di IMA HTML5 SDK?
Ya, IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2.