Mengintegrasikan Mintegral dengan bidding (Beta)

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan tampilkan iklan dari Mintegral menggunakan mediasi, yang mencakup integrasi waterfall dan bidding. Materi ini mencakup cara menambahkan Mintegral ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan Mintegral SDK dan adaptor ke dalam Android aplikasi.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Mintegral memiliki kemampuan berikut:

Integrasi
Bidding  1
Air Terjun  2
Format
Membuka Aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native
1 Integrasi bidding sudah dimulai beta tertutup (kecuali untuk format iklan native dalam beta terbuka).

2 Integrasi waterfall sudah beta tertutup.

Persyaratan

  • Android API level 21 atau yang lebih tinggi

Langkah 1: Siapkan 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 peraturan negara bagian Amerika Serikat dan GDPR

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 Mintegral SDK dan adaptor

Di file settings.gradle.kts level project, tambahkan kode berikut repositori:

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 hal berikut konfigurasi, dan dependensi implementasi. Gunakan versi terbaru SDK Mintegral dan adaptor:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:mintegral:16.8.11.0")
}

Integrasi manual

  1. Untuk menyertakan Mintegral SDK, buka Mintegral SDK for Android.

  2. Buka Artefak adaptor mintegral di Repositori Maven Google. Pilih versi terbaru, download Mintegral file .aar adaptor, lalu menambahkannya ke project Anda.

Langkah 4: Terapkan setelan privasi di Mintegral SDK

Berdasarkan Izin Pengguna Uni Eropa Google Google Ads, Anda harus memastikan bahwa pengungkapan tertentu 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 Uni Eropa Peraturan (GDPR). Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi, dan menyediakan informasi tentang penggunaan setiap jaringan. Google saat ini tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Mintegral SDK menyertakan metode setConsentStatus untuk meneruskan izin ke Mintegral SDK.

Kode contoh berikut menunjukkan cara meneruskan informasi izin ke Mintegral SDK. Opsi ini harus ditetapkan sebelum Anda melakukan inisialisasi Google Mobile Ads SDK untuk memastikannya diteruskan 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 informasi selengkapnya.

Hukum privasi negara bagian Amerika Serikat

Amerika Serikat hukum privasi negara bagian harus memberikan izin yang tepat kepada pengguna untuk memilih tidak ikut dalam "penjualan" "informasi pribadi" mereka (sebagaimana ditentukan oleh hukum persyaratan tersebut), dengan pilihan tidak ikut yang ditawarkan melalui iklan "Jangan Jual Pribadi Saya" Informasi" tautan di bagian "penjualan" beranda pihak ketiga. Tujuan Amerika Serikat privasi status panduan kepatuhan hukum menawarkan kemampuan untuk pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat berpartisipasi dalam penjualan aset dan mengikuti panduan dari masing-masing jaringan tersebut untuk memastikan kepatuhan.

Mintegral SDK menyertakan metode setDoNotTrackStatus untuk meneruskan izin ke Mintegral SDK.

Kode contoh berikut menunjukkan cara meneruskan informasi izin ke Mintegral SDK. Jika perlu memanggil metode ini, panggil 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 informasi selengkapnya.

Langkah 5: Tambahkan kode yang diperlukan

Tidak ada kode tambahan yang diperlukan untuk integrasi Mintegral.

Langkah 6: Uji penerapan

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 opsional

Tambahkan 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 sebagai NativeAd objek terstruktur dalam jumlah besar. Kolom ini mengisi hal-hal berikut kolom untuk NativeAd.

Kolom Aset selalu disertakan oleh adaptor Mintegral
Judul
Gambar 1
Isi
Ikon
Pesan ajakan (CTA)
Rating bintang
Toko
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 mendasar dari respons iklan dengan menggunakan ResponseInfo.getAdapterResponses() dalam class 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 spanduk 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.

Log Perubahan Adaptor Mediasi Android Mintegral

Versi 16.8.11.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.8.11.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.2.0.
  • Mintegral SDK versi 16.8.11.

Versi 16.7.91.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.7.91.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.2.0.
  • Mintegral SDK versi 16.7.91.

Versi 16.7.81.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.7.81.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.2.0.
  • Mintegral SDK versi 16.7.81.

Versi 16.7.71.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.7.71.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.1.0.
  • Mintegral SDK versi 16.7.71.

Versi 16.7.61.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.7.61.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.1.0.
  • Mintegral SDK versi 16.7.61.

Versi 16.7.51.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.7.51.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.1.0.
  • Mintegral SDK versi 16.7.51.

Versi 16.7.41.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.7.41.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.1.0.
  • Mintegral SDK versi 16.7.41.

Versi 16.7.31.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.7.31.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.1.0.
  • Mintegral SDK versi 16.7.31.

Versi 16.7.21.0

  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.7.21.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.0.0.
  • Mintegral SDK versi 16.7.21.

Versi 16.7.11.0

  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.7.11.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.0.0.
  • Mintegral SDK versi 16.7.11.

Versi 16.6.71.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.6.71.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.0.0.
  • Mintegral SDK versi 16.6.71.

Versi 16.6.61.0

  • Mengupdate versi Google Mobile Ads SDK minimum yang diperlukan ke 23.0.0.
  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.6.61.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 23.0.0.
  • Mintegral SDK versi 16.6.61.

Versi 16.6.51.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.6.51.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.6.0.
  • Mintegral SDK versi 16.6.51.

Versi 16.6.41.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.6.41.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.6.0.
  • Mintegral SDK versi 16.6.41.

Versi 16.6.34.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.6.34.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.6.0.
  • Mintegral SDK versi 16.6.34.

Versi 16.6.21.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.6.21.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.6.0.
  • Mintegral SDK versi 16.6.21.

Versi 16.5.91.1

  • Menambahkan dukungan bidding untuk format iklan di layar pembuka aplikasi.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.6.0.
  • Mintegral SDK versi 16.5.91.

Versi 16.5.91.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.5.91.
  • Mengupdate versi Google Mobile Ads SDK minimum yang diperlukan ke 22.6.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.6.0.
  • Mintegral SDK versi 16.5.91.

Versi 16.5.51.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.5.51.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.3.0.
  • Mintegral SDK versi 16.5.51.

Versi 16.5.41.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.5.41.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.3.0.
  • Mintegral SDK versi 16.5.41.

Versi 16.5.31.0

  • Kompatibilitas yang diverifikasi 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.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.3.0.
  • Mintegral SDK versi 16.5.31.

Versi 16.5.21.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.5.21.
  • Versi minimum Google Mobile Ads SDK yang diperlukan telah diupdate ke 22.4.0.

Dibangun 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 yang diverifikasi dengan Mintegral SDK 16.5.11.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.2.0.
  • Mintegral SDK versi 16.5.11.

Versi 16.4.91.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.4.91.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.2.0.
  • Mintegral SDK versi 16.4.91.

Versi 16.4.81.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.4.81.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.2.0.
  • Mintegral SDK versi 16.4.81.

Versi 16.4.71.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.4.71.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.2.0.
  • Mintegral SDK versi 16.4.71.

Versi 16.4.61.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.4.61.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.1.0.
  • Mintegral SDK versi 16.4.61.

Versi 16.4.51.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.4.51.

Dibangun 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 yang diverifikasi dengan Mintegral SDK 16.4.41.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.0.0.
  • Mintegral SDK versi 16.4.41.

Versi 16.4.31.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.4.31.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.0.0.
  • Mintegral SDK versi 16.4.31.

Versi 16.4.21.0

  • Memperbarui adaptor untuk menggunakan class VersionInfo baru.
  • Versi minimum Google Mobile Ads SDK yang diperlukan telah diupdate ke 22.0.0.
  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.4.21.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 22.0.0.
  • Mintegral SDK versi 16.4.21.

Versi 16.3.91.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.3.91.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.5.0.
  • Mintegral SDK versi 16.3.91.

Versi 16.3.81.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.3.81.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.5.0.
  • Mintegral SDK versi 16.3.81.

Versi 16.3.71.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.3.71.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.5.0.
  • Mintegral SDK versi 16.3.71.

Versi 16.3.61.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.3.61.

Dibangun 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.
  • Mengupdate versi Google Mobile Ads SDK minimum yang diperlukan ke 21.5.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.5.0.
  • Mintegral SDK versi 16.3.51.

Versi 16.3.51.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.3.51.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.4.0.
  • Mintegral SDK versi 16.3.51.

Versi 16.3.41.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.3.41.
  • Versi minimum Google Mobile Ads SDK yang diperlukan telah diupdate ke 21.4.0.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.4.0.
  • Mintegral SDK versi 16.3.41.

Versi 16.3.11.0

  • Kompatibilitas yang telah diverifikasi dengan Mintegral SDK 16.3.11.
  • Memperbarui adaptor untuk meneruskan onUserEarnedReward() sebelum onAdClosed() saat menampilkan iklan reward.

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

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 21.3.0.
  • Mintegral SDK versi 16.2.61.