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, dan cara mengintegrasikan SDK dan adaptor maio ke dalam aplikasiAndroid .

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 panduan ini, label dan tombol direferensikan bersama padanannya dalam bahasa Inggris. Misalnya,"URL \\ーム", adalah "Skema URL", dan seterusnya.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk maio memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner
Interstisial
Diberikan sebagai reward
Native

Persyaratan

  • Android API level 19 atau yang lebih tinggi
  • maio SDK 1.0.7 atau yang lebih tinggi

Langkah 1: Siapkan jaringan maio

Pertama, daftar atau login ke akun maio Anda. Klik tombol Application management di sidebar kiri dan klik New app.

Pilih tab yang sesuai dengan Jenis Iklan pilihan Anda.

Interstisial

Masukkan Name aplikasi Anda, tetapkan platform sebagai Android dan berikan App URL Anda. Pilih Interstisial video sebagai Jenis Iklan, lalu klik Perbarui.

Diberikan sebagai reward

Masukkan Name aplikasi Anda, tetapkan platform sebagai Android dan berikan App URL Anda. Pilih Video Rewards sebagai Jenis Iklan, lalu klik Perbarui.

Di halaman Pengelolaan Aplikasi, catat ID Media. Anda perlu menyiapkan AdMob unit iklan di bagian berikutnya.

Di halaman Pengelolaan Zona, catat ID Zona. Anda juga perlu menyiapkan AdMob unit iklan di bagian berikutnya.

Selain Media ID dan Zone ID, Anda akan memerlukan API ID dan API KEY untuk menyiapkan ID unit iklan Android untuk mediasi.

Di halaman Reporting API, catat ID API dan KUNCI API.

Langkah 2: Konfigurasikan setelan mediasi untuk AdMob unit iklan Anda

Anda harus menambahkan maio ke konfigurasi mediasi untuk unit iklan Anda. Pertama, login ke akun AdMob Anda.

Buka tab Mediasi. Jika Anda sudah memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan maio sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan Format Iklan dan Platform Anda, lalu klik Lanjutkan.

Beri Nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Enabled, lalu klik Add Ad Units.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob Anda yang ada. Kemudian, klik Selesai.

Sekarang Anda akan melihat kartu unit iklan diisi dengan unit iklan yang dipilih seperti yang ditunjukkan di bawah:

Tambahkan maio sebagai sumber iklan

Di kartu Sumber Iklan, pilih Tambahkan Jaringan Iklan. Pilih maio sebagai jaringan iklan dan masukkan API ID dan API KEY yang diperoleh di bagian sebelumnya guna menyiapkan pengoptimalan sumber iklan untuk maio. Lalu masukkan nilai eCPM untuk maio dan klik Continue.

Jika sudah memiliki pemetaan untuk maio, Anda cukup memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan Mapping name, Media ID, dan Zone ID yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Langkah 3: Impor maio SDK dan adaptor

Tambahkan repositori Maven Maven berikut dan dependensi implementasinya dengan maio SDK versi terbaru di file build.gradle level aplikasi:

repositories {
    google()
    mavenCentral()
    maven {
        url "https://imobile-maio.github.io/maven"
    }
}

...
dependencies {
   implementation 'com.google.android.gms:play-services-ads:22.4.0'
   implementation 'com.google.ads.mediation:maio:1.1.16.2'
}
...

