Mengintegrasikan maio dengan mediasi

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari maio menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini mencakup cara menambahkan maio ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan maio SDK dan adaptor ke dalam aplikasi Unity.

Antarmuka dasbor untuk maio menggunakan teks bahasa Jepang untuk label, tombol, dan deskripsinya, dan screenshot dalam panduan ini belum diterjemahkan. Namun, dalam deskripsi dan petunjuk di sini, label dan tombol disebut dengan padanan bahasa Inggrisnya. Misalnya,"URL ホnyataーム", adalah "Skema URL", dan sebagainya.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk maio memiliki kemampuan berikut:

Integrasi
Bidding
Waterfall
Format
Banner
Interstisial
Diberikan sebagai reward

Persyaratan

• Unity 4 atau yang lebih tinggi
• Google Mobile Ads SDK terbaru
• Untuk men-deploy di Android
  • Android API level 19 atau yang lebih tinggi
• Untuk men-deploy di iOS
  • Target deployment iOS 12.0 atau yang lebih tinggi
• Project Unity berfungsi yang dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
• Selesaikan mediasi Panduan memulai

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

Catatan: Iklan interstisial dari maio dapat dilewati secara default.

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

Catatan: Iklan Video Reward dari maio TIDAK dapat dilewati secara default.

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

(Khusus waterfall) Selain Media ID dan Zone ID, Anda memerlukan API ID dan API KEY guna menyiapkan ID unit iklan untuk mediasi. Di halaman Reporting API, catat ID API dan API KEY.

Catatan: (Khusus waterfall) Jika ini pertama kalinya Anda menyiapkan akun maio, Anda mungkin perlu menghubungi tim dukungan maio agar API ID dan API KEY dapat diberikan untuk Anda.

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

Catatan: Kegagalan untuk mengintegrasikan versi maio dan Google Mobile Ads SDK yang kompatibel dapat menyebabkan masalah build.

Download plugin mediasi Google Mobile Ads untuk maio versi terbaru dari link download di Changelog untuk maio, lalu 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 Impor.

Lalu, pilih Assets > Play Services Resolver > Android Resolver > Force Resolve. Library Resolver Layanan Unity Play akan melakukan penyelesaian 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 Anda

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.

Penting: Nonaktifkan mode pengujian untuk AdMob dan maio sebelum merilis aplikasi.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari maio, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan maio (Bidding) and maio (Waterfall) sumber iklan.

Kode error

Jika adaptor gagal menerima iklan dari maio, penayang dapat memeriksa error yang mendasari dari respons iklan menggunakan ResponseInfo dalam kelas berikut:

Android

Format	Nama kelas
Interstisial	jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Diberikan sebagai reward	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Format	Nama kelas
Interstisial	GADMMaioInterstitialAdapter
Diberikan sebagai 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 spesifik SDK. Lihat kode dan dokumentasi maio untuk detail selengkapnya.
101	Maio tidak memiliki iklan.
102	Parameter server tidak valid (misalnya ID Penempatan tidak ada).
103	Konteks yang digunakan untuk memuat iklan bukanlah instance `Activity`.

iOS

Kode error	Alasan
0-10	maio menampilkan error spesifik SDK. Lihat kode maio untuk 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 sudah dimuat untuk konfigurasi jaringan ini.

Log Perubahan Plugin Mediasi Unity

Versi 2.0.0

• Mendukung aio Android maio versi 1.1.16.2.
• Mendukung adaptor iOS maio versi 2.1.1.0.
• Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.

Versi 1.4.3

• Memindahkan konten adaptor ke GoogleMobileAds/Mediation/Maio/.
• Mendukung aio Android maio versi 1.1.16.2.
• Mendukung adaptor iOS maio versi 1.6.3.1.
• Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.1.0.

Versi 1.4.2

• Mendukung aio Android maio versi 1.1.16.1.
• Mendukung adaptor iOS maio versi 1.6.3.0.
• Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.0.

Versi 1.4.1

• Mendukung aio 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 aio 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 aio Android maio versi 1.1.16.0.
• Mendukung adaptor iOS maio versi 1.5.8.0.

Versi 1.3.5

• Mendukung aio Android maio versi 1.1.15.0.
• Mendukung adaptor iOS maio versi 1.5.6.1.

Versi 1.3.4

• Mendukung aio Android maio versi 1.1.11.1.
• Mendukung adaptor iOS maio versi 1.5.4.0.

Versi 1.3.3

• Mendukung aio Android maio versi 1.1.11.1.
• Mendukung adaptor iOS maio versi 1.5.3.1.

Versi 1.3.2

• Mendukung aio Android maio versi 1.1.11.0.
• Mendukung adaptor iOS maio versi 1.5.2.1.

Versi 1.3.1

• Mendukung aio Android maio versi 1.1.10.0.
• Mendukung adaptor iOS maio versi 1.5.1.0.

Versi 1.3.0

• Mendukung aio 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 baru.
• Mendukung maio Android adaptor versi 1.1.7.0.
• Mendukung maio iOS adaptor versi 1.4.6.0.

Versi 1.2.2

• Mendukung maio Android adaptor versi 1.1.6.0.
• Mendukung maio iOS adaptor versi 1.4.2.0.

Versi 1.2.1

• Mendukung maio Android adaptor versi 1.1.6.0.
• Mendukung maio iOS adaptor versi 1.4.1.0.

Versi 1.2.0

• Mendukung maio Android adaptor versi 1.1.4.1.
• Mendukung maio iOS adaptor 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 maio iOS adaptor versi 1.3.1.1.

Versi 1.1.0

• Mendukung maio Android adaptor versi 1.1.0.0.
• Mendukung maio iOS adaptor 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.