Mengintegrasikan AppLovin dengan mediasi

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

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk AppLovin memiliki kemampuan berikut:

¹ Integrasi waterfall dalam versi beta tertutup.

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

Prasyarat

Sebelum melanjutkan, verifikasi hal berikut:

• Versi Google Mobile Ads Flutter Plugin terbaru.
• Framework Flutter versi 3.7.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 Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Flutter Plugin. Lihat Menyiapkan Google Mobile Ads Flutter Plugin untuk mengetahui detailnya.

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

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, 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 dalam panduan Mode Pengujian MAX AppLovin tentang cara mengaktifkan iklan pengujian AppLovin.

Langkah 2: Siapkan permintaan AppLovin di UI Ad Manager

Mengonfigurasi setelan mediasi untuk unit iklan Anda

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

Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian Amerika Serikat untuk menambahkan AppLovin Corp. ke daftar partner iklan peraturan Eropa dan negara bagian Amerika Serikat di UI Ad Manager.

Langkah 3: Impor AppLovin SDK dan adapter

Integrasi melalui pub.dev

Tambahkan dependensi berikut dengan versi terbaru SDK dan adaptor AppLovin di file pubspec.yaml paket Anda:

dependencies:
  gma_mediation_applovin: ^2.6.4

Integrasi Manual

Download plugin mediasi Google Mobile Ads versi terbaru untuk AppLovin, ekstrak file yang didownload, lalu tambahkan folder plugin yang diekstrak (dan kontennya) ke project Flutter Anda. Kemudian, referensikan plugin di file pubspec.yaml Anda dengan menambahkan dependensi berikut:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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 disebarkan ke setiap sumber iklan dalam rantai mediasi Anda.

Adaptor Flutter AppLovin versi 1.0.0 dan yang lebih baru mendukung penerusan sinyal izin GDPR dari UMP SDK dan platform pengelolaan izin yang terintegrasi dengan spesifikasi Izin Tambahan Google

Lihat setelan privasi AppLovin untuk mengetahui informasi selengkapnya.

Mendeklarasikan pengguna turunan

AppLovin tidak mendukung inisialisasi AppLovin SDK sehubungan dengan anak-anak. Untuk informasi selengkapnya, lihat dokumentasi AppLovin tentang "Prohibition on Children Data or Using the Services for Children or Apps Exclusively Targeted to Children" untuk Android atau iOS.

Plugin mediasi Flutter Google Mobile Ads untuk AppLovin versi 9.1.0 atau yang lebih tinggi otomatis menonaktifkan mediasi ke AppLovin untuk aplikasi yang mendeklarasikan pengguna anak-anak menggunakan salah satu setelan berikut:

• Menetapkan perlakuan berdasarkan usia
• Setelan yang ditujukan untuk anak-anak
• Pengguna di bawah usia dewasa

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 rangkaian mediasi yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Plugin mediasi Google Mobile Ads untuk AppLovin mencakup metode GmaMediationApplovin.setDoNotSell(). Kode contoh berikut menunjukkan cara meneruskan informasi izin ke AppLovin SDK. Opsi ini harus ditetapkan sebelum Anda melakukan inisialisasi Google Mobile Ads SDK untuk memastikan opsi tersebut diteruskan dengan benar ke AppLovin SDK.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

Lihat dokumentasi Privasi AppLovin untuk mengetahui informasi selengkapnya.

Langkah 5: Tambahkan kode yang diperlukan

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager 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 penerusan objek AppLovinMediationExtras ke permintaan iklan untuk menyetel parameter khusus jaringan. Contoh kode berikut menunjukkan cara menonaktifkan audio pada iklan video menggunakan parameter isMuted:

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

Pengoptimalan

Menambahkan panggilan ke GmaMediationApplovin.initializeSdk('sdkKey') ke aktivitas peluncuran Anda akan memberi AppLovin kemampuan untuk melacak peristiwa segera setelah aplikasi dimulai.

Kode error

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

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Log Perubahan Adaptor Mediasi Flutter AppLovin

