Mengintegrasikan maio dengan Mediasi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Antarmuka dasbor maio menggunakan teks bahasa Jepang untuk label, tombol, dan deskripsinya, serta screenshot dalam panduan ini belum diterjemahkan. Namun, dalam deskripsi dan petunjuk panduan ini, label dan tombol direferensikan dengan padanan bahasa Inggrisnya. 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
  • Google Mobile Ads SDK terbaru

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 URL Aplikasi Anda. Pilih Interstisial video sebagai Jenis Iklan, lalu klik Perbarui.

Diberikan sebagai reward

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

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

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

Selain ID Media dan ID Zona, Anda memerlukan ID API 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 harus menambahkan Maino ke konfigurasi mediasi untuk unit iklan Anda. Pertama, login ke akun AdMob.

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.

Berikan Name pada grup mediasi, lalu pilih lokasi yang akan ditargetkan. Berikutnya, setel status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.

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

Sekarang Anda akan melihat kartu unit iklan yang terisi dengan unit iklan yang Anda pilih seperti yang ditunjukkan di bawah:

Tambahkan maio sebagai sumber iklan

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

Masukkan Media ID dan Zone ID yang diperoleh di bagian sebelumnya, lalu klik Done.

Menggunakan iklan video reward

Di setelan untuk unit iklan video reward, berikan nilai untuk jumlah reward dan jenis reward. Kemudian, untuk memastikan Anda memberikan reward yang sama kepada pengguna, apa pun jaringan iklan yang ditayangkan, centang kotak Terapkan untuk semua jaringan di grup Mediasi.

Jika setelan ini tidak diterapkan, adaptor maio akan ditetapkan secara default ke reward jenis "" (string kosong) dengan nilai 1. SDK maio tidak memberikan nilai reward tertentu untuk iklan video reward.

Untuk informasi selengkapnya tentang cara menetapkan nilai reward untuk unit iklan AdMob, lihat Membuat unit iklan.

Langkah 3: Impor adaptor dan SDK maio

Tambahkan repositori Maven maio dan dependensi penerapan berikut dengan versi terbaru maio SDK dalam 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:21.3.0'
   implementation 'com.google.ads.mediation:maio:1.1.16.1'
}
...

Integrasi manual

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

Langkah 4: Diperlukan kode tambahan

Tidak diperlukan kode tambahan untuk integrasi maio Android.

Langkah 5: Uji penerapan Anda

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

Kode error

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

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

Berikut adalah kode dan pesan pendamping yang dilemparkan oleh adaptor maio saat iklan gagal dimuat:

Kode error Alasan
0-10 maio menampilkan error khusus SDK. Lihat kode dan dokumentasi maio untuk detail selengkapnya.
101 Maio tidak memiliki iklan yang tersedia.
102 Parameter server tidak valid (mis., ID Penempatan tidak ada).
103 Konteks yang digunakan untuk memuat iklan bukan dalam instance `Activity`.
0-10 maio menampilkan error khusus SDK. Lihat kode maio untuk detail selengkapnya.
101 maio belum memiliki iklan.
102 Parameter server tidak valid (mis., 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 1.1.16.1

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

Dibuat 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 maio tambahan.
  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.16.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.4.0.

Dibuat 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 minimum Google Mobile Ads SDK yang diperlukan ke versi 20.0.0.

Dibuat 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 terstandardisasi.
  • Kompatibilitas terverifikasi dengan maio SDK versi 1.1.14.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.8.0.

Dibuat 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.

Dibuat dan diuji dengan:

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

Versi 1.1.12.0

  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.4.0.

Dibuat 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 kini akan langsung gagal jika Mao tidak memiliki iklan yang siap ditampilkan.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.1.0.

Dibuat 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.
  • Versi Google Mobile Ads SDK minimum yang diperlukan telah diupdate ke versi 18.3.0.

Dibuat 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.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate 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

  • Memperbarui adaptor untuk mendukung Rewarded API baru.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate 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

  • Memperbarui adaptor untuk 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

  • Memperbarui adaptor dengan fungsi inisialisasi yang diperbarui.

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 uji ke AdRequest.
  • Kompatibilitas terverifikasi dengan maio SDK versi 1.0.7.

Versi 1.0.6.0

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