Mengintegrasikan Mintegral dengan Mediasi AdMob

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK for React Native 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 dalam aplikasi React Native.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Mintegral memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Membuka Aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native

Prasyarat

Sebelum melanjutkan, pastikan hal berikut:

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 ID APLIKASI 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.

Bidding

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

Air Terjun

Pilih Waterfall 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 AdMob. Buka Akun > Alat API. 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, siapkan file app-ads.txt untuk aplikasi Anda.

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

Langkah 2: Siapkan permintaan Mintegral di UI AdMob

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

Langkah 3: Impor SDK dan adaptor Mintegral

Di direktori root project Anda, instal adaptor mediasi Google Mobile Ads SDK for React Native untuk Mintegral. Selesaikan langkah-langkah berikut:

  1. Salin file tar adaptor Google Mobile Ads SDK for React Native dari direktori gma-sdk-react-native/adapters/mintegral/ ke direktori local_packages/ project Anda. Jika Anda tidak memiliki folder adapters, lihat Prasyarat.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/mintegral/gma-mediation-mintegral-0.1.0.tgz local_packages/

    Ganti EXTRACT_DIR dengan jalur ke direktori tempat Anda mengekstrak arsip.

  2. Instal paket adaptor menggunakan pengelola paket pilihan Anda:

    npm

    npm install ./local_packages/gma-mediation-mintegral-0.1.0.tgz

    benang

    yarn add ./local_packages/gma-mediation-mintegral-0.1.0.tgz

  3. Jika Anda mem-build untuk Android, tambahkan repositori berikut ke file build.gradle di direktori android project Anda:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
}

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 React Native Mintegral versi 0.1.0 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 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.

Memverifikasi iklan pengujian

Untuk memastikan 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, 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 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 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 Mintegral SDK menampilkan error tidak ada pengisian.
103 com.google.mediation.mintegral SDK Mintegral gagal menampilkan iklan.
104 com.google.mediation.mintegral Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Mintegral.

Versi 0.1.0

  • Rilis awal.