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 waterfall dan bidding. Panduan ini membahas cara menambahkan Mintegral ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor Mintegral ke aplikasi Android.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Mintegral memiliki kemampuan berikut:

² Integrasi waterfall masih dalam versi beta tertutup.

Persyaratan

• Android API level 21 atau yang lebih tinggi

• [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan adaptor Mintegral 16.5.91.1 atau yang lebih baru (versi terbaru direkomendasikan)

• Google Mobile Ads SDK Terbaru

• Selesaikan Panduan memulai mediasi

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 dibuat, buka tab Penempatan & Unit dan klik tombol Tambahkan Penempatan seperti yang ditunjukkan di bawah untuk membuat penempatan iklan.

Masukkan Nama Penempatan dan Format Iklan.

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

Setelah penempatan iklan dibuat, catat ID Penempatan.

Klik drop-down 1 Unit Iklan dan catat ID Unit Iklan.

Menemukan Kunci API Pelaporan Mintegral

Langkah 2: Siapkan permintaan Mintegral di UI Ad Manager

Login ke akun Ad Manager Anda.

Menambahkan Mintegral di Perusahaan

Mengaktifkan berbagi sinyal aman

Mengonfigurasi bidding Mintegral

Mengonfigurasi pemetaan unit iklan

Menambahkan Mobvista/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 Ad Manager.

Langkah 3: Impor SDK dan adaptor Mintegral

Integrasi Android Studio (direkomendasikan)

Dalam 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 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.6.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

Izin Uni Eropa dan GDPR

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. Saat ini, Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

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

Contoh kode berikut menunjukkan cara meneruskan informasi izin ke SDK Mintegral. Opsi ini harus ditetapkan sebelum Anda menginisialisasi Google Mobile Ads SDK untuk memastikannya diteruskan dengan benar ke Mintegral SDK.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

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 dalam "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan dalam hukum), dengan pilihan tidak ikut yang ditawarkan 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 rantai mediasi 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.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

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 Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.

Untuk mendapatkan iklan pengujian 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 UI Ad Manager.

Iklan native

Rendering iklan

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

¹ 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:

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

Dibuat dan diuji dengan:

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

Versi 16.7.91.0

• Kompatibilitas terverifikasi dengan Mintegral SDK 16.7.91.

Dibuat 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 terverifikasi 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 terverifikasi 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 terverifikasi 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 terverifikasi dengan Mintegral SDK 16.7.11.

Dibuat dan diuji dengan:

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

Versi 16.6.71.0

• Kompatibilitas terverifikasi 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 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

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

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

• Memverifikasi kompatibilitas 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

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

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

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