Mengintegrasikan i-mobile 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 i-mobile menggunakan mediasi, yang mencakup integrasi waterfall. Hal ini membahas cara menambahkan i-mobile ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan i-mobile SDK dan adaptor ke Android aplikasi.

Antarmuka dasbor untuk i-mobile menggunakan teks bahasa Jepang untuk label, tombol, dan deskripsinya. Screenshot dalam panduan ini belum diterjemahkan. Namun, dalam deskripsi dan petunjuk panduan ini, label dan tombol diterjemahkan dengan kata yang setara dalam bahasa Inggris dalam tanda kurung.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk i-mobile memiliki kemampuan berikut:

Integrasi
Bidding
Air terjun
Format
Banner
Interstisial
Diberikan sebagai reward
Native

Persyaratan

  • Android API level 19 atau yang lebih tinggi
  • Google Mobile Ads SDK terbaru

Langkah 1: Siapkan i-mobile

Daftar atau login ke akun i-mobile Anda.

Tambahkan aplikasi Anda ke dasbor i-mobile dengan mengklik tab サん語/アプ分管王 (Pengelolaan Situs/Aplikasi) dan mengklik tab ROAS規Androidアプ分 (Aplikasi Android Baru) .

Daftarkan aplikasi Anda dengan memberikan 名称 (Nama) dan マーケッんURL (URL Pasar). Kemudian, klik tombol ROAS規登録 (Daftar) setelah Anda mengisi formulir lainnya.

Untuk membuat Spot Iklan baru, pilih aplikasi Anda pada tab サんん/アプ分管王 (Pengelolaan Situs/Aplikasi).

Buka tab 広告ん苯ッל管王 (Pengelolaan Spot Iklan) lalu klik tombol ROAS規広告ん苯ッ分 (Tempat Iklan Baru)

buat_tempat_iklan

Selanjutnya, isi formulir dengan memberikan 広告ん苯ッん名 (nama Ad Spot), 広告ん苯ッんサんズ (ukuran spot Iklan) dan detail lainnya. Lalu, klik tombol ROAS規登録 (Daftar).

formulir_spot_iklan_baru

Spot iklan baru Anda sudah siap. Untuk melihat detail integrasinya, klik tombol アプ分號定取得 (Dapatkan setelan Aplikasi).

daftar_spot_iklan

Catat パお分ッんャーID (ID Penayang), メデんアID (ID Media), dan 🙌')}>ッ分ID (ID Spot). Anda akan memerlukan parameter ini nanti saat mengonfigurasi i-mobile untuk mediasi di AdMob UI.

Langkah 2: Konfigurasikan setelan mediasi untuk AdMob unit iklan

Sekarang Anda harus menambahkan i-mobile ke konfigurasi mediasi untuk unit iklan Anda. Untuk melakukannya, login ke akun AdMob terlebih dahulu.

Selanjutnya, buka tab Mediasi. Jika sudah memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, dan langsung pilih Tambahkan i-mobile sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Tab mediasi AdMob

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Diaktifkan. Lalu klik Tambahkan Unit Iklan.

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

Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang Anda pilih.

Menambahkan i-mobile sebagai sumber iklan

Di kartu Sumber Iklan, pilih Tambahkan Jaringan Iklan.

Pilih i-mobile dan aktifkan fitur Optimize. Masukkan Nama Login dan Sandi API dari akun i-mobile Anda guna menyiapkan pengoptimalan sumber iklan untuk i-mobile. Kemudian, masukkan nilai eCPM untuk i-mobile dan klik Continue.

Masukkan ID Penayang, ID Media, dan ID Spot, yang diperoleh sebelumnya.

Langkah 3: Impor i-mobile SDK dan Adaptor

Tambahkan dependensi penerapan berikut dengan versi terbaru SDK dan adaptor i-mobile di file build.gradle level aplikasi:

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

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.5.0'
    implementation 'com.google.ads.mediation:imobile:2.3.0.0'
}
...

Integrasi manual

  1. Download versi terbaru i-mobile SDK dan ekstrak android-ad-sdk.aar pada folder sdk, lalu tambahkan ke project Anda.

  2. Buka artefak adaptor i-mobile di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor i-mobile, dan tambahkan ke project Anda.

Langkah 4: Diperlukan kode tambahan

Kode tambahan tidak diperlukan untuk integrasi i-mobile.

Langkah 5: Uji penerapan Anda

Untuk menguji integrasi Anda, i-mobile menyediakan ID Spot, ID Media, dan ID Penayang untuk semua format iklan. Anda dapat menemukannya di sini.

Langkah opsional

Menggunakan iklan native

Rendering iklan

Adaptor i-mobile mengisi deskripsi kolom lanjutan iklan native untuk NativeAd.

Kolom Aset selalu disertakan oleh adaptor i-mobile
Judul
Gambar
Body
Ikon aplikasi 1
Call to action
Rating bintang
App Store
Harga

1 Untuk iklan native, SDK i-mobile tidak menyediakan aset ikon aplikasi. Sebaliknya, adaptor i-mobile mengisi ikon aplikasi dengan gambar transparan.

Kode error

Jika adaptor gagal menerima iklan dari i-mobile, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdapterResponse() pada class berikut:

Format Nama kelas
Banner com.google.ads.mediasi.imobile.IMobileAdapter
Interstisial com.google.ads.mediasi.imobile.IMobileAdapter
Native com.google.ads.mediasi.imobile.IMobileMediationAdapter

Berikut adalah kode dan pesan pendamping yang ditampilkan oleh adaptor i-mobile saat iklan gagal dimuat:

Kode error Alasan
0-99 SDK i-mobile menampilkan error. Lihat kode untuk detail selengkapnya.
101 i-mobile memerlukan konteks Activity untuk memuat iklan.
102 Parameter server i-mobile yang dikonfigurasi di AdMob UI tidak ada/tidak valid.
103 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung i-mobile.
104 Callback keberhasilan pemuatan iklan native i-mobile menampilkan daftar iklan native yang kosong.
0-10 SDK i-mobile menampilkan error. Lihat kode untuk detail selengkapnya.
101 Parameter server i-mobile yang dikonfigurasi di AdMob UI tidak ada/tidak valid.
102 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung i-mobile.
103 i-mobile gagal menampilkan iklan.
104 i-mobile menampilkan array iklan native yang kosong.
105 i-mobile gagal mendownload aset iklan native.
106 i-mobile tidak mendukung permintaan beberapa iklan interstisial menggunakan ID Spot yang sama.

Log Perubahan Adaptor Mediasi Android i-mobile

Versi 2.3.0.0

  • Kompatibilitas terverifikasi dengan SDK i-mobile v2.3.0.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 21.3.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 21.3.0.
  • IMobile SDK versi 2.3.0.

Versi 2.0.23.1

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

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 21.0.0.
  • IMobile SDK versi 2.0.23.

Versi 2.0.23.0

  • Kompatibilitas terverifikasi dengan SDK i-mobile v2.0.23.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.5.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 20.5.0.
  • IMobile SDK versi 2.0.23.

Versi 2.0.22.2

  • Menambahkan kode dan pesan error adaptor standar.
  • Mengupdate versi minimum Google Mobile Ads SDK ke 20.1.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 20.1.0.
  • IMobile SDK versi 2.0.22.

Versi 2.0.22.1

  • Mengupdate versi minimum Google Mobile Ads SDK ke 20.0.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 20.0.0.
  • IMobile SDK versi 2.0.22.

Versi 2.0.22.0

  • Kompatibilitas terverifikasi dengan SDK i-mobile v2.0.22.
  • Memperbarui adaptor untuk mendukung permintaan banner adaptif inline.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 19.1.0.
  • IMobile SDK versi 2.0.22.

Versi 2.0.21.0

  • Kompatibilitas terverifikasi dengan SDK i-mobile v2.0.21.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.1.0.
  • Menambahkan dukungan untuk menskalakan iklan banner adaptif.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 19.1.0.
  • IMobile SDK versi 2.0.21.

Versi 2.0.20.2

  • Menambahkan dukungan untuk ukuran iklan banner yang fleksibel.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 18.3.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 18.3.0.
  • IMobile SDK versi 2.0.20.

Versi 2.0.20.1

  • Adaptor kini menampilkan rasio lebar tinggi mediaContent yang bukan nol.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 18.2.0.
  • IMobile SDK versi 2.0.20.

Versi 2.0.20.0

  • Rilis awal!
  • Menambahkan dukungan untuk banner, interstisial, dan iklan native.