Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari maio menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan maio ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor maio ke dalam aplikasi Unity.
Antarmuka dasbor maio menggunakan teks bahasa Jepang untuk label, tombol, beserta deskripsi dan screenshot dalam panduan ini belum diterjemahkan. Namun, dalam deskripsi dan petunjuk di sini, label dan tombol yang setara dengan padanan bahasa Inggris mereka. Misalnya, "URL スキーム" adalah "URL Scheme", dan seterusnya.
Integrasi dan format iklan yang didukung
Adaptor mediasi untuk maio memiliki kemampuan berikut:
Integrasi | |
---|---|
Bidding | |
Air Terjun | |
Format | |
Banner | |
Interstisial | |
Reward |
Persyaratan
- Unity 4 atau yang lebih baru
- Google Mobile Ads SDK Terbaru
- Untuk men-deploy di Android
- Android API level 21 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 12.0 atau versi yang lebih tinggi
- Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Mulai untuk mengetahui detailnya.
- Selesaikan Panduan memulai mediasi
Langkah 1: Siapkan konfigurasi di UI maio
Pertama, daftar atau login ke akun maio Anda. Klik tombol Pengelolaan aplikasi di sidebar kiri, lalu klik Aplikasi baru.
Pilih tab yang sesuai dengan Jenis Iklan yang Anda inginkan.
Interstisial
Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL aplikasi. Pilih Interstisial video sebagai Jenis Iklan, lalu klik Perbarui.
Android
iOS
Reward
Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL aplikasi. Pilih Video Rewards sebagai Jenis Iklan, lalu klik Perbarui.
Android
iOS
Di halaman Pengelolaan Aplikasi, catat ID Media. Penting yang diperlukan untuk menyiapkan unit iklan AdMob Anda bagian.
Android
iOS
Di halaman Zone Management, catat ID Zona. ID ini juga akan diperlukan untuk menyiapkan unit iklan AdMob di bagian berikut.
Android
iOS
Langkah 2: Siapkan permintaan maio di UI AdMob
Mengonfigurasi setelan mediasi untuk unit iklan
Android
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.
Langkah 3: Impor SDK dan adaptor maio
OpenUPM-CLI
Jika telah menginstal OpenUPM-CLI, Anda dapat menginstal Plugin Mediasi Google Mobile Ads untuk Unity ke project dengan menjalankan perintah berikut dari direktori utama project:
openupm add com.google.ads.mobile.mediation.maio
OpenUPM
Di editor project Unity, pilih Edit > Setelan Project > Package Manager untuk membuka Setelan Pengelola Paket Unity.
Di tab Scoped Registries, tambahkan OpenUPM sebagai registry terbatas dengan detail berikut:
- Nama:
OpenUPM
- URL:
https://package.openupm.com
- Cakupan:
com.google
Lalu, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.
Pilih paket Mediasi Google Mobile Ads, lalu klik Install.
Paket Unity
Download plugin mediasi Google Mobile Ads versi terbaru untuk
maio dari link download di
Log Perubahan
dan ekstrak
GoogleMobileAdsMaioMediation.unitypackage
dari file
zip.
Di editor project Unity, pilih Assets > Import Package >
Custom Package, lalu temukan
file
GoogleMobileAdsMaioMediation.unitypackage
yang telah Anda download. Pastikan semua file dipilih, lalu klik
Import.
Lalu, pilih Aset > External Dependency Manager >
Resolver Android > Paksa Selesaikan. Library External Dependency Manager
akan melakukan resolusi dependensi dari awal dan menyalin
dependensi yang dideklarasikan ke direktori Assets/Plugins/Android
aplikasi Unity Anda.
Langkah 4: Tambahkan kode yang diperlukan
Android
Tidak diperlukan kode tambahan untuk integrasi maio.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi maio
untuk menambahkan ID SKAdNetwork ke file Info.plist
project Anda.
Langkah 5: Uji penerapan
Aktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian Anda untuk AdMob
Penayang yang menggunakan Google Mobile Ads SDK versi 7.26.0 atau yang lebih tinggi akan secara otomatis menerima iklan percobaan dari maio di ponsel dan tablet yang terdaftar sebagai perangkat pengujian saat membuat permintaan.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari maio, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan maio (Waterfall) sumber iklan.
Kode error
Jika adaptor gagal menerima iklan dari maio, penayang dapat memeriksa
error yang mendasarinya dari respons iklan menggunakan
ResponseInfo
di bawah
class berikut:
Android
Format | Nama kelas |
---|---|
Interstisial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
Reward | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
Format | Nama kelas |
---|---|
Interstisial | GADMMaioInterstitialAdapter |
Reward | GADMMaioRewardedAdapter |
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor maio saat iklan gagal dimuat:
Android
Kode error | Alasan |
---|---|
0-10 | maio menampilkan error khusus SDK. Lihat kode dan dokumentasi maio untuk mengetahui detail selengkapnya. |
101 | Mai tidak memiliki iklan. |
102 | Parameter server tidak valid (misalnya, ID Penempatan tidak ada). |
103 | Konteks yang digunakan untuk memuat iklan bukan instance `Activity`. |
iOS
Kode error | Alasan |
---|---|
0-10 | maio menampilkan error khusus SDK. Lihat kode maio untuk mengetahui detail selengkapnya. |
101 | maio belum memiliki iklan yang tersedia. |
102 | Parameter server tidak valid (misalnya, ID Penempatan tidak ada). |
103 | Adaptor maio tidak mendukung format iklan yang diminta. |
104 | Iklan sudah dimuat untuk konfigurasi jaringan ini. |
Log Perubahan Plugin Mediasi Unity maio
Versi 2.0.3
- Mendukung adaptor Android maio versi 1.1.16.3.
- Mendukung adaptor iOS maio versi 2.1.5.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 2.0.2
- Mendukung adaptor Android maio versi 1.1.16.3.
- Mendukung adaptor iOS maio versi 2.1.4.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.0.0.
Versi 2.0.1
- Mendukung adaptor Android maio versi 1.1.16.2.
- Mendukung adaptor iOS maio versi 2.1.3.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 9.0.0.
Versi 2.0.0
- Mendukung adaptor Android maio versi 1.1.16.2.
- Mendukung adaptor iOS maio versi 2.1.1.0.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.
Versi 1.4.3
- Memindahkan konten adaptor ke
GoogleMobileAds/Mediation/Maio/
. - Mendukung adaptor Android maio versi 1.1.16.2.
- Mendukung adaptor iOS maio versi 1.6.3.1.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.1.0.
Versi 1.4.2
- Mendukung adaptor Android maio versi 1.1.16.1.
- Mendukung adaptor iOS maio versi 1.6.3.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.0.
Versi 1.4.1
- Mendukung Adaptor Android maio versi 1.1.16.1.
- Mendukung adaptor iOS maio versi 1.6.2.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.1.0.
Versi 1.4.0
- Mendukung adaptor Android maio versi 1.1.16.0.
- Mendukung adaptor iOS maio versi 1.6.0.1.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.0.
Versi 1.3.6
- Mendukung Adaptor Android maio versi 1.1.16.0.
- Mendukung adaptor iOS maio versi 1.5.8.0.
Versi 1.3.5
- Mendukung adaptor Android maio versi 1.1.15.0.
- Mendukung adaptor iOS maio versi 1.5.6.1.
Versi 1.3.4
- Mendukung Adaptor Android maio versi 1.1.11.1.
- Mendukung adaptor iOS maio versi 1.5.4.0.
Versi 1.3.3
- Mendukung adaptor Android maio versi 1.1.11.1.
- Mendukung adaptor iOS maio versi 1.5.3.1.
Versi 1.3.2
- Mendukung adaptor Android maio versi 1.1.11.0.
- Mendukung adaptor iOS maio versi 1.5.2.1.
Versi 1.3.1
- Mendukung adaptor Android maio versi 1.1.10.0.
- Mendukung adaptor iOS maio versi 1.5.1.0.
Versi 1.3.0
- Mendukung adaptor Android maio versi 1.1.10.0.
- Mendukung adaptor iOS maio versi 1.5.0.0.
Versi 1.2.3
- Mengupdate plugin untuk mendukung Reward API yang baru.
- Mendukung adaptor Android maio versi 1.1.7.0.
- Mendukung adaptor iOS maio versi 1.4.6.0.
Versi 1.2.2
- Mendukung adaptor Android maio versi 1.1.6.0.
- Mendukung adaptor iOS maio versi 1.4.2.0.
Versi 1.2.1
- Mendukung adaptor Android maio versi 1.1.6.0.
- Mendukung adaptor iOS maio versi 1.4.1.0.
Versi 1.2.0
- Mendukung adaptor Android maio versi 1.1.4.1.
- Mendukung adaptor iOS maio versi 1.4.0.0.
Versi 1.1.3
- Mendukung maio Android adaptor versi 1.1.3.1.
- Mendukung adaptor iOS maio versi 1.3.2.0.
Versi 1.1.2
- Mendukung maio Android adaptor versi 1.1.3.0.
- Mendukung adaptor iOS maio versi 1.3.2.0.
Versi 1.1.1
- Mendukung maio Android adaptor versi 1.1.1.0.
- Mendukung adaptor iOS maio versi 1.3.1.1.
Versi 1.1.0
- Mendukung maio Android adaptor versi 1.1.0.0.
- Mendukung adaptor iOS maio versi 1.3.0.0.
Versi 1.0.2
- Mendukung maio Android SDK versi 1.0.8.
- Mendukung maio iOS SDK versi 1.2.19.
Versi 1.0.1
- Mendukung Android SDK versi 1.0.7.
- Mendukung iOS SDK maio versi 1.2.19.
Versi 1.0.0
- Rilis pertama!
- Mendukung maio Android SDK versi 1.0.6.
- Mendukung iOS SDK versi 1.2.18.