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

Integrasi
Bidding
Air Terjun
Format
Membuka Aplikasi	^1
Banner	^2
Interstisial
Reward
Native

¹ 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 Ad Manager, 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

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Air Terjun

Di UI AppLovin, pilih Applications di bagian Monetization untuk membuka aplikasi terdaftar Anda. Pilih aplikasi yang ingin Anda gunakan dengan mediasi dari daftar aplikasi yang tersedia.

Buat zona

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Air Terjun

Di UI AppLovin, pilih Zones di bagian Monetization untuk melihat ID zona terdaftar Anda. Jika Anda sudah membuat zona yang diperlukan untuk aplikasi, lanjutkan ke Langkah 2. Untuk membuat ID zona baru, klik Buat Zona.

Masukkan nama ID Zona, pilih Android sebagai Platform, dan pilih Jenis Iklan.

Konfigurasi Harga untuk zona dengan memilih CPM Tetap atau Dioptimalkan oleh AppLovin. CPM dapat dikonfigurasi per negara untuk opsi CPM Tetap. Kemudian, klik Simpan.

Setelah zona dibuat, ID zona dapat ditemukan di kolom Zone ID.

Catatan: Sebaiknya buat zona AppLovin yang sesuai dengan setiap unit iklan Ad Manager agar Ad Manager dapat lebih efektif Mengoptimalkan sumber iklan dalam mediasi.

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, buat file app-ads.txt untuk Ad Manager.

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

Login ke akun Ad Manager Anda.

Menambahkan AppLovin di Perusahaan

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Air Terjun

Buka Admin > Perusahaan, lalu klik tombol Perusahaan baru di tab Semua perusahaan. Pilih Jaringan iklan.

Pilih AppLovin sebagai Jaringan iklan, masukkan Nama unik, dan aktifkan Mediasi. Aktifkan Pengumpulan data otomatis, lalu masukkan Kunci Laporan yang diperoleh di bagian sebelumnya.

Anda tidak perlu memasukkan Nama Pengguna atau Sandi. Klik Simpan setelah selesai.

Mengaktifkan berbagi sinyal aman

Bidding

Buka Admin > Setelan global. Buka tab Setelan akun Ad Exchange, lalu tinjau dan aktifkan Berbagi sinyal aman. Klik Simpan.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Membagikan sinyal aman pada permintaan bid

Bidding

Buka Inventaris > Sinyal Aman. Di bagian Sinyal aman, cari AppLovin Corp. dan aktifkan Aktifkan integrasi aplikasi.

Klik Simpan.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Mengizinkan berbagi sinyal aman untuk Bidding dengan SDK

Bidding

Buka Penayangan > Setelan saluran permintaan. Di tab Setelan default, aktifkan Izinkan berbagi sinyal aman untuk Bidding SDK.

Klik Simpan.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Mengonfigurasi bidding AppLovin

Bidding

Buka Penayangan > Bidder, lalu klik Buka Bidding dengan SDK.

Klik Bidder baru.

Pilih AppLovin sebagai bidder.

Klik Lanjutkan untuk mengaktifkan Bidding dengan SDK untuk bidder ini.

Klik Selesai.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Mengonfigurasi pemetaan unit iklan

Bidding

Buka Penayangan > Bidder, lalu klik Buka Bidding dengan SDK.

Pilih perusahaan untuk AppLovin.

Buka tab Pemetaan unit iklan, lalu klik Pemetaan unit iklan baru.

Pilih Unit iklan tertentu. Pilih unit iklan dan format, Aplikasi seluler sebagai Jenis inventaris, dan Aplikasi seluler Anda. Kemudian, masukkan Kunci SDK yang diperoleh di bagian sebelumnya. Terakhir, klik Simpan.

Penting: Targetkan unit iklan yang dipilih dengan minimal satu grup hasil.

Air Terjun

Buka Penayangan > Grup hasil, lalu klik tombol Grup hasil baru. Pilih Aplikasi seluler Anda.

Scroll ke bawah, lalu klik Tambahkan partner hasil.

Pilih perusahaan yang Anda buat untuk AppLovin di bagian sebelumnya. Pilih Mediasi SDK seluler sebagai Jenis integrasi, Android sebagai Platform, dan Aktif sebagai Status.

Masukkan Bundle ID aplikasi Anda bersama dengan SDK Key dan Zone ID yang diperoleh di bagian sebelumnya, serta nilai Default CPM. Klik Simpan.

Catatan: Pengumpulan data otomatis membutuhkan waktu beberapa hari untuk mengumpulkan data sebelum dapat menghitung nilai CPM Dinamis untuk jaringan mediasi secara akurat. Setelah eCPM dapat dihitung, eCPM tersebut akan otomatis diperbarui untuk Anda.

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

Penting: Pastikan Anda memiliki izin Pengelolaan Akun untuk menyelesaikan konfigurasi untuk Izin dan GDPR Uni Eropa, peraturan Negara Bagian AS, dan Platform Pesan Pengguna. Lihat Mengelola akses pengguna ke akun Anda untuk mengetahui detailnya.

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

Langkah 3: Impor SDK dan adaptor AppLovin

Catatan: Kegagalan mengintegrasikan AppLovin dan GMA Next-Gen SDK versi yang kompatibel dapat menyebabkan masalah build.

Integrasi Android Studio (direkomendasikan)

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

Kotlin

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")
}

Groovy

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.

Java

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

Kotlin

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.

Java

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

Kotlin

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 Ad Manager dan mengaktifkan mode pengujian di UI AppLovin.

Penting: Nonaktifkan mode pengujian untuk Ad Manager dan AppLovin sebelum merilis aplikasi Anda.

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():

Java

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

Kotlin

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

Pengoptimalan

Lakukan inisialisasi AppLovin SDK saat aplikasi Anda diluncurkan. Hal ini memungkinkan AppLovin mulai melacak peristiwa dengan segera."

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:

Kode error	Alasan
-1009 hingga -1.204	AppLovin SDK menampilkan error. Lihat dokumentasi AppLovin untuk mengetahui detail selengkapnya.
101	Ukuran iklan yang diminta tidak sesuai dengan ukuran banner yang didukung AppLovin.
103	Konteks bernilai null.
104	Token bid AppLovin kosong.
105	Meminta beberapa iklan untuk zona yang sama. AppLovin hanya dapat memuat 1 iklan dalam satu waktu per zona.
106	Iklan belum siap ditampilkan.
108	Adaptor AppLovin tidak mendukung format iklan yang diminta.
109	Konteks bukan instance Aktivitas.
110	Kunci SDK tidak ada.
112	Pengguna adalah anak-anak.
113	ID unit iklan tidak ada.