Mengintegrasikan AppLovin dengan mediasi

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

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk AppLovin memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner  1
Interstisial
Reward

Iklan banner (kecuali MREC banner) hanya didukung dalam mediasi. Bidding tidak mendukung jenis apa pun tentang iklan banner.

Persyaratan

  • Google Mobile Ads SDK terbaru
  • Unity 5.6 atau yang lebih baru
  • [Untuk bidding]: Plugin mediasi Google Mobile Ads untuk AppLovin 4.2.0 atau 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 versi yang lebih tinggi
  • Project Unity berfungsi yang dikonfigurasi dengan Google SDK Iklan Seluler. Lihat Mulai untuk mengetahui detailnya.
  • Selesaikan mediasi Panduan memulai

Langkah 1: Siapkan konfigurasi di UI AppLovin

Langkah 2: Siapkan permintaan AppLovin 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 AppLovin Corp. ke daftar partner iklan peraturan negara bagian Amerika Serikat dan GDPR

Ikuti langkah-langkah di Setelan GDPR dan Setelan peraturan negara bagian AS untuk menambahkan AppLovin Corp. ke daftar partner iklan peraturan negara bagian AS dan GDPR di UI AdMob .

Langkah 3: Impor AppLovin SDK dan adaptor

OpenUPM-CLI

Jika Anda memiliki OpenUPM-CLI Anda dapat menginstal AppLovin Google Mobile Ads Plugin Mediasi untuk Unity ke project Anda dengan menjalankan perintah berikut dari direktori utama project Anda:

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

OpenUPM

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

Pada tab Scoped Registries, tambahkan OpenUPM sebagai scope registry dengan detail berikut:

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

Detail OpenUPM

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

Registry Unity

Pilih Mediasi AppLovin Google Mobile Ads untuk Unity, lalu klik Install.

Instal dari OpenUPM

Paket Unity

Download versi terbaru plugin mediasi Google Mobile Ads untuk AppLovin dari link download di Log perubahan dan ekstrak GoogleMobileAdsAppLovinMediation.unitypackage dari file ZIP.

Di editor project Unity, pilih Assets > Impor Paket > Custom Package dan temukan GoogleMobileAdsAppLovinMediation.unitypackage yang didownload. Pastikan semua file dipilih dan klik Impor.

Mengimpor dari Unity

Lalu, pilih Aset > Resolver Layanan Play > Resolver Android > Paksa Selesaikan. Resolver Layanan Unity Play library akan melakukan resolusi dependensi dari awal, lalu menyalin dependensi yang dideklarasikan ke dalam direktori Assets/Plugins/Android aplikasi Unity.

Paksa Selesaikan

Langkah 4: Terapkan setelan privasi di AppLovin SDK

Berdasarkan Izin Pengguna Uni Eropa Google Google Ads, Anda harus memastikan bahwa pengungkapan tertentu diberikan kepada, dan izin yang diperoleh dari, pengguna di Wilayah Ekonomi Eropa (EEA) terkait penggunaan ID perangkat dan data pribadi. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Uni Eropa Peraturan (GDPR). Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi, dan menyediakan informasi tentang penggunaan setiap jaringan. Google saat ini tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Karena plugin mediasi Google Mobile Ads versi 7.0.0, AppLovin mendukung pembacaan string izin dari setelan dan preferensi bersama mengetahui status izinnya.

Jika Anda tidak menggunakan plugin mediasi Google Mobile Ads untuk Applovin versi 7.0.0+ atau tidak menggunakan CMP yang menulis string izin ke dalam ID preferensi, Anda dapat menggunakan AppLovin.SetHasUserConsent() dan AppLovin.SetIsAgeRestrictedUser() metode. Kode contoh berikut menunjukkan cara untuk meneruskan informasi izin ke AppLovin SDK. Opsi ini harus ditetapkan sebelum melakukan inisialisasi Google Mobile Ads SDK untuk memastikan permintaan tersebut diteruskan dengan benar ke AppLovin SDK.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

