google.
Class ini menampilkan penampung untuk menampilkan iklan. SDK akan otomatis membuat struktur di dalam parameter containerElement untuk menyimpan iklan video dan overlay.
Ketika instance class ini dibuat, instance IFRAME akan dibuat di
containerElement dan memuat core SDK. IFRAME ini harus dipertahankan agar SDK dapat berfungsi dengan benar. Setelah semua iklan diputar
dan SDK tidak lagi diperlukan, gunakan metode destroy()
untuk menghapus muatan SDK.
Parameter containerElement harus menjadi elemen yang merupakan bagian dari DOM. Anda harus memosisikan containerElement dengan benar agar iklan ditampilkan dengan benar. Sebaiknya Anda memosisikannya di atas pemutar video konten dan menyesuaikan ukurannya untuk mencakup seluruh pemutar video. Baca dokumentasi SDK untuk mengetahui detail tentang penerapan yang direkomendasikan.
Catatan: Selalu perlu memanggil
metode initialize() dalam kode yang langsung dipanggil oleh
tindakan pengguna (seperti klik atau ketuk).
Konstruktor
Penampung AdDisplay
baru AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
Parameter |
|
|---|---|
|
containerElement |
Elemen untuk menampilkan iklan. Elemen harus dimasukkan ke dalam DOM sebelum membuat AdDisplayContainer. Nilai tidak boleh kosong. |
|
elemenVideo |
Opsional Menentukan elemen pemutaran iklan video alternatif. Sebaiknya selalu teruskan pemutar video konten Anda. Nilai tidak boleh kosong. |
|
clickTrackingElement |
Opsional Menentukan elemen klik iklan video alternatif. Biarkan null ini untuk mengizinkan SDK menangani klik. Meskipun disediakan, SDK hanya akan menggunakan elemen pelacakan klik kustom saat materi iklan non-AdSense/AdX ditampilkan di lingkungan yang tidak mendukung elemen UI yang menempatkan pemutar video (misalnya, iPhone atau Android sebelum versi 4.0). Elemen pelacakan klik kustom tidak boleh dirender melalui pemutar video, karena elemen tersebut dapat menghalangi klik ke elemen UI yang dirender oleh SDK. Perhatikan juga bahwa SDK tidak akan mengubah visibilitas elemen pelacakan klik kustom. Artinya, jika disediakan elemen pelacakan klik kustom, elemen ini harus ditampilkan dengan benar saat iklan linear diputar. Anda dapat memeriksa peristiwa ima.AdsManager.isCustomClickTrackingUsed saat ima.AdEvent.Type.STARTED diaktifkan untuk menentukan apakah elemen pelacakan klik kustom akan ditampilkan atau tidak. Jika sesuai untuk UI Anda, Anda harus menyembunyikan elemen pelacakan klik saat peristiwa ima.AdEvent.Type.CONTENT_RESUME_REQUESTED diaktifkan. Nilai tidak boleh kosong. |
Metode
hancurkan
menghancurkan()
Menghancurkan status internal dan elemen DOM yang telah dibuat sebelumnya. IMA SDK akan dihapus muatannya dan tidak ada panggilan lebih lanjut ke API apa pun yang harus dilakukan.
lakukan inisialisasi
lakukan inisialisasi()
Menginisialisasi elemen video internal untuk pemutaran. Anda harus memanggil metode ini sebagai hasil langsung dari tindakan pengguna, sehingga browser dapat menandai elemen video sebagai dimulai oleh pengguna.
Beberapa browser akan mengizinkan pemutaran video tanpa interaksi pengguna jika
video dibisukan. Untuk perilaku ini, gunakan
AdsRequest.setAdWillPlayMuted(true) dan panggil metode ini sebelum
AdsManager.start().