Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK for React Native untuk memuat dan menampilkan iklan dari maio menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan maio ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan SDK dan adaptor maio ke aplikasi React Native.
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 スキーム," adalah "URL Scheme,".
Integrasi dan format iklan yang didukung
Adaptor mediasi untuk maio memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Air Terjun | |
| Format | |
| Membuka Aplikasi | |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
| Native | |
Prasyarat
Sebelum melanjutkan, pastikan hal berikut:
- Versi Google Mobile Ads SDK for React Native terbaru.
- Framework React Native versi 0.85.0 atau yang lebih baru.
- Untuk men-deploy di Android
- Android API level 24 atau yang lebih baru.
- Untuk men-deploy di iOS
- Target deployment iOS 15.0 atau yang lebih baru.
- Project React Native yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK for React Native.
Lihat Menyiapkan Google Mobile Ads SDK for React Native untuk mengetahui detailnya.
- Pastikan Anda telah mendownload dan mengekstrak folder
adaptersdari foldergma-sdk-react-native. Jika Anda tidak memiliki folderadapters, ikuti langkah satu, dua, dan tiga di Menginstal Google Mobile Ads SDK for React Native.
- Pastikan Anda telah mendownload dan mengekstrak folder
- Siapkan Mediasi AdMob.
Langkah 1: Siapkan konfigurasi di UI maio
Pertama, daftar atau login ke akun maio Anda. Klik tombol Application management di sidebar kiri, lalu klik New app.

Pilih tab yang sesuai dengan Jenis Iklan yang Anda inginkan.
Interstisial
Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL Aplikasi Anda. Pilih Interstisial video sebagai Jenis Iklan, lalu klik Perbarui.
Android

iOS

Reward
Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL Aplikasi Anda. Pilih Video Reward sebagai Jenis Iklan, lalu klik Perbarui.
Android

iOS

Di halaman Application Management, catat ID media. ID ini diperlukan untuk menyiapkan unit iklan AdMob di bagian berikutnya.
Android

iOS

Di halaman Zone Management, catat Zone ID. ID ini juga akan diperlukan untuk menyiapkan unit iklan AdMob di bagian berikutnya.
Android

iOS


Langkah 2: Siapkan permintaan maio di UI AdMob
Mengonfigurasi setelan mediasi untuk unit iklan Anda
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
Di direktori root project Anda, instal adaptor mediasi Google Mobile Ads SDK for React Native untuk maio. Selesaikan langkah-langkah berikut:
Salin file tar adaptor Google Mobile Ads SDK for React Native dari direktori
gma-sdk-react-native/adapters/maio/ke direktorilocal_packages/project Anda. Jika Anda tidak memiliki folderadapters, lihat Prasyarat.mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/maio/gma-mediation-maio-0.1.0.tgz local_packages/Ganti EXTRACT_DIR dengan jalur ke direktori tempat Anda mengekstrak arsip.
Instal paket adaptor menggunakan pengelola paket pilihan Anda:
npm
npm install ./local_packages/gma-mediation-maio-0.1.0.tgzbenang
yarn add ./local_packages/gma-mediation-maio-0.1.0.tgzJika Anda mem-build untuk Android, tambahkan repositori berikut ke file
build.gradledi direktoriandroidproject Anda:repositories { google() mavenCentral() maven { url = uri("https://imobile-maio.github.io/maven") } }
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
Mengaktifkan iklan pengujian
Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.
Penayang yang menggunakan Google Mobile Ads SDK for React Native versi 7.26.0 atau yang lebih tinggi akan otomatis menerima iklan percobaan dari maio di ponsel dan tablet yang terdaftar sebagai perangkat pengujian saat membuat permintaan.
Memverifikasi iklan pengujian
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari maio, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan maio (Waterfall).
Kode error
Jika adaptor gagal menerima iklan dari maio, penayang dapat memeriksa
error yang mendasarinya dari respons iklan 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 | Maio tidak memiliki iklan yang tersedia. |
| 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. |
Versi 0.1.0
- Rilis awal.
- Mendukung adaptor Android maio versi 2.0.9.1.
- Mendukung adaptor iOS maio versi 2.2.1.2.1.