Google Mobile Ads SDK kini memiliki dukungan beta untuk MRAID v3, yang dibuat berdasarkan dukungan yang ada untuk MRAID v2, sehingga pengiklan dapat menayangkan materi iklan MRAID v3 kepada penayang Ad Manager. Panduan ini menjelaskan detail penerapan MRAID yang tidak jelas dan dapat ditafsirkan secara berbeda dalam spesifikasi MRAID v3. Audiens yang dituju adalah pembuat materi iklan MRAID v3.
Prasyarat
Penayang harus menjalankan:
Panduan bermanfaat
Jika Anda tidak familier dengan MRAID, Anda dapat mempelajari lebih lanjut di halaman MRAID IAB. Anda juga dapat mendownload dokumen Definisi MRAID v3, yang memberikan detail tentang semua parameter yang dibahas di bawah, serta postingan blog IAB tentang MRAID v3.
Detail penerapan MRAID v3 (beta)
Visibilitas - peristiwa exposureChange
Peristiwa ini didukung dan sebaiknya gunakan pemroses untuk peristiwa exposureChange baru, bukan peristiwa viewableChange yang tidak digunakan lagi.
Metode mraid.isViewable() juga tidak digunakan lagi. Namun, metode yang tidak digunakan lagi ini
terus didukung untuk mempertahankan kompatibilitas mundur.
Definisi peristiwa exposureChange dikirim setiap kali tampilan iklan berubah. SDK memiliki mekanisme polling untuk menghindari pembuatan terlalu banyak peristiwa.
Status awal dikirim secara asinkron setelah iklan mendaftarkan pemroses.
Callback menyertakan parameter exposed_percentage yang merupakan angka floating point
antara 0.0 dan 100.0.
Lihat spesifikasi MRAID v3 untuk mengetahui contoh penggunaan.
Deteksi dan inisialisasi MRAID serta atribut MRAID_ENV
SDK ini sesuai dengan protokol inisialisasi seperti yang ditentukan dalam spesifikasi MRAID v3.
Dalam objek MRAID_ENV, SDK tidak mengirim IDFA, limitAdTracking,
ID Aplikasi, atau COPPA (yang bersifat opsional). SDK ini menyediakan semua variabel yang diperlukan
dalam objek MRAID_ENV, termasuk versi MRAID, nama SDK, dan versi SDK.
Pengukuran audibilitas
Peristiwa baru (audioVolumeChange) diperkenalkan untuk mengidentifikasi apakah audio
dapat didengar dan kapan volume berubah.
Peristiwa audioVolumeChange memiliki satu parameter: volume_percentage.
Nilainya adalah persentase volume pemutaran audio maksimum. Nilai ini berupa
angka floating point antara 0.0 dan 100.0 (0.0 jika pemutaran
tidak diizinkan) atau null jika volume tidak dapat ditentukan.
Lihat spesifikasi MRAID v3 untuk mengetahui contoh penggunaan.
mraid.getLocation()
Karena mraid.getLocation() tidak didukung, atribut ini selalu menampilkan -1.
mraid.unload()
Metode ini dapat dipanggil kapan saja dan SDK akan bereaksi dengan menutup iklan, membatalkan alokasi resource, lalu menghapus webview atau menggantinya dengan dokumen lain atau iklan baru.
Saat materi iklan memanggil unload(), lapisan native akan merespons sebagai berikut
untuk berbagai jenis materi iklan:
| Jenis | Perilaku unload() |
|---|---|
| Banner | Buat permintaan iklan baru dengan parameter permintaan yang sama dengan iklan saat ini. |
| Interstisial | Tutup interstisial. |
VPAID (Video Player Ad Interface Definition)
Google Mobile Ads SDK tidak mendukung VPAID. mraid.supports('vpaid')
menampilkan nilai salah.
mraid.useCustomClose()
mraid.useCustomClose() mungkin tidak didukung, bergantung pada format dan
jenis materi iklan.
Detail penerapan MRAID v2
mraid.getVersion()
mraid.getVersion() tidak menampilkan 2.0 hingga materi iklan dimuat. Jangan
memeriksa versi MRAID saat mraid.getState() menampilkan loading.
mraid.resize()
Saat mraid.resize() dipanggil, banner asli akan diganti dengan
gambar screenshot banner. Hal ini terlihat jika iklan yang diubah ukurannya
tidak menutupi ruang iklan asli.
Iklan yang diubah ukurannya juga tidak mengikuti bingkai banner asli. Jika banner ditempatkan dalam tampilan scroll, iklan yang diubah ukurannya tidak akan di-scroll bersama banner.
mraid.setResizeProperties()
Semua panggilan ke mraid.setResizeProperties() harus berisi daftar lengkap properti yang diperlukan. Jika properti pengubahan ukuran tidak valid, properti tersebut akan disetel kembali
ke defaultnya, dan semua panggilan berikutnya ke mraid.resize() akan gagal hingga
mraid.setResizeProperties() dipanggil lagi dengan parameter yang valid.
mraid.getMaxSize()
mraid.getMaxSize() hanya boleh digunakan untuk menentukan ukuran maksimum iklan yang diubah ukurannya. Untuk menentukan ukuran iklan yang dapat diperluas, gunakan mraid.getScreenSize().
mraid.setOrientationProperties()
Saat memanggil mraid.setOrientationProperties() dengan properti allowOrientationChange
ditetapkan ke true, menetapkan properti forceOrientation tidak akan berpengaruh apa pun.
Materi iklan yang ingin menerapkan orientasi harus menetapkan allowOrientationChange ke
false.
mraid.isViewable()
Jika tampilan menutupi iklan yang seharusnya terlihat, mraid.isViewable() akan tetap menampilkan
true. Konten aplikasi tidak boleh menutupi iklan yang terlihat.
mraid.getCurrentPosition()
Saat iklan yang dapat diperluas dua bagian dalam status diperluas, panggilan ke
mraid.getCurrentPosition() di bagian pertama akan menampilkan ukuran
layar.
mraid.storePicture()
Agar aplikasi dapat mendukung mraid.storePicture(), aplikasi harus menyertakan
izin android.permission.WRITE_EXTERNAL_STORAGE.