Mengintegrasikan Mintegral dengan mediasi

Pilih platform: Android iOS Unity Flutter Android (Lama)

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

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk Mintegral memiliki kemampuan berikut:

Integrasi
Bidding  1
Air Terjun
Format
Membuka Aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native
1 Integrasi bidding dalam versi beta terbuka.

Prasyarat

Sebelum melanjutkan, verifikasi hal berikut:

  • Versi Google Mobile Ads Unity Plugin terbaru.
  • Unity Editor versi 5.6 atau yang lebih baru.
  • [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 baru (versi terbaru direkomendasikan).
  • Untuk men-deploy di Android
    • Android API level 24 atau yang lebih baru.
  • Untuk men-deploy di iOS
    • Target deployment iOS 13.0 atau yang lebih baru.
  • Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Unity Plugin. Lihat Menyiapkan Google Mobile Ads Unity Plugin untuk mengetahui detailnya.
  • Siapkan mediasi.

    • Langkah 1: Siapkan konfigurasi di UI Mintegral

    Daftar atau Login ke akun Mintegral Anda.

    Temukan 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 Placements & Units dan klik tombol Add Placement seperti yang ditunjukkan di bawah untuk membuat penempatan iklan.

    Android

    iOS

    Masukkan Placement Name dan format iklan.

    Pilih Bidding Header sebagai Jenis Bidding. Isi bagian formulir lainnya, lalu 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 Anda

    Bidding

    Langkah ini tidak diperlukan untuk integrasi bidding.

    Air Terjun

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

    Memperbarui app-ads.txt

    Authorized Sellers for Apps app-ads.txt adalah inisiatif IAB Tech Lab yang membantu memastikan inventaris iklan aplikasi Anda hanya dijual melalui saluran yang telah Anda identifikasi sebagai resmi. Untuk mencegah kerugian pendapatan iklan yang signifikan, Anda harus menerapkan file app-ads.txt. Jika Anda belum melakukannya, buat file app-ads.txt untuk Ad Manager.

    Untuk menerapkan app-ads.txt untuk Mintegral, lihat Cara app-Ads.txt Dapat Membantu Melawan Penipuan Iklan.

    Langkah 2: Siapkan permintaan Mintegral di UI Ad Manager

    Mengonfigurasi setelan mediasi untuk unit iklan Anda

    Android

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

    iOS

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

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

    Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan Mobvista/Mintegral ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI Ad Manager.

    Langkah 3: Impor SDK dan adaptor Mintegral

    OpenUPM-CLI

    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

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

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

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

    Detail OpenUPM

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

    Registri Unity

    Pilih paket Google Mobile Ads Mintegral Mediation, lalu klik Install.

    Menginstal dari OpenUPM

    Paket Unity

    Download plugin mediasi Google Mobile Ads versi terbaru untuk Mintegral dari link download di Changelog 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 Impor.

    Mengimpor dari Unity

    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.

    Paksa Selesaikan

    Langkah 4: Terapkan setelan privasi di Mintegral SDK

    Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka untuk penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, dan untuk pengumpulan, pembagian, serta penggunaan data pribadi untuk personalisasi iklan. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Anda bertanggung jawab untuk memverifikasi bahwa izin disebarkan ke setiap sumber iklan dalam rantai mediasi Anda.

    Adaptor Unity Mintegral versi 2.2.3 dan yang lebih baru mendukung penerusan sinyal izin GDPR dari platform pengelolaan izin yang terintegrasi dengan Transparency and Consent Framework (TCF) IAB ke SDK Mintegral. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pernyataan Kepatuhan Privasi SDK Android dan iOS Mintegral.

    Langkah 5: 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 6: Uji penerapan Anda

    Mengaktifkan iklan pengujian

    Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.

    Untuk 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 disediakan di halaman ID Pengujian Mintegral.

    Memverifikasi iklan percobaan

    Untuk memverifikasi bahwa Anda menerima iklan percobaan 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, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di 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
    100 com.mbridge.msdk Mintegral SDK menampilkan callback kegagalan.
    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 sesuai 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 SDK Mintegral menampilkan error tidak ada pengisian.
    105 com.mbridge.msdk Mintegral SDK gagal diinisialisasi.
    106 com.google.ads.mediation.mintegral Iklan untuk slot Mintegral sudah dimuat dan belum ditampilkan.

    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 SDK Mintegral 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 sesuai dengan ukuran banner yang didukung Mintegral.

    Log Perubahan Plugin Mediasi Unity Mintegral

    Versi 2.2.6

    Versi 2.2.5

    Versi 2.2.4

    Versi 2.2.3

    Versi 2.2.2

    Versi 2.2.1

    Versi 2.2.0

    Versi 2.1.0

    Versi 2.0.6

    Versi 2.0.5

    Versi 2.0.4

    Versi 2.0.3

    Versi 2.0.2

    Versi 2.0.1

    Versi 2.0.0

    Versi 1.9.8

    Versi 1.9.7

    Versi 1.9.6

    Versi 1.9.5

    Versi 1.9.4

    Versi 1.9.3

    Versi 1.9.2

    Versi 1.9.1

    Versi 1.9.0

    Versi 1.8.4

    Versi 1.8.3

    Versi 1.8.2

    Versi 1.8.1

    Versi 1.8.0

    Versi 1.7.0

    Versi 1.6.5

    Versi 1.6.4

    Versi 1.6.3

    Versi 1.6.2

    Versi 1.6.1

    Versi 1.6.0

    Versi 1.5.0

    Versi 1.4.0

    Versi 1.3.0

    Versi 1.2.1

    Versi 1.2.0

    Versi 1.1.0

    Versi 1.0.0