Mengintegrasikan AppLovin dengan mediasi

Pilih platform: Android (beta) Android iOS Unity Flutter

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari AppLovin menggunakan Mediasi AdMob yang mencakup integrasi waterfall dan bidding. Panduan ini mencakup cara menambahkan AppLovin ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor AppLovin ke dalam aplikasi Android.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk AppLovin memiliki kemampuan berikut:

¹ Format iklan Layar Pembuka Aplikasi hanya tersedia untuk integrasi waterfall.

² Waterfall hanya mendukung ukuran banner 320x50 dan 728x90. Bidding tidak mendukung iklan banner.

Persyaratan

• Level API Android 24 atau yang lebih tinggi

• [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan adaptor AppLovin 9.4.2.0 atau yang lebih tinggi (sebaiknya gunakan versi terbaru).

• GMA Next-Gen SDK Terbaru

• Selesaikan Panduan memulai mediasi

Langkah 1: Siapkan konfigurasi di UI AppLovin

Daftar atau login ke akun AppLovin Anda.

Untuk menyiapkan unit iklan AdMob, Anda memerlukan Kunci SDK dan Kunci Laporan AppLovin. Untuk menemukannya, buka UI AppLovin > Account > Keys untuk melihat kedua nilai.

Jika hanya berencana mengintegrasikan bidding, Anda dapat melanjutkan ke mengonfigurasi setelan mediasi.

Pilih aplikasi untuk mediasi

Buat zona

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 AppLovin, Tambahkan AppLovin ke file app-ads.txt Anda.

Mengaktifkan mode pengujian

Ikuti petunjuk di panduan Mode Pengujian MAX AppLovin tentang cara mengaktifkan iklan percobaan AppLovin.

Langkah 2: Siapkan permintaan AppLovin di UI AdMob

Mengonfigurasi setelan mediasi untuk unit iklan

Anda perlu menambahkan AppLovin ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan AppLovin sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Done.

Sekarang Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang Anda pilih:

Menambahkan AppLovin sebagai sumber iklan

Bidding

Di bagian Sumber Iklan, di kartu Bidding, pilih Tambahkan sumber iklan. Kemudian, pilih AppLovin .

Klik Cara menandatangani perjanjian kemitraan dan menyiapkan kemitraan bidding dengan AppLovin.



Klik Pahami & setujui, lalu klik Lanjutkan.



Jika sudah memiliki pemetaan untuk AppLovin, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan Kunci SDK yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Air Terjun

Di bagian kartu Waterfall di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan.

Pilih AppLovin dan aktifkan tombol Optimalkan. Masukkan Kunci Laporan yang diperoleh di bagian sebelumnya untuk menyiapkan pengoptimalan sumber iklan bagi AppLovin. Kemudian, masukkan nilai eCPM untuk AppLovin dan klik Lanjutkan.



Jika sudah memiliki pemetaan untuk AppLovin, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan ID Paket aplikasi Anda beserta Kunci SDK dan ID Zona yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Menambahkan AppLovin Corp. ke daftar partner iklan GDPR dan peraturan negara bagian Amerika Serikat

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

Langkah 3: Impor SDK dan adaptor AppLovin

Integrasi Android Studio (direkomendasikan)

Dalam file gradle level aplikasi, tambahkan implementasi dependencies dan konfigurasi berikut:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:applovin:13.5.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:applovin:13.5.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrasi manual

• Download AppLovin Android SDK, ekstrak applovin-sdk-x.y.z.jar, dan tambahkan ke project Anda.

• Buka artefak adaptor AppLovin di Repositori Maven Google. Pilih versi terbaru, download file .aar adapter AppLovin, lalu tambahkan ke project Anda.

Langkah 4: Terapkan setelan privasi di AppLovin SDK

Izin Uni Eropa dan GDPR

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 diteruskan ke setiap sumber iklan dalam rantai mediasi Anda. Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Sejak SDK versi 12.0.0, AppLovin mendukung pembacaan string izin dari preferensi bersama dan menetapkan status izin yang sesuai.

Jika Anda tidak menggunakan AppLovin SDK versi 12.0.0+ atau tidak menggunakan CMP yang menulis string izin ke preferensi bersama, Anda dapat menggunakan metode setHasUserConsent. Contoh berikut meneruskan informasi izin ke AppLovin SDK. Anda harus menetapkan opsi ini sebelum menginisialisasi GMA Next-Gen SDK untuk memastikan opsi tersebut diteruskan dengan benar ke AppLovin SDK.

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

Lihat setelan privasi AppLovin untuk mengetahui informasi selengkapnya.

Mendeklarasikan pengguna anak

Mulai AppLovin SDK 13.0.0, AppLovin tidak lagi mendukung tanda pengguna yang dibatasi usia dan Anda tidak boleh melakukan inisialisasi atau menggunakan AppLovin SDK sehubungan dengan "anak" sebagaimana didefinisikan dalam hukum yang berlaku. Untuk mengetahui informasi selengkapnya, lihat dokumentasi AppLovin tentang Larangan atas Data Anak atau Penggunaan Layanan untuk Anak atau Aplikasi yang Ditujukan Khusus untuk Anak .

Adapter AppLovin versi 13.0.0.1 atau yang lebih tinggi menonaktifkan mediasi AppLovin secara otomatis untuk aplikasi yang mendeklarasikan salah satu setelan berikut dengan GMA Next-Gen SDK:

• Setelan yang ditujukan untuk anak-anak

• Pengguna di bawah usia dewasa

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian AS mewajibkan pemberian hak kepada pengguna untuk memilih tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh 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 rangkaian mediasi yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

AppLovin SDK menyertakan metode setDoNotSell untuk memungkinkan penayang memilih tidak ikut penjualan informasi pribadi.

Contoh berikut meneruskan informasi izin ini ke AppLovin SDK. Anda harus menetapkan opsi ini sebelum menginisialisasi GMA Next-Gen SDK untuk memastikan opsi tersebut diteruskan dengan benar ke AppLovin SDK.

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

Lihat dokumentasi Privasi AppLovin untuk mengetahui informasi selengkapnya.

Langkah 5: Tambahkan kode yang diperlukan

Tidak ada kode tambahan yang diperlukan untuk integrasi AppLovin.

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

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

Memverifikasi iklan percobaan

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

Langkah opsional

Parameter khusus jaringan

Adaptor AppLovin mendukung setMuteAudio() yang dapat menonaktifkan audio pada iklan video. Metode ini dapat dipanggil dari objek AppLovinExtras.Builder():

Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Pengoptimalan

Kode error

Jika adapter gagal menerima iklan dari AppLovin, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di bawah class berikut:

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

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