Mengintegrasikan InMobi dengan mediasi

Pilih platform: Android (beta) Android iOS Unity Flutter

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari InMobi menggunakan Mediasi AdMob, yang mencakup integrasi waterfall dan bidding. Panduan ini mencakup cara menambahkan InMobi ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan InMobi SDK dan adapter ke aplikasi Android.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk InMobi memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner
Interstisial
Reward
Native

Persyaratan

• Level API Android 24 atau yang lebih tinggi

• [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan adaptor InMobi 10.6.3.0 atau yang lebih tinggi (sebaiknya gunakan versi terbaru)

• GMA Next-Gen SDK Terbaru

• Selesaikan Panduan memulai mediasi

Langkah 1: Siapkan konfigurasi di UI InMobi

Daftar untuk mendapatkan akun InMobi.

Setelah akun Anda diverifikasi, login.

Tambahkan aplikasi

Untuk menambahkan aplikasi Anda ke dasbor InMobi, klik Inventaris > Setelan Inventaris.

Klik Tambahkan Inventaris, lalu pilih channel Aplikasi Seluler dari menu drop-down.

Mulai ketik URL toko aplikasi yang dipublikasikan di kotak penelusuran, lalu pilih aplikasi dari hasil yang otomatis diisi. Klik Continue.

Jika aplikasi Anda belum dipublikasikan, klik Tautkan secara manual dan masukkan detail yang diperlukan. Klik Continue.

Tinjau setelan Kepatuhan Aplikasi & Situs, lalu klik Simpan dan Buat Penempatan.

Penempatan

Setelah Anda menyiapkan inventaris, sistem akan mengalihkan Anda ke alur kerja pembuatan penempatan.

Catatan: Jika sistem tidak mengalihkan Anda ke alur kerja pembuatan penempatan, buka Inventaris > Setelan Inventaris. Kemudian, telusuri aplikasi atau situs yang ingin Anda buat penempatannya. Klik Tambahkan penempatan.

Bidding

Catatan: Hubungi Account Manager Anda untuk mendapatkan akses guna mengonfigurasi bidding di dasbor InMobi.

Pilih jenis unit iklan. Masukkan Nama Penempatan, pilih Aktif dan Bidding Terbuka Google untuk Bidding Audiens dan Partner masing-masing, lalu isi bagian formulir lainnya. Klik Buat Penempatan setelah selesai.

Air Terjun

Pilih jenis unit iklan. Kemudian, masukkan Nama Penempatan, pilih Nonaktif untuk Bidding Audiens, dan isi bagian formulir lainnya. Klik Buat Penempatan setelah selesai.

Setelah penempatan dibuat, detailnya akan ditampilkan. Catat ID Penempatan, yang akan digunakan untuk menyiapkan unit iklan AdMob Anda.

Catatan: ID Penempatan InMobi ada di bawah nama penempatan.

ID Akun

ID akun InMobi Anda tersedia di bagian Finance > Payment Settings > Payment Information.

Menemukan Kunci API Pelaporan InMobi

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Air Terjun

Buka Akun Saya > Setelan Akun. Buka tab API Key lalu klik Generate API Key.

Pilih email pengguna yang memerlukan kunci, lalu klik Buat Kunci API. File yang berisi kunci API dan nama pengguna/nama login akan dibuat.

Hanya administrator penayang akun yang dapat membuat kunci API untuk semua pengguna. Jika Anda lupa kunci API yang dibuat sebelumnya, reset kunci API Anda dengan mengarahkan kursor ke email Anda di tab API Key.

Memperbarui app-ads.txt

Authorized Sellers for Apps app-ads.txt adalah inisiatif IAB Tech Lab yang membantu memastikan inventaris iklan aplikasi Anda hanya dijual melalui saluran yang telah Anda identifikasi sebagai resmi. Untuk mencegah kerugian pendapatan iklan yang signifikan, Anda harus menerapkan file app-ads.txt. Jika Anda belum melakukannya, siapkan file app-ads.txt untuk aplikasi Anda.

Untuk menerapkan app-ads.txt untuk InMobi, Tambahkan cuplikan kode yang dipersonalisasi.

Mengaktifkan mode pengujian

Aktifkan Mode Pengujian untuk penempatan Anda pada semua tayangan iklan aktif atau hanya perangkat pengujian tertentu.

Catatan: Mode pengujian dinonaktifkan (Nonaktif) secara default untuk semua penempatan. Namun, mode pengujian dapat diaktifkan untuk penempatan di semua instance aplikasi atau hanya untuk perangkat yang Anda tentukan.

Langkah 2: Siapkan permintaan InMobi di UI AdMob

Mengonfigurasi setelan mediasi untuk unit iklan

Anda harus menambahkan InMobi ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan InMobi sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

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 satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Done.

Sekarang Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang Anda pilih:

Menambahkan InMobi sebagai sumber iklan

Bidding

Di bagian Sumber Iklan, di kartu Bidding, pilih Tambahkan sumber iklan. Kemudian, pilih InMobi (SDK).

Klik Cara menandatangani perjanjian kemitraan dan siapkan kemitraan bidding dengan InMobi.



Klik Pahami & setujui, lalu klik Lanjutkan.



Jika sudah memiliki pemetaan untuk InMobi, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan ID Akun dan ID Penempatan yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Penting: ID Aplikasi harus dikaitkan dengan aplikasi target seperti di UI InMobi.

Air Terjun

Di bagian kartu Waterfall di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan.

Pilih InMobi dan aktifkan tombol Optimalkan. Masukkan Nama Pengguna dan Kunci API yang diperoleh di bagian sebelumnya untuk menyiapkan pengoptimalan sumber iklan bagi InMobi. Kemudian, masukkan nilai eCPM untuk InMobi, lalu klik Lanjutkan.

Catatan: Anda hanya perlu menyiapkan pengoptimalan sumber iklan satu kali per jaringan.

Jika sudah memiliki pemetaan untuk InMobi, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan ID Akun dan ID Penempatan yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Penting: ID Aplikasi harus dikaitkan dengan aplikasi target seperti di UI InMobi.

Catatan: Pengoptimalan sumber iklan memerlukan waktu beberapa hari untuk mengumpulkan data yang cukup guna menghitung eCPM secara akurat untuk jaringan mediasi. Sementara itu, status pengoptimalan sumber iklan adalah PENDING, jadi Anda harus menetapkan nilai eCPM secara manual untuk jaringan. Setelah eCPM dapat dihitung, sumber iklan akan otomatis mulai memperbarui eCPM atas nama Anda.

Menambahkan InMobi ke daftar partner iklan GDPR dan peraturan negara bagian Amerika Serikat

Penting: Pastikan Anda memiliki izin Pengelolaan Akun untuk menyelesaikan konfigurasi untuk Izin dan GDPR Uni Eropa, peraturan Negara Bagian AS, dan Platform Pesan Pengguna. Lihat Mengelola akses pengguna ke akun Anda untuk mengetahui detailnya.

Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan InMobi ke daftar partner iklan peraturan negara bagian Eropa dan AS di UI AdMob.

Langkah 3: Impor InMobi SDK dan adaptor

Catatan: Kegagalan mengintegrasikan InMobi dan GMA Next-Gen SDK versi yang kompatibel dapat menyebabkan masalah build.

Integrasi Android Studio (direkomendasikan)

Dalam file gradle level aplikasi, tambahkan implementasi dependencies dan konfigurasi berikut:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:inmobi:11.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:inmobi:11.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrasi manual

1. Download InMobi Android SDK dan ekstrak file InMobiSDK.aar di folder libs, lalu tambahkan ke project Anda.

2. Buka artefak adaptor InMobi di Repositori Maven Google. Pilih versi terbaru, download file .aar adapter InMobi, lalu tambahkan ke project Anda.

3. InMobi juga memerlukan dependensi lain untuk disertakan. Lihat dokumentasi InMobi untuk mengetahui detail tambahan.

Langkah 4: Terapkan setelan privasi di InMobi SDK

Izin Uni Eropa dan GDPR

Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka untuk penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, dan untuk pengumpulan, pembagian, serta penggunaan data pribadi untuk personalisasi iklan. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Anda bertanggung jawab untuk memverifikasi bahwa izin diteruskan ke setiap sumber iklan dalam rantai mediasi Anda. Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Pada versi 7.1.0.0, adapter InMobi menambahkan class InMobiConsent yang memungkinkan Anda meneruskan informasi izin ke InMobi. Kode contoh berikut memanggil updateGDPRConsent() pada class InMobiConsent. Jika Anda memilih untuk memanggil metode ini, sebaiknya Anda melakukannya sebelum meminta iklan melalui GMA Next-Gen SDK.

Catatan: Aplikasi Anda harus mereferensikan InMobi adapter 7.1.0.0 atau yang lebih tinggi dan InMobi SDK 7.1.0 atau yang lebih tinggi untuk menggunakan kode di bawah.

Kotlin

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception)
}

