Mengintegrasikan Moloco dengan Mediasi AdMob

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK for React Native untuk memuat dan menampilkan iklan dari Moloco Ads SDK menggunakan mediasi, yang mencakup integrasi bidding. Panduan ini membahas cara menambahkan Moloco Ads SDK ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan Moloco Ads SDK dan adaptor ke dalam aplikasi React Native.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Moloco Ads SDK memiliki kemampuan berikut:

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

Prasyarat

Sebelum melanjutkan, pastikan hal berikut:

Langkah 1: Siapkan konfigurasi di UI Moloco Ads SDK

Login ke Portal Penayang Moloco.

Buka tab Overview > Apps, lalu klik tombol Add App untuk membuat aplikasi baru.

Pilih OS dan Setelan Privasi untuk aplikasi Anda, isi bagian formulir lainnya, lalu klik Create.

Android

iOS

Setelah aplikasi dibuat, pilih aplikasi dari tab Apps untuk melihat detailnya dan catat App Key.

Android

iOS

Buka tab Overview > Unit Iklan, pilih aplikasi dari menu drop-down, lalu klik Unit Iklan Baru.

Pilih Bidding dalam aplikasi sebagai Metode lelang, lalu isi bagian formulir lainnya. Setelah itu, klik Create.

Buka unit iklan yang baru dibuat di tab Ad Units untuk melihat detailnya. Catat ID Unit Iklan.

Langkah 2: Siapkan permintaan Moloco Ads SDK 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 Moloco Ads 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 Moloco Ads ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI AdMob.

Langkah 3: Impor SDK dan adaptor Moloco Ads SDK

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

  1. Salin file tar adaptor Google Mobile Ads SDK for React Native dari direktori gma-sdk-react-native/adapters/moloco/ 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/moloco/gma-mediation-moloco-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-moloco-0.1.0.tgz

    benang

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

Langkah 4: Terapkan setelan privasi di Moloco 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 Moloco Ads SDK 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 Moloco Ads SDK. Untuk informasi selengkapnya, lihat dokumentasi MolocoPrivacy untuk Android dan String Izin TCF untuk iOS.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada pengguna guna menolak "penjualan" "informasi pribadi" mereka (sebagaimana kedua istilah tersebut didefinisikan dalam hukum), dengan pilihan tidak ikut yang disediakan 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 Anda yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Plugin mediasi Unity Google Mobile Ads untuk Moloco Ads SDK menyertakan metode Moloco.SetDoNotSell(bool) untuk meneruskan informasi izin ke Moloco Ads SDK. Kode contoh berikut menunjukkan cara meneruskan informasi izin ini ke SDK iklan Moloco Ads. Jika Anda memilih untuk menetapkan flag ini, sebaiknya lakukan sebelum meminta iklan melalui Google Mobile Ads SDK for React Native.

import { MolocoMediation } from '@google/gma-mediation-moloco';
// ...

MolocoMediation.setDoNotSell(true);

Lihat petunjuk penerapan yang direkomendasikan Moloco Ads SDK untuk Android dan iOS guna mengetahui detail selengkapnya.

Langkah 5: Tambahkan kode yang diperlukan

Tidak diperlukan kode tambahan untuk integrasi Moloco Ads SDK.

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.

Memverifikasi iklan pengujian

Untuk memastikan bahwa Anda menerima iklan pengujian dari Moloco Ads SDK, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Moloco (Bidding).

Kode error

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

Android

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

iOS

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Android

Kode error Domain Alasan
101 com.google.ads.mediation.moloco Kunci Aplikasi Moloco tidak ada atau tidak valid.
102 com.google.ads.mediation.moloco ID Unit iklan Moloco tidak ada atau tidak valid.
103 com.google.ads.mediation.moloco Objek iklan Moloco yang ditampilkan bernilai null.
104 com.google.ads.mediation.moloco Moloco SDK gagal diinisialisasi.
-1 hingga 5000 com.moloco.sdk Moloco SDK menampilkan error. Lihat dokumentasi Moloco untuk mengetahui detail selengkapnya.

iOS

Kode error Domain Alasan
101 com.google.ads.mediation.moloco Moloco SDK tidak mendukung penayangan iklan di iOS 12 dan yang lebih lama.
102 com.google.ads.mediation.moloco Kunci Aplikasi Moloco tidak ada atau tidak valid.
103 com.google.ads.mediation.moloco ID Unit iklan Moloco tidak ada atau tidak valid.
104 com.google.ads.mediation.moloco Iklan belum siap ditampilkan.
105 com.google.ads.mediation.moloco Iklan gagal ditampilkan.
106 com.google.ads.mediation.moloco Data rendering tidak tersedia untuk merender iklan.
-1 hingga 5000 Dikirim oleh Moloco SDK Moloco SDK menampilkan error. Lihat dokumentasi Moloco untuk mengetahui detail selengkapnya.

Versi 0.1.0

  • Rilis awal.