Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Mintegral menggunakan mediasi, yang mencakup integrasi waterfall dan bidding. Panduan ini membahas cara menambahkan Mintegral ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan SDK dan adaptor Mintegral ke dalam aplikasi Android .
Integrasi dan format iklan yang didukung
Adaptor mediasi Ad Manager untuk Mintegral memiliki kemampuan berikut:
Integrasi | ||
---|---|---|
Bidding | 1 | |
Waterfall | 2 | |
Format | ||
Membuka Aplikasi | 1 2 | |
Banner | ||
Interstisial | ||
Diberikan sebagai reward | ||
Interstisial Reward | ||
Native | 1 3 |
2 Integrasi waterfall masih dalam versi beta tertutup.
Persyaratan
- Android API level 21 atau yang lebih tinggi
Google Mobile Ads SDK terbaru
Selesaikan mediasi Panduan memulai
Langkah 1: Menyiapkan konfigurasi di UI Mintegral
Daftar atau Login ke akun Mintegral Anda.
Menemukan Kunci Aplikasi
Buka tab Setelan APLIKASI dan catat Kunci APLIKASI.
Tambahkan aplikasi baru
Dari tab Setelan APLIKASI, klik tombol Tambahkan APLIKASI.
Pilih Platform dan isi formulir lainnya. Lalu, klik Simpan.
Catat ID APLIKASI untuk aplikasi Anda.
Membuat penempatan iklan
Setelah aplikasi dibuat, buka tab Penempatan & Unit, lalu klik tombol Tambahkan Penempatan seperti yang ditunjukkan di bawah untuk membuat penempatan iklan Anda.
Masukkan Nama Penempatan dan Format Iklan.
Pilih Bidding Header sebagai Jenis Bidding. Isi semua bagian formulir, lalu klik Simpan.
Setelah penempatan iklan dibuat, catat ID Penempatan.
Klik drop-down 1 Unit IKLAN dan catat ID Unit IKLAN.
Menemukan Kunci Mintegral Reporting API
Bidding
Langkah ini tidak diperlukan untuk integrasi bidding.
Waterfall
Anda memerlukan Kunci Mintegral Reporting API untuk menyiapkan Ad Manager ID unit iklan. Buka Account > API Tools. Catat Skey dan Secret Anda.
Langkah 2: Siapkan permintaan Mintegral di Ad Manager UI
Login ke akun Ad Manager.
Tambahkan Mintegral di Perusahaan
Bidding
Langkah ini tidak diperlukan untuk integrasi bidding.
Waterfall
Buka Admin > Perusahaan, lalu klik tombol Perusahaan baru di tab Semua perusahaan. Pilih Jaringan iklan.
Pilih Mintegral sebagai Jaringan iklan, masukkan Nama unik dan aktifkan Mediasi.
Anda tidak perlu memasukkan Username atau Password. Klik Simpan setelah selesai.
Aktifkan berbagi sinyal aman
Bidding
Buka Admin > Setelan global. Buka tab Setelan akun Ad Exchange, lalu tinjau dan aktifkan Berbagi sinyal aman. Klik Save.
Waterfall
Langkah ini tidak diperlukan untuk integrasi waterfall.
Konfigurasi Mintegral bidding
Bidding
Buka Penayangan > Bidder, lalu klik Bidder baru di bagian tab Bidding dengan SDK.
Pilih Mintegral sebagai bidder.
Aktifkan opsi Tambahkan library sinyal bidder ini ke daftar sinyal yang diizinkan dan Izinkan sinyal untuk dibagikan dengan bidder ini. Kemudian, klik Lanjutkan.
Klik Lanjutkan.
Klik Done.
Waterfall
Langkah ini tidak diperlukan untuk integrasi waterfall.
Mengonfigurasi pemetaan unit iklan
Bidding
Buka Penayangan > Bidder, lalu pilih perusahaan untuk Mintegral di tab Bidding dengan SDK.
Buka tab Pemetaan unit iklan dan klik Pemetaan unit iklan baru.
Pilih Unit iklan tertentu. Pilih unit dan format iklan, Aplikasi seluler sebagai Jenis inventaris, dan Aplikasi seluler Anda. Lalu, masukkan App Key, App ID, Placement ID, and Ad Unit ID yang diperoleh di bagian sebelumnya. Terakhir, klik Simpan.
Waterfall
Buka Penayangan > Grup hasil, lalu klik tombol Grup hasil baru. Pilih Aplikasi seluler.
Scroll ke bawah dan klik Tambahkan partner hasil.
Pilih perusahaan yang Anda buat untuk Mintegral di bagian sebelumnya. Pilih Mediasi Mobile SDK sebagai Jenis integrasi, Android sebagai Platform, dan Aktif sebagai Status.
Masukkan App Key, App ID, Placement ID, and Ad Unit ID yang diperoleh di bagian sebelumnya, dan nilai CPM Default. Klik Save.
Tambahkan Mintegral ke daftar partner iklan GDPR dan peraturan negara bagian AS
Ikuti langkah-langkah di Setelan GDPR dan Setelan peraturan negara bagian AS untuk menambahkan Mintegral ke daftar partner iklan peraturan negara bagian AS dan GDPR di UI Ad Manager .
Langkah 3: Impor SDK dan adaptor Mintegral
Integrasi Android Studio (direkomendasikan)
Di file settings.gradle.kts
level project, tambahkan repositori berikut:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Kemudian, di file build.gradle.kts
tingkat aplikasi, tambahkan
dependensi dan konfigurasi implementasi berikut. Gunakan versi terbaru
SDK dan adaptor Mintegral:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:mintegral:16.6.61.0")
}
Integrasi manual
Untuk menyertakan Mintegral SDK, buka Mintegral SDK for Android.
Buka Artefak adaptor Mintegral di Repositori Maven Google. Pilih versi terbaru, download file
.aar
adaptor Mintegral, lalu tambahkan ke project Anda.
Langkah 4: Terapkan setelan privasi di Mintegral SDK
Izin Uni Eropa dan GDPR
Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu telah diberikan kepada, dan izin yang diperoleh dari, pengguna di Wilayah Ekonomi Eropa (EEA) terkait penggunaan ID perangkat dan data pribadi. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini, Google tidak dapat secara otomatis meneruskan pilihan izin pengguna ke jaringan tersebut.
Mintegral SDK menyertakan metode setConsentStatus
untuk meneruskan informasi izin ke Mintegral SDK.
Kode contoh berikut menunjukkan cara meneruskan informasi izin ke Mintegral SDK. Opsi ini harus ditetapkan sebelum Anda menginisialisasi Google Mobile Ads SDK untuk memastikan penerusan tersebut dengan benar ke Mintegral SDK.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
Lihat dokumentasi privasi Mintegral untuk mengetahui informasi selengkapnya.
Hukum privasi negara bagian Amerika Serikat
Hukum privasi negara bagian Amerika Serikat mengharuskan pengguna untuk 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 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 rantai mediasi Anda yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhannya.
Mintegral SDK menyertakan metode setDoNotTrackStatus
untuk meneruskan informasi izin ke Mintegral SDK.
Kode contoh berikut menunjukkan cara meneruskan informasi izin ke Mintegral SDK. Jika Anda perlu memanggil metode ini, panggil metode ini setelah melakukan inisialisasi Google Mobile Ads SDK tetapi sebelum meminta iklan melalui Google Mobile Ads SDK.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
Lihat dokumentasi privasi Mintegral untuk mengetahui informasi selengkapnya.
Langkah 5: Tambahkan kode yang diperlukan
Tidak ada kode tambahan yang diperlukan untuk integrasi Mintegral.
Langkah 6: Uji penerapan Anda
Aktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian Anda untuk Ad Manager
Guna mendapatkan iklan percobaan Mintegral untuk format iklan banner, interstisial, reward, dan native, Mintegral merekomendasikan penggunaan Kunci Aplikasi, ID Aplikasi, ID Penempatan, dan ID Unit Iklan yang diberikan di halaman Mintegral Test ID.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Mintegral, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan Mintegral (Bidding) and Mintegral (Waterfall) sumber iklan.
Langkah-langkah opsional
Menambahkan Mintegral ke daftar partner iklan CCPA
Ikuti langkah-langkah di Setelan CCPA untuk menambahkan Mintegral ke daftar partner iklan CCPA di Ad Manager UI.
Iklan native
Rendering iklan
Adaptor Mintegral menampilkan iklan native-nya sebagai
objek
NativeAd
. Kolom ini mengisi
kolom
berikut untuk
NativeAd
.
Kolom | Aset selalu disertakan oleh adaptor Mintegral |
---|---|
Judul | |
Gambar | 1 |
Body | |
Ikon | |
Pesan ajakan (CTA) | |
Rating bintang | |
Simpan | |
Harga | |
Pengiklan |
1 Adaptor Mintegral tidak
memberikan akses langsung ke aset gambar utama untuk iklan native-nya. Sebagai gantinya, adaptor mengisi
MediaView
dengan video atau gambar.
Kode error
Jika adaptor gagal menerima iklan dari Mintegral, Anda dapat memeriksa
error yang mendasari dari respons iklan menggunakan
ResponseInfo.getAdapterResponse()
pada kelas berikut:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Mintegral saat iklan gagal dimuat:
Kode error | Domain | Alasan |
---|---|---|
101 | com.google.ads.mediation.mintegral | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada). |
102 | com.google.ads.mediation.mintegral | Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Mintegral. |
103 | com.google.ads.mediation.mintegral | Respons bid tidak ada atau tidak valid. |
104 | com.google.ads.mediation.mintegral | Mintegral SDK menampilkan error tidak ada pengisian. |
101 | com.google.mediation.mintegral | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada). |
102 | com.google.mediation.mintegral | Mintegral SDK menampilkan error tidak ada pengisian. |
103 | com.google.mediation.mintegral | Mintegral SDK gagal menampilkan iklan. |
104 | com.google.mediation.mintegral | Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Mintegral. |
Log Perubahan Adaptor Mediasi Android Mintegral
Versi 16.6.51.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.6.51.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- Mintegral SDK versi 16.6.51.
Versi 16.6.41.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.6.41.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- Mintegral SDK versi 16.6.41.
Versi 16.6.34.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.6.34.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- Mintegral SDK versi 16.6.34.
Versi 16.6.21.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.6.21.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- Mintegral SDK versi 16.6.21.
Versi 16.5.91.1
- Penambahan dukungan bidding untuk format iklan di layar pembuka aplikasi.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- Mintegral SDK versi 16.5.91.
Versi 16.5.91.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.5.91.
- Update versi minimum Google Mobile Ads SDK yang diperlukan ke 22.6.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- Mintegral SDK versi 16.5.91.
Versi 16.5.51.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.5.51.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.3.0.
- Mintegral SDK versi 16.5.51.
Versi 16.5.41.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.5.41.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.3.0.
- Mintegral SDK versi 16.5.41.
Versi 16.5.31.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.5.31.
- Mengembalikan adaptor agar bergantung pada Google Mobile Ads SDK versi 22.3.0.
- Menambahkan dukungan waterfall untuk format iklan di layar pembuka aplikasi.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.3.0.
- Mintegral SDK versi 16.5.31.
Versi 16.5.21.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.5.21.
- Update versi minimum Google Mobile Ads SDK yang diperlukan ke 22.4.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.4.0.
- Mintegral SDK versi 16.5.21.
Versi 16.5.11.0
- Menambahkan dukungan watermark untuk iklan bidding.
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.5.11.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.2.0.
- Mintegral SDK versi 16.5.11.
Versi 16.4.91.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.91.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.2.0.
- Mintegral SDK versi 16.4.91.
Versi 16.4.81.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.81.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.2.0.
- Mintegral SDK versi 16.4.81.
Versi 16.4.71.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.71.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.2.0.
- Mintegral SDK versi 16.4.71.
Versi 16.4.61.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.61.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.1.0.
- Mintegral SDK versi 16.4.61.
Versi 16.4.51.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.51.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.1.0.
- Mintegral SDK versi 16.4.51.
Versi 16.4.41.0
- Memperbaiki masalah saat iklan banner dirender dengan ukuran yang salah.
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.41.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.0.0.
- Mintegral SDK versi 16.4.41.
Versi 16.4.31.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.31.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.0.0.
- Mintegral SDK versi 16.4.31.
Versi 16.4.21.0
- Mengupdate adaptor untuk menggunakan class
VersionInfo
baru. - Update versi minimum Google Mobile Ads SDK yang diperlukan ke 22.0.0.
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.4.21.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.0.0.
- Mintegral SDK versi 16.4.21.
Versi 16.3.91.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.3.91.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.5.0.
- Mintegral SDK versi 16.3.91.
Versi 16.3.81.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.3.81.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.5.0.
- Mintegral SDK versi 16.3.81.
Versi 16.3.71.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.3.71.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.5.0.
- Mintegral SDK versi 16.3.71.
Versi 16.3.61.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.3.61.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.5.0.
- Mintegral SDK versi 16.3.61.
Versi 16.3.51.1
- Menambahkan dukungan waterfall untuk format iklan banner (termasuk MREC), interstisial, reward, dan native.
- Update versi minimum Google Mobile Ads SDK yang diperlukan ke 21.5.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.5.0.
- Mintegral SDK versi 16.3.51.
Versi 16.3.51.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.3.51.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.4.0.
- Mintegral SDK versi 16.3.51.
Versi 16.3.41.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.3.41.
- Update versi minimum Google Mobile Ads SDK yang diperlukan ke 21.4.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.4.0.
- Mintegral SDK versi 16.3.41.
Versi 16.3.11.0
- Kompatibilitas terverifikasi dengan Mintegral SDK 16.3.11.
- Memperbarui adaptor untuk meneruskan
onUserEarnedReward()
sebelumonAdClosed()
saat menampilkan iklan reward.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.3.0.
- Mintegral SDK versi 16.3.11.
Versi 16.2.61.0
- Rilis awal!
- Menambahkan dukungan bidding untuk format iklan banner (termasuk MREC), interstisial, reward, dan native.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 21.3.0.
- Mintegral SDK versi 16.2.61.