Integrasi manual

  • Download versi terbaru maio Android SDK dan tambahkan ke project Anda.
  • Buka maio adaptor keys di Google Maven Repository. Pilih versi terbaru, download file `.aar' adaptor maio, dan tambahkan ke project Anda.

Langkah 4: Kode tambahan diperlukan

Tidak ada kode tambahan yang diperlukan untuk integrasi Android maio.

Langkah 5: Uji penerapan Anda

Penayang yang menggunakan Google Mobile Ads SDK versi 11.6.0 atau yang lebih tinggi akan otomatis menerima iklan percobaan dari maio di ponsel dan tablet yang terdaftar sebagai test devices saat melakukan permintaan.

Kode error

Jika adaptor gagal menerima iklan dari maio, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdapterResponses() dalam class berikut:

Format Nama class
Interstisial jp.maio.sdk.android.mediasi.admob.adapter.Interstitial
Diberikan sebagai reward jp.maio.sdk.android.mediasi.admob.adapter.Rewarded

Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor maio saat iklan gagal dimuat:

Kode error Alasan
0-10 maio menampilkan error khusus SDK. Lihat code dan dokumentasi maio untuk 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 merupakan instance `Aktivitas`.
0-10 maio menampilkan error khusus SDK. Lihat kode maio untuk 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 Adaptor Mediasi Android maio

Versi Berikutnya

  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 22.4.0.

Versi 1.1.16.2

  • Mengupdate adaptor untuk menggunakan class VersionInfo baru.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 22.0.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.0.0.
  • Maio SDK versi 1.1.16.

Versi 1.1.16.1

  • Mengupdate compileSdkVersion dan targetSdkVersion ke API 31.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 21.0.0.
  • Mengupdate API level Android minimum yang diperlukan ke 19.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.0.0.
  • Maio SDK versi 1.1.16.

Versi 1.1.16.0

  • Memperbarui kode error untuk menangkap error besar tambahan.
  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.16.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 20.4.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 20.4.0.
  • Maio SDK versi 1.1.16.

Versi 1.1.15.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.15.
  • Mengupdate versi Google Mobile Ads SDK minimum yang diperlukan ke 20.0.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 20.0.0.
  • Maio SDK versi 1.1.15.

Versi 1.1.14.0

  • Menambahkan kode dan pesan error adaptor standar.
  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.14.
  • Mengupdate versi Google Mobile Ads SDK minimum yang diperlukan ke 19.8.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 19.8.0.
  • Maio SDK versi 1.1.14.

Versi 1.1.13.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.13.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.5.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 19.5.0.
  • Maio SDK versi 1.1.13.

Versi 1.1.12.0

  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.4.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 19.4.0.
  • Maio SDK versi 1.1.12.

Versi 1.1.11.1

  • Untuk membatasi waktu tunggu, permintaan iklan sekarang akan segera gagal jika maio belum memiliki iklan yang siap untuk ditampilkan.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.1.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 19.1.0.
  • Maio SDK versi 1.1.11.

Versi 1.1.11.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.11.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 18.3.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 18.3.0.
  • Maio SDK versi 1.1.11.

Versi 1.1.10.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.10.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 18.2.0.

Versi 1.1.8.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.8.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 18.1.0.

Versi 1.1.7.0

  • Perbaikan Bug.
  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.7.

Versi 1.1.6.1

  • Mengupdate adaptor untuk mendukung Reward API baru.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 17.2.0.

Versi 1.1.6.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.6.

Versi 1.1.5.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.5.

Versi 1.1.4.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.4.

Versi 1.1.3.1

  • Mengupdate adaptor agar berfungsi dengan class instance, bukan singleton.

Versi 1.1.3.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.3.

Versi 1.1.2.1

  • Mengupdate adaptor dengan fungsi inisialisasi yang diupdate.

Versi 1.1.2.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.2.

Versi 1.1.1.1

  • Memperbarui adaptor untuk memanggil peristiwa iklan onRewardedVideoComplete().

Versi 1.1.1.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.1.

Versi 1.1.0.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.0.

Versi 1.0.8.0

  • Kompatibilitas terverifikasi dengan maio SDK versi 1.0.8.

Versi 1.0.7.1

  • Memperbaiki masalah yang dapat menyebabkan NullPointerExceptions terjadi saat iklan gagal dimuat.

Versi 1.0.7.0

  • Menambahkan kemampuan untuk mengaktifkan mode pengujian dengan menambahkan ID perangkat pengujian ke AdRequest.
  • Kompatibilitas terverifikasi dengan maio SDK versi 1.0.7.

Versi 1.0.6.0

  • Rilis pertama!
  • Menambahkan dukungan untuk iklan video reward dan interstisial.