Versi 2.6.5 (Dalam proses)

Versi 2.6.4

• Mendukung adaptor Android AppLovin versi 13.6.4.1.
• Mendukung AppLovin iOS adapter versi 13.6.4.0.
• Dibuat dan diuji dengan Plugin Google Mobile Ads Flutter versi 9.1.0.

Versi 2.6.3

• Diupdate untuk mendukung Plugin Flutter Google Mobile Ads versi 9.1.0.
• Menambahkan dukungan Swift Package Manager.
• Mendukung adaptor Android AppLovin versi 13.6.4.0.
• Mendukung AppLovin iOS adapter versi 13.6.3.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 9.1.0.

Versi 2.6.2

• Diupdate untuk mendukung Plugin Flutter Google Mobile Ads versi 9.0.0.
• Mendukung AppLovin Android adapter versi 13.6.3.0.
• Mendukung AppLovin iOS adapter versi 13.6.3.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 9.0.0.

Versi 2.6.1

• Mendukung adaptor Android AppLovin versi 13.6.2.0.
• Mendukung AppLovin iOS adapter versi 13.6.2.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 8.0.0.

Versi 2.6.0

• Mengupdate versi Flutter minimum ke 3.38.1.
• Diupdate untuk mendukung Plugin Flutter Google Mobile Ads versi 8.0.0.
• Mendukung adaptor Android AppLovin versi 13.6.2.0.
• Mendukung adaptor AppLovin iOS versi 13.6.1.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 8.0.0.

Versi 2.5.2

• Mengupdate versi minimum Flutter ke 3.35.1
• Diupdate untuk mendukung Plugin Flutter Google Mobile Ads versi 7.0.0
• Mendukung adaptor Android AppLovin versi 13.5.1.0.
• Mendukung adaptor AppLovin iOS versi 13.5.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0.

Versi 2.5.1

• Mendukung AppLovin Android adapter versi 13.5.1.0.
• Mendukung adaptor iOS AppLovin versi 13.5.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.5.0

• Mendukung adaptor Android AppLovin versi 13.5.0.0.
• Mendukung adaptor AppLovin iOS versi 13.5.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.4.0

• Mendukung adaptor Android AppLovin versi 13.4.0.0.
• Mendukung AppLovin iOS adapter versi 13.4.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.3.2

• Mendukung AppLovin Android Adapter versi 13.3.1.1.
• Mendukung adaptor iOS AppLovin versi 13.3.1.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.3.1

• Mendukung AppLovin Android adapter versi 13.3.1.0.
• Mendukung AppLovin iOS adapter versi 13.3.1.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.3.0

• Mendukung adaptor Android AppLovin versi 13.3.0.0.
• Mendukung adaptor AppLovin iOS versi 13.3.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.2.1

• Mendukung AppLovin Android adapter versi 13.2.0.1.
• Mendukung AppLovin iOS adapter versi 13.2.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.2.0

• Mendukung adaptor Android AppLovin versi 13.2.0.0.
• Mendukung adaptor iOS AppLovin versi 13.2.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 2.1.0

• Mendukung AppLovin Android adapter versi 13.1.0.0.
• Mendukung adaptor AppLovin iOS versi 13.1.0.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.

Versi 2.0.0

• Mendukung AppLovin Android adapter versi 13.0.1.0.
• Mendukung AppLovin iOS adapter versi 13.0.1.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.

Versi 1.2.0

• Mendukung adaptor Android AppLovin versi 12.6.1.0.
• Mendukung adaptor iOS AppLovin versi 12.6.1.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.

Versi 1.1.0

• API untuk GmaMediationApplovin tidak lagi statis.
• Mendukung adaptor Android AppLovin versi 12.4.3.0.
• Mendukung adaptor AppLovin iOS versi 12.4.2.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.

Versi 1.0.0

• Rilis awal.

• Mendukung adaptor Android AppLovin versi 12.3.0.0.
• Mendukung adaptor iOS AppLovin versi 12.2.1.0.

• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.0.0.