Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari maio menggunakan mediasi, yang membahas integrasi waterfall. Artikel ini membahas cara menambahkan maio ke konfigurasi mediasi, dan cara mengintegrasikan SDK dan adaptor maio ke 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. "URL ホテーYA," misalnya, adalah "Skema URL", 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 dan klik Aplikasi baru.
Pilih tab yang sesuai dengan Jenis Iklan pilihan Anda.
Interstisial
Masukkan Nama aplikasi Anda, pilih platform, dan masukkan URL Aplikasi Anda. Pilih Interstisial video sebagai Jenis Iklan, lalu klik Perbarui.
Android
iOS
Diberikan sebagai reward
Masukkan Nama aplikasi Anda, pilih platform, dan masukkan URL Aplikasi Anda. Pilih Video Rewards sebagai Jenis Iklan, lalu klik Perbarui.
Android
iOS
Di halaman Pengelolaan Aplikasi, catat ID Media. Anda perlu menyiapkan AdMob unit iklan di bagian selanjutnya.
Android
iOS
Di halaman Pengelolaan Zona, catat ID Zona. Anda juga perlu menyiapkan AdMob unit iklan di bagian berikutnya.
Android
iOS
Langkah 2: Siapkan permintaan maio di AdMob UI
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 Anda memiliki OpenUPM-CLI sudah diinstal, Anda dapat menginstal layanan Google Mobile Ads Plugin Mediasi untuk Unity ke project Anda dengan menjalankan perintah berikut dari direktori utama project Anda:
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.
Pada tab Scoped Registries, tambahkan OpenUPM sebagai scope registry 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 maio Google Mobile Ads dan klik Install.
Paket Unity
Download versi terbaru plugin mediasi Google Mobile Ads untuk
maio dari link download di
tindakan
Log perubahan
lalu mengekstrak
GoogleMobileAdsMaioMediation.unitypackage
dari zip
.
Di editor project Unity, pilih Assets > Impor Paket >
Custom Package dan temukan
GoogleMobileAdsMaioMediation.unitypackage
yang didownload. Pastikan semua file dipilih dan klik
Impor.
Kemudian, pilih Assets > Play Services Resolver >
Android Resolver > Force Resolve. Resolver Layanan Unity Play
library akan melakukan resolusi dependensi dari awal, lalu menyalin
dependensi yang dideklarasikan ke dalam direktori Assets/Plugins/Android
aplikasi Unity.
Langkah 4: Tambahkan kode yang diperlukan
Android
Tidak ada kode tambahan yang diperlukan 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 mendasar dari respons iklan dengan menggunakan
ResponseInfo
di bagian
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. |
102 | Parameter server tidak valid (misalnya, ID Penempatan tidak ada). |
103 | Adaptor maio tidak mendukung format iklan yang diminta. |
104 | Iklan telah 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.
- Dibuat 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.
- Dibuat 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.
- Dibangun 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.
- Dibangun 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.
- Dibuat 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.
- Dibuat 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 maio Android adaptor versi 1.1.7.0.
- Mendukung adaptor iOS maio versi 1.4.6.0.
Versi 1.2.2
- Mendukung maio Android adaptor versi 1.1.6.0.
- Mendukung adaptor iOS maio versi 1.4.2.0.
Versi 1.2.1
- Mendukung maio Android adaptor 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 maio iOS adaptor versi 1.3.2.0.
Versi 1.1.2
- Mendukung maio Android adaptor versi 1.1.3.0.
- Mendukung maio iOS adaptor 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 maio Android SDK versi 1.0.7.
- Mendukung maio iOS SDK versi 1.2.19.
Versi 1.0.0
- Rilis pertama!
- Mendukung maio Android SDK versi 1.0.6.
- Mendukung maio iOS SDK versi 1.2.18.