Mengintegrasikan Mintegral dengan bidding (Beta)

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

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 masih dalam versi beta tertutup (kecuali untuk format iklan native dalam versi beta terbuka).

2 Integrasi waterfall masih dalam versi 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 APP Setting dan catat APP Key.

Menambahkan aplikasi baru

Dari tab APP Setting, klik tombol Add APP.

Pilih Platform dan isi bagian formulir lainnya. Kemudian, klik Simpan.

Catat APP ID aplikasi Anda.

Membuat penempatan iklan

Setelah aplikasi Anda dibuat, buka tab Penempatan &Unit lalu klik tombol Tambahkan Penempatan seperti yang ditunjukkan di bawah untuk membuat penempatan iklan.

Masukkan Nama Penempatan dan Format Iklan.

Bidding

Pilih Bidding Header sebagai Bidding Type. Isi bagian formulir lainnya, lalu klik Simpan.

Air Terjun

Pilih Tradisional sebagai Jenis Bidding. Isi formulir lainnya dan 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.

Air Terjun

Anda memerlukan Kunci Mintegral Reporting API untuk menyiapkan ID unit iklan AdMob. Buka Account > API Tools. Catat Skey dan Secret Anda.

Langkah 2: Siapkan permintaan Mintegral di Ad Manager UI

Menambahkan 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 Mobvista/Mintegral ke daftar partner iklan GDPR dan peraturan negara bagian AS di UI AdMob.

Langkah 3: Impor Mintegral SDK dan adaptor

Di file settings.gradle.kts tingkat 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 level aplikasi, tambahkan dependensi dan konfigurasi implementasi berikut. Gunakan SDK dan adaptor Mintegral versi terbaru:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.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 file .aar adaptor Mintegral, lalu tambahkan ke project Anda.

Langkah 4: Terapkan setelan privasi di Mintegral SDK

Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu diberikan kepada, dan izin 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 yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Google saat ini tidak dapat 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 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 mengetahui informasi selengkapnya.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan 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 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 kepatuhan.

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

Contoh kode berikut menunjukkan cara meneruskan informasi izin ke SDK Mintegral. Jika Anda 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 mengetahui informasi selengkapnya.

Langkah 5: Tambahkan kode yang diperlukan

Tidak diperlukan kode tambahan untuk integrasi Mintegral.

Langkah 6: Uji penerapan

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.

Guna mendapatkan iklan uji Mintegral untuk format iklan banner, interstisial, reward, dan native, Mintegral merekomendasikan penggunaan Kunci Aplikasi, ID Aplikasi, ID Penempatan, dan ID Unit Iklan yang disediakan di halaman ID Pengujian Mintegral.

Memverifikasi iklan percobaan

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

Langkah opsional

Menambahkan Mintegral ke daftar partner iklan CCPA

Ikuti langkah-langkah di Setelan CCPA untuk menambahkan Mintegral ke daftar partner iklan CCPA di UIAd Manager .

Iklan native

Rendering iklan

Adaptor Mintegral menampilkan iklan native-nya sebagai objek NativeAd . Fungsi ini mengisi kolom berikut untuk NativeAd.

Kolom Aset yang selalu disertakan oleh adaptor Mintegral
Judul
Gambar 1
Isi
Ikon
Pesan ajakan (CTA)
Rating bintang
Toko
Harga
Pengiklan

1 Adaptor Mintegral tidak menyediakan 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 mendasarinya dari respons iklan menggunakan ResponseInfo.getAdapterResponses() di bawah 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 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 tanpa pengisian.

Log Perubahan Adaptor Mediasi Android Mintegral

Versi berikutnya

  • Lakukan inisialisasi Mintegral SDK di thread latar belakang (untuk memperbaiki ANR).

Versi 16.8.61.0

  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.8.61.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 23.3.0.
  • Mintegral SDK versi 16.8.61.

Versi 16.8.51.0

  • Kompatibilitas yang diverifikasi dengan Mintegral SDK 16.8.51.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 23.3.0.
  • Mintegral SDK versi 16.8.51.

Versi 16.8.41.0

  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.8.41.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 23.3.0.
  • Mintegral SDK versi 16.8.41.

Versi 16.8.31.0

  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.8.31.

Dibuat dan diuji dengan:

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

Versi 16.8.11.0

  • Kompatibilitas terverifikasi 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 terverifikasi dengan Mintegral SDK 16.7.81.

Dibuat dan diuji dengan:

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

Versi 16.7.71.0

  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.7.71.

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

Dibuat dan diuji dengan:

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

Versi 16.7.51.0

  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.7.51.

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

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

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

Dibuat dan diuji dengan:

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

Versi 16.7.11.0

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

Dibuat dan diuji dengan:

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

Versi 16.6.61.0

  • Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 23.0.0.
  • Kompatibilitas terverifikasi dengan Mintegral SDK 16.6.61.

Dibuat 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 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 yang diverifikasi 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

  • Menambahkan 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.
  • Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 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.

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.

Dibuat 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 pembukaan 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 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 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 yang diverifikasi 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 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.

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.

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.
  • Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 22.0.0.
  • Kompatibilitas terverifikasi 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 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.

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 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.
  • Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 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.

Dibangun 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.
  • Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 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() sebelum onAdClosed() 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.