Mengintegrasikan Moloco dengan mediasi

Pilih platform: Android iOS Unity Flutter Android (Legacy)

Panduan ini menunjukkan cara menggunakan Google Mobile Ads Unity Plugin 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, dan cara mengintegrasikan Moloco Ads SDK dan adaptor ke aplikasi Unity.

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk Moloco Ads SDK memiliki kemampuan berikut:

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

Prasyarat

Sebelum Anda melanjutkan, verifikasi hal berikut:

  • Versi Google Mobile Ads Unity Plugin terbaru.
  • Unity Editor versi 5.6 atau yang lebih baru.
  • Plugin Moloco Unity 1.2.0 atau yang lebih baru.
  • 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.
  • Menyiapkan mediasi.

    • Langkah 1: Siapkan konfigurasi di UI Moloco Ads SDK

    Login ke Moloco Publisher Portal.

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

    Android

    iOS

    Setelah aplikasi Anda dibuat, pilih aplikasi tersebut dari tab Aplikasi untuk melihat detailnya dan catat Kunci Aplikasi.

    Android

    iOS

    Buka tab Ringkasan > 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. Kemudian, klik Buat.

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

    Langkah 2: Siapkan permintaan Moloco Ads SDK di UI Ad Manager

    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 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 Ad Manager.

    Langkah 3: Impor SDK dan adaptor Moloco Ads SDK

    OpenUPM-CLI

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

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

    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 Moloco Mediation, lalu klik Install.

    Menginstal dari OpenUPM

    Paket Unity

    Download plugin mediasi Google Mobile Ads versi terbaru untuk Moloco SDK iklan dari link download di Changelog dan ekstrak GoogleMobileAdsMolocoMediation.unitypackage dari file zip.

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

    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 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 Unity SDK iklan Moloco versi 1.0.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 iklan Moloco. Untuk mengetahui 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 pemberian hak kepada pengguna untuk menolak "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum ini), 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 Unity Plugin.

    using GoogleMobileAds.Api.Mediation.Moloco;
// ...

Moloco.SetDoNotSell(true);

    Lihat petunjuk penerapan yang direkomendasikan Moloco Ads SDK iklan 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 Ad Manager.

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

    Log Perubahan Plugin Mediasi Unity Moloco

    Versi 3.11.0 (Dalam proses)

    Versi 3.10.1

    Versi 3.10.0

    Versi 3.9.1

    Versi 3.9.0

    Versi 3.8.1

    Versi 3.8.0

    Versi 3.7.0

    Versi 3.6.1

    Versi 3.6.0

    Versi 3.5.1

    Versi 3.5.0

    Versi 3.4.1

    Versi 3.4.0

    Versi 3.3.1

    Versi 3.3.0

    Versi 3.2.0

    Versi 3.1.0

    Versi 3.0.0

    Versi 2.2.1

    Versi 2.2.0

    Versi 2.1.0

    Versi 2.0.0

    Versi 1.6.1

    Versi 1.6.0

    Versi 1.5.0

    Versi 1.4.0

    Versi 1.3.1

    Versi 1.3.0

    Versi 1.2.1

    Versi 1.2.0

    Versi 1.1.0

    Versi 1.0.0