Iklan Multimedia Seluler

Google Mobile Ads SDK kini memiliki dukungan beta untuk MRAID v3, yang dibuat berdasarkan dukungan yang sudah ada untuk MRAID v2, yang memungkinkan pengiklan menayangkan materi iklan MRAID v3 ke penayang Ad Manager. Panduan ini menjelaskan detail penerapan MRAID yang tidak jelas dan terbuka untuk diinterpretasikan dalam spesifikasi MRAID v3. Audiens yang dimaksud adalah penulis materi iklan MRAID v3.

Prasyarat

Penayang harus menjalankan:

  • Google Mobile Ads SDK untuk iOS 7.30.0 atau yang lebih tinggi untuk MRAID v3
  • Google Mobile Ads SDK untuk iOS 7.4.0 atau yang lebih tinggi untuk MRAID v2

Penjelasan dasar yang bermanfaat

Jika belum terbiasa dengan MRAID, Anda dapat mempelajari lebih lanjut di halaman MRAID IAB. Anda juga dapat mendownload dokumen MRAID v3 Definisi yang memberikan detail tentang semua parameter yang dibahas di bawah, serta postingan blog IAB tentang MRAID v3.

Detail penerapan MRAID v3 (beta)

Visibilitas - peristiwa perubahan eksposur

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 akan terus didukung untuk mempertahankan kompatibilitas mundur.

Definisi peristiwa exposureChange dikirim setiap kali tampilan iklan berubah. SDK memiliki mekanisme polling untuk menghindari menghasilkan terlalu banyak peristiwa. Status awal dikirim secara asinkron setelah iklan mendaftarkan pemroses. Callback menyertakan parameter exposed_percentage yang merupakan bilangan floating point antara 0.0 dan 100.0.

Lihat spesifikasi MRAID v3 untuk contoh penggunaan.

Deteksi dan inisialisasi MRAID dan atribut MRAID_ENV

SDK mematuhi 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). Class ini menyediakan semua variabel yang diperlukan di 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. Ini adalah 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 contoh penggunaan.

mraid.getLocation()

Karena mraid.getLocation() tidak didukung, metode ini selalu menampilkan -1.

mraid.unload()

Metode ini dapat dipanggil kapan saja dan SDK bereaksi dengan menutup iklan, mengalokasikan resource, lalu menghapus webview atau menggantinya dengan dokumen lain atau iklan baru.

Saat materi iklan memanggil unload(), lapisan native merespons sebagai berikut untuk berbagai jenis materi iklan:

Jenis Perilaku unload()
Banner Buat permintaan iklan baru dengan parameter permintaan yang sama seperti iklan saat ini.
Interstisial Tutup interstisial.

VPAID (Definisi Antarmuka Iklan Pemutar Video)

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 periksa 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 spanduk 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 ubah ukuran tidak valid, properti tersebut akan disetel kembali ke default, 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 bagi iklan yang diubah ukurannya. Untuk menentukan ukuran iklan yang dapat diperluas, gunakan mraid.getScreenSize().

mraid.setOrientationProperties()

Saat memanggil mraid.setOrientationProperties() dengan properti allowOrientationChange yang ditetapkan ke true, menyetel properti forceOrientation tidak akan melakukan apa pun. Materi iklan yang ingin memaksa orientasi harus menetapkan allowOrientationChange ke false.

mraid.isViewable()

Jika tampilan mencakup iklan yang terlihat, mraid.isViewable() akan tetap menampilkan true. Konten aplikasi tidak boleh menutupi iklan yang terlihat.

mraid.getCurrentPosition()

Saat iklan yang dapat diperluas dengan dua bagian berada dalam status diluaskan, panggilan ke mraid.getCurrentPosition() di bagian pertama akan menampilkan ukuran layar.

mraid.supports()

Mulai SDK versi 7.11.0, mraid.supports("storePicture") dan mraid.supports("calendar") selalu menampilkan false. Sesuai spesifikasi MRAID v2, materi iklan harus dapat menangani kasus jika metode ini tidak tersedia.

mraid.storePicture()

Aplikasi secara otomatis meminta izin untuk menyimpan gambar saat materi iklan MRAID memanggil mraid.storePicture().