Mengintegrasikan Mintegral dengan mediasi

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 aplikasi Unity .

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Mintegral memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Membuka Aplikasi	^1
Banner
Interstisial
Reward
Interstisial Reward

¹ Integrasi bidding dan waterfall untuk format iklan di layar pembuka aplikasi masih dalam versi beta tertutup.

Persyaratan

• Google Mobile Ads SDK terbaru
  • Unity 5.6 atau yang lebih tinggi
  • [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan plugin mediasi Google Mobile Ads untuk Mintegral 1.4.0 atau yang lebih tinggi (versi terbaru direkomendasikan)
  • Untuk men-deploy di Android
    • Android API level 21 atau yang lebih tinggi
  • Untuk men-deploy di iOS
    • Target deployment iOS 12.0 atau yang lebih tinggi
  • Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
  • 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.

Android

iOS

Catat APP ID aplikasi Anda.

Android

iOS

Membuat penempatan iklan

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

Android

iOS

Masukkan Nama Penempatan dan Format Iklan.

Penting: Untuk format iklan native, pilih Native (Custom Rendering) sebagai 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.

Android

iOS

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

Android

iOS

Menemukan Kunci API Pelaporan Mintegral

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Air Terjun

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

Langkah 2: Siapkan permintaan Mintegral di AdMob UI

Mengonfigurasi setelan mediasi untuk unit iklan

Android

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.

iOS

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.

Menambahkan Mintegral ke daftar partner iklan GDPR dan peraturan negara bagian AS

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

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

Catatan: Kegagalan untuk mengintegrasikan versi Mintegral dan Google Mobile Ads SDK yang kompatibel dapat menyebabkan masalah build.

OpenUPM-CLI

Penting: Jika bermigrasi dari penggunaan .unitypackage ke penggunaan OpenUPM-CLI, Anda harus meng-uninstal aset secara manual dari lokasi lama dengan menghapus semua file dari folder Assets/GoogleMobileAds/Mediation/Mintegral.

Jika telah menginstal OpenUPM-CLI, Anda dapat menginstal Plugin Mediasi Mintegral Google Mobile Ads untuk Unity ke project dengan menjalankan perintah berikut dari direktori root project:

openupm add com.google.ads.mobile.mediation.mintegral

OpenUPM

Penting: Jika bermigrasi dari penggunaan .unitypackage ke penggunaan OpenUPM, Anda harus meng-uninstal aset secara manual dari lokasi lama dengan menghapus semua file dari folder Assets/GoogleMobileAds/Mediation/Mintegral.

Di editor project Unity, pilih Edit > Project Settings > Package Manager untuk membuka Unity Package Manager Settings.

Di tab Scoped Registries, tambahkan OpenUPM sebagai registry terbatas dengan detail berikut:

• Nama: OpenUPM
• URL: https://package.openupm.com
• Cakupan: com.google

Kemudian, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.

Pilih paket Google Mobile Ads Mintegral Mediation lalu klik Install.

Paket Unity

Download plugin mediasi Google Mobile Ads versi terbaru untuk Mintegral dari link download di Log Perubahan dan ekstrak GoogleMobileAdsMintegralMediation.unitypackage dari file zip.

Di editor project Unity, pilih Assets > Import Package > Custom Package, lalu temukan file GoogleMobileAdsMintegralMediation.unitypackage yang telah Anda download. Pastikan semua file telah dipilih, lalu klik Import.

Kemudian, pilih Assets > External Dependency Manager > Android Resolver > Force Resolve. Library External Dependency Manager akan melakukan resolusi dependensi dari awal dan menyalin dependensi yang dideklarasikan ke direktori Assets/Plugins/Android aplikasi Unity Anda.

Langkah 4: Tambahkan kode yang diperlukan

Android

Tidak diperlukan kode tambahan untuk integrasi Mintegral.

iOS

Integrasi SKAdNetwork

Ikuti dokumentasi Mintegral untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.

Langkah 5: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.

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.

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

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

Kode error

Jika adaptor gagal menerima iklan dari Mintegral, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bawah class berikut:

Android

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

iOS

GADMediationAdapterMintegral

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

Android

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.

iOS

Kode error	Domain	Alasan
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 tanpa 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 Plugin Mediasi Unity Mintegral

Versi 1.8.3

• Mendukung adaptor Android Mintegral versi 16.8.61.0.
• Mendukung Adaptor iOS Mintegral versi 7.7.3.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.3.0.

Versi 1.8.2

• Mendukung adaptor Android Mintegral versi 16.8.61.0.
• Mendukung Adaptor iOS Mintegral versi 7.7.2.1.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.1.

Versi 1.8.1

• Mendukung Adaptor Android Mintegral versi 16.8.51.0.
• Mendukung Adaptor iOS Mintegral versi 7.7.2.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.

Versi 1.8.0

• Mendukung Adaptor Android Mintegral versi 16.8.31.0.
• Mendukung Adaptor iOS Mintegral versi 7.7.0.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.

Versi 1.7.0

• Mengganti nama DummyClient menjadi PlaceholderClient.
• Mendukung Adaptor Android Mintegral versi 16.8.11.0.
• Mendukung adaptor iOS Mintegral versi 7.6.9.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.

Versi 1.6.5

• Mendukung Adaptor Android Mintegral versi 16.7.81.0.
• Mendukung Adaptor iOS Mintegral versi 7.6.8.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.

Versi 1.6.4

• Mendukung adaptor Android Mintegral versi 16.7.61.0.
• Mendukung Adaptor iOS Mintegral versi 7.6.7.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.

Versi 1.6.3

• Mendukung adaptor Android Mintegral versi 16.7.41.0.
• Mendukung adaptor iOS Mintegral versi 7.6.6.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.

Versi 1.6.2

• Mendukung adaptor Android Mintegral versi 16.7.41.0.
• Mendukung adaptor iOS Mintegral versi 7.6.4.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.

Versi 1.6.1

• Mendukung Adaptor Android Mintegral versi 16.7.21.0.
• Mendukung adaptor iOS Mintegral versi 7.6.3.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.

Versi 1.6.0

• Mendukung Adaptor Android Mintegral versi 16.7.11.0.
• Mendukung Adaptor iOS Mintegral versi 7.6.2.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.0.0.

Versi 1.5.0

• Mendukung Adaptor Android Mintegral versi 16.6.71.0.
• Mendukung Adaptor iOS Mintegral versi 7.6.0.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.0.0.

Versi 1.4.0

• Mendukung Adaptor Android Mintegral versi 16.6.34.0.
• Mendukung Adaptor iOS Mintegral versi 7.5.6.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.7.0.

Versi 1.3.0

• Mendukung Adaptor Android Mintegral versi 16.5.91.0.
• Mendukung Adaptor iOS Mintegral versi 7.5.3.0.
• Menambahkan metode berikut ke class Mintegral:
  • SetConsentStatus(bool)
  • SetDoNotTrackStatus(bool)
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.

Versi 1.2.1

• Mendukung adaptor Android Mintegral versi 16.4.61.0.
• Mendukung Adaptor iOS Mintegral versi 7.3.8.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.3.0.

Versi 1.2.0

• Memindahkan konten adaptor ke GoogleMobileAds/Mediation/Mintegral/.
• Mendukung adaptor Android Mintegral versi 16.4.41.0.
• Mendukung Adaptor iOS Mintegral versi 7.3.6.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.3.0.

Versi 1.1.0

• Mendukung adaptor Android Mintegral versi 16.3.61.0.
• Mendukung Adaptor iOS Mintegral versi 7.2.9.1.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.1.

Versi 1.0.0

• Rilis Awal!
• Mendukung adaptor Android Mintegral versi 16.2.61.0.
• Mendukung Adaptor iOS Mintegral versi 7.2.6.0.
• Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.3.1.