InMobiConsent.updateGDPRConsent(consentObject)

Java

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception);
}

InMobiConsent.updateGDPRConsent(consentObject);

Lihat detail penerapan GDPR InMobi untuk mengetahui informasi selengkapnya tentang kemungkinan kunci dan nilai yang diterima InMobi dalam objek izin ini.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian AS mewajibkan pemberian hak kepada pengguna untuk memilih tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan terhadap hukum privasi negara bagian Amerika Serikat menawarkan kemampuan untuk mengaktifkan pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap jaringan iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rangkaian mediasi yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Pada versi 10.5.7.1, adaptor InMobi menambahkan dukungan untuk membaca string Privasi AS IAB dari preferensi bersama. Ikuti petunjuk di dokumentasi hukum privasi negara bagian Amerika Serikat untuk menyetel string Privasi Amerika Serikat di preferensi bersama.

Selain itu, lihat dokumentasi CCPA InMobi untuk mengetahui panduan tentang cara mengaktifkan setelan CCPA di dasbor InMobi.

Langkah 5: Kode tambahan diperlukan

Tidak ada kode tambahan yang diperlukan untuk integrasi InMobi.

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI InMobi.

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

Memverifikasi iklan percobaan

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

Langkah opsional

Izin

Untuk performa yang optimal, InMobi merekomendasikan penambahan izin opsional berikut ke file AndroidManifest.xml aplikasi Anda.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

Parameter khusus jaringan

Adaptor InMobi mendukung parameter permintaan tambahan yang dapat diteruskan ke adaptor sebagai Bundle Android. Adaptor mencari kunci berikut dalam paket:

Parameter dan nilai permintaan
InMobiNetworkKeys.AGE_GROUP Grup usia pengguna.	InMobiNetworkValues.BELOW_18 InMobiNetworkValues.BETWEEN_18_AND_24 InMobiNetworkValues.BETWEEN_25_AND_29 InMobiNetworkValues.BETWEEN_30_AND_34 InMobiNetworkValues.BETWEEN_35_AND_44 InMobiNetworkValues.BETWEEN_45_AND_54 InMobiNetworkValues.BETWEEN_55_AND_65 InMobiNetworkValues.ABOVE_65
InMobiNetworkKeys.EDUCATION Tingkat pendidikan pengguna.	InMobiNetworkValues.EDUCATION_HIGHSCHOOLORLESS InMobiNetworkValues.EDUCATION_COLLEGEORGRADUATE InMobiNetworkValues.EDUCATION_POSTGRADUATEORABOVE
InMobiNetworkKeys.AGE	String. Usia pengguna
InMobiNetworkKeys.POSTAL_CODE	String. Kode pos pengguna (biasanya berupa angka lima digit)
InMobiNetworkKeys.AREA_CODE	String. Kode area pengguna (bagian dari nomor telepon)
InMobiNetworkKeys.LANGUAGE	String. Bahasa asli pengguna (jika diketahui).
InMobiNetworkKeys.CITY	String. Kota pengguna
InMobiNetworkKeys.STATE	String. Negara bagian pengguna
InMobiNetworkKeys.COUNTRY	String. Negara pengguna
InMobiNetworkKeys.LOGLEVEL Menetapkan Level log untuk InMobi SDK.	InMobiNetworkValues.LOGLEVEL_NONE InMobiNetworkValues.LOGLEVEL_DEBUG InMobiNetworkValues.LOGLEVEL_ERROR

Berikut adalah contoh kode cara menyetel parameter permintaan iklan ini:

Kotlin

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44)
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE)
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Java

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44);
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE);
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter.class, extras)
   .build();

• Ganti AD_UNIT_ID dengan ID unit iklan Anda.

• Ganti AREA_CODE_VALUE dengan kode area.

Menggunakan iklan native

Rendering iklan

Adaptor InMobi menampilkan iklan native-nya sebagai objek NativeAd. Kolom ini mengisi Deskripsi kolom iklan native untuk NativeAd.

Kolom	Aset yang selalu disertakan oleh adaptor InMobi
Judul
Gambar	1
Tampilan media
Isi
Ikon aplikasi
Pesan ajakan (CTA)
Rating bintang
Toko
Harga

¹ Adaptor InMobi tidak memberikan akses langsung ke aset gambar utama untuk iklan native-nya. Sebagai gantinya, adaptor mengisi MediaView dengan video atau gambar.

Pelacakan tayangan dan klik

GMA Next-Gen SDK menggunakan callback InMobi SDK untuk pelacakan tayangan iklan dan klik, sehingga laporan di kedua dasbor harus cocok dengan sedikit atau tanpa perbedaan.

Kode error

Jika adapter gagal menerima iklan dari InMobi, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di class berikut:

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

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

Kode error	Alasan
0-99	Error SDK InMobi. Lihat kode untuk mengetahui detail selengkapnya.
100	Parameter server InMobi yang dikonfigurasi di UI AdMob tidak ada/tidak valid.
101	Gagal menginisialisasi InMobi SDK.
102	Ukuran iklan yang diminta tidak sesuai dengan ukuran banner yang didukung InMobi.
103	Permintaan iklan bukan permintaan iklan native terpadu.
104	Mencoba meminta iklan InMobi tanpa melakukan inisialisasi InMobi SDK. Hal ini seharusnya tidak pernah terjadi karena adapter melakukan inisialisasi InMobi SDK sebelum meminta iklan InMobi.
105	Iklan InMobi belum siap ditampilkan.
106	InMobi gagal menampilkan iklan.
107	InMobi menampilkan iklan native yang tidak memiliki aset wajib.
108	Aset gambar iklan native InMobi berisi URL yang salah format.
109	Adaptor gagal mendownload aset gambar iklan native InMobi.