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 implementasi 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

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

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

Pengantar yang bermanfaat

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

Mengaktifkan dukungan VPAID 2

Untuk mengaktifkan dukungan JavaScript VPAID 2, panggil metode berikut sebelum menginisialisasi 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 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, hal ini berpotensi menyebabkan error. Untuk merender iklan Anda 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 untuk iklan; tetapi 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. 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 mendukung VPAID 2 materi iklan JavaScript.
Apakah hal ini mengaktifkan materi iklan VPAID di IMA HTML5 SDK?
Ya, IMA HTML5 SDK mendukung materi iklan JavaScript VPAID 2.