Selain itu, jika pengguna diketahui termasuk dalam kategori yang dikenai pembatasan usia, Anda dapat tetapkan juga tanda di bawah ke true.

AppLovin.SetIsAgeRestrictedUser(true);

Lihat setelan privasi AppLovin untuk informasi selengkapnya.

Hukum privasi negara bagian Amerika Serikat

Amerika Serikat hukum privasi negara bagian harus memberikan izin yang tepat kepada pengguna untuk memilih tidak ikut dalam "penjualan" "informasi pribadi" mereka (sebagaimana ditentukan oleh hukum persyaratan tersebut), dengan pilihan tidak ikut yang ditawarkan melalui iklan "Jangan Jual Pribadi Saya" Informasi" tautan di bagian "penjualan" beranda pihak ketiga. Tujuan Amerika Serikat privasi status panduan kepatuhan hukum menawarkan kemampuan untuk pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat berpartisipasi dalam penjualan aset dan mengikuti panduan dari masing-masing jaringan tersebut untuk memastikan kepatuhan.

Plugin mediasi Google Mobile Ads untuk AppLovin versi 6.3.1 mencakup AppLovin.SetDoNotSell() . Kode contoh berikut menunjukkan cara meneruskan informasi izin ke AppLovin SDK. Opsi ini harus ditetapkan sebelum Anda menginisialisasi Google Mobile Ads SDK untuk memastikan permintaan tersebut diteruskan dengan benar ke AppLovin SDK.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

Lihat Privasi AppLovin dokumentasi untuk informasi selengkapnya.

Langkah 5: Tambahkan kode yang diperlukan

Android

Tidak ada kode tambahan yang diperlukan untuk integrasi AppLovin.

iOS

Integrasi SKAdNetwork

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

Langkah 6: Uji penerapan

Aktifkan iklan percobaan

Pastikan Anda mendaftarkan perangkat pengujian Anda untuk AdMob dan mengaktifkan mode pengujian di AppLovin UI.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari AppLovin, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan AppLovin (Bidding) and AppLovin (Waterfall) sumber iklan.

Langkah opsional

Pengoptimalan

Menambahkan panggilan ke AppLovin.Initialize() ke aktivitas peluncuran akan memberikan Kemampuan AppLovin untuk melacak peristiwa segera setelah aplikasi dimulai.

Kode error

Jika adaptor gagal menerima iklan dari AppLovin, penayang dapat memeriksa error yang mendasar dari respons iklan menggunakan ResponseInfo di bagian class berikut:

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Android

Kode error Alasan
-1009 hingga -1, 204 AppLovin SDK menampilkan error. Lihat Dokumentasi AppLovin untuk mengetahui detail selengkapnya.
101 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung AppLovin.
103 Konteksnya null.
104 Token bid AppLovin kosong.
105 Meminta beberapa iklan untuk zona yang sama. AppLovin hanya dapat memuat 1 iklan pada satu waktu per zona.
106 Iklan belum siap ditampilkan.
108 Adaptor AppLovin tidak mendukung format iklan yang diminta.

iOS

Kode error Alasan
-1009 hingga -1, 204 AppLovin SDK menampilkan error. Lihat dokumentasi AppLovin untuk mengetahui detail selengkapnya.
101 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung AppLovin.
102 Parameter server AppLovin yang dikonfigurasi di UI AdMob tidak ada/tidak valid.
103 Gagal menampilkan iklan AppLovin.
104 Meminta beberapa iklan untuk zona yang sama. AppLovin hanya dapat memuat 1 iklan pada satu waktu per zona.
105 Kunci SDK AppLovin tidak ditemukan.
107 Token bid kosong.
108 Adaptor AppLovin tidak mendukung format iklan yang diminta.
110 AppLovin mengirim callback pemuatan yang berhasil, tetapi tidak memuat iklan.

Log Perubahan Plugin Mediasi Unity AppLovin

Versi 7.4.0

Versi 7.3.1

Versi 7.3.0

Versi 7.2.2

Versi 7.2.1

Versi 7.2.0

Versi 7.1.0

Versi 7.0.1

Versi 7.0.0

Versi 6.9.1

Versi 6.9.0

Versi 6.8.0

Versi 6.7.0

Versi 6.6.0

Versi 6.5.1

Versi 6.5.0

Versi 6.4.3

Versi 6.4.2

Versi 6.4.1

Versi 6.4.0

Versi 6.3.1

Versi 6.3.0

Versi 6.2.1

Versi 6.2.0

Versi 6.1.0

Versi 6.0.0

Versi 5.1.3

Versi 5.1.2

Versi 5.1.1

Versi 5.1.0

Versi 5.0.0

Versi 4.8.1

Versi 4.8.0

Versi 4.7.0

Versi 4.6.2

Versi 4.6.1

Versi 4.6.0

Versi 4.5.8

Versi 4.5.7

Versi 4.5.6

Versi 4.5.5

Versi 4.5.4

Versi 4.5.3

Versi 4.5.2

Versi 4.5.1

Versi 4.5.0

Versi 4.4.1

Versi 4.4.0

Versi 4.3.0

Versi 4.2.0

  • Mendukung adaptor Android AppLovin versi 9.4.2.0.
  • Mendukung adaptor AppLovin iOS versi 6.6.1.0.

Versi 4.1.0

  • Mengupdate plugin untuk mendukung API Reward open-beta yang baru.
  • Mendukung adaptor Android AppLovin versi 9.2.1.1.
  • Mendukung adaptor AppLovin iOS versi 6.3.0.0.

Versi 4.0.0

  • Mendukung adaptor Android AppLovin versi 9.2.1.0.
  • Mendukung adaptor AppLovin iOS versi 6.2.0.0.

Versi 3.1.2

  • Mendukung adaptor Android AppLovin versi 8.1.4.0.
  • Mendukung adaptor AppLovin iOS versi 5.1.2.0.

Versi 3.1.1

  • Mendukung adaptor Android AppLovin versi 8.1.0.0.
  • Mendukung adaptor AppLovin iOS versi 5.1.1.0.

Versi 3.1.0

  • Mendukung adaptor Android AppLovin versi 8.1.0.0.
  • Mendukung adaptor AppLovin iOS versi 5.1.0.0.

Versi 3.0.3

  • Mendukung adaptor Android AppLovin versi 8.0.2.1.
  • Mendukung adaptor AppLovin iOS versi 5.0.2.0.

Versi 3.0.2

  • Mendukung AppLovin Android SDK versi 8.0.1.
  • Mendukung AppLovin iOS SDK versi 5.0.1.

Versi 3.0.1

  • Mendukung AppLovin Android SDK versi 8.0.0.
  • Mendukung AppLovin iOS SDK versi 5.0.1.
  • Menambahkan metode AppLovin.SetIsAgeRestrictedUser() untuk menunjukkan apakah pengguna diketahui berada dalam kategori yang dikenai pembatasan usia.

Versi 3.0.0

  • Mendukung AppLovin Android SDK versi 8.0.0.
  • Mendukung AppLovin iOS SDK versi 5.0.1.
  • Menambahkan metode AppLovin.SetHasUserConsent() untuk meneruskan tanda izin pengguna ke AppLovin SDK.

Versi 2.0.0

  • Mendukung AppLovin Android SDK versi 7.8.6.
  • Mendukung AppLovin iOS SDK versi 5.0.1.

Versi 1.2.1

  • Mendukung AppLovin Android SDK versi 7.8.6.
  • Mendukung AppLovin iOS SDK versi 4.8.3.

Versi 1.2.0

  • Mendukung AppLovin Android SDK versi 7.8.5.
  • Mendukung AppLovin iOS SDK versi 4.8.3.

Versi 1.1.0

  • Mendukung AppLovin Android SDK versi 7.7.0.
  • Mendukung AppLovin iOS SDK versi 4.7.0.

Versi 1.0.0

  • Rilis pertama!
  • Mendukung AppLovin Android SDK versi 7.4.1.
  • Mendukung AppLovin iOS SDK versi 4.4.1.