Panduan ini menunjukkan cara menggunakan Google Mobile Ads Flutter Plugin untuk memuat dan menampilkan iklan dari LY Ads Network menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan LY Ads Network ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan LY Ads Network SDK dan adaptor ke dalam aplikasi Flutter.
Integrasi dan format iklan yang didukung
Adaptor mediasi Ad Manager untuk LY Ads Network memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Waterfall | |
| Format | |
| Banner | |
| Interstisial | |
| Reward | |
| Native | |
Persyaratan
- Terbaru Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 atau yang lebih baru
- Untuk men-deploy di Android
- Android API level 23 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 13.3 atau yang lebih tinggi
- Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Flutter Plugin. Lihat Menyiapkan Google Mobile Ads Flutter Plugin untuk mengetahui detailnya.
- Menyiapkan mediasi.
Langkah 1: Menyiapkan konfigurasi di UI LY Ads Network
Daftar dan login ke akun LY Ads Network Anda.
Menambahkan aplikasi baru
Buka tab App , lalu klik tombol New registration.
Isi formulir, lalu klik registration.
Catat App ID.
Android
iOS
Membuat slot iklan
Di tab App, pilih aplikasi Anda untuk melihat detail aplikasi. Di bagian Slot, klik Add.
Isi formulir untuk mengetahui detail tentang slot. Untuk Bidding Type, pilih Standard untuk mengonfigurasi slot ini untuk mediasi waterfall, atau Google SDK Bidding untuk mengonfigurasi slot ini untuk Bidding. Klik Create setelah formulir diisi.
Catat Slot ID.
Setelah membuat slot pertama, klik Review di halaman detail aplikasi Anda untuk mendapatkan persetujuan dari LY Ads Network. Proses ini mungkin perlu waktu beberapa saat. Hubungi perwakilan LY Ads Network Anda jika ada pertanyaan.
Membuat Kunci API Pelaporan
Buka tab Managing reporting API keys , lalu klik tombol Create API key.
Isi formulir, lalu klik Save.
Catat API Key ID dan API Key Secret Anda.
Memperbarui app-ads.txt
Penjual Resmi untuk Aplikasi 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 yang signifikan pada pendapatan iklan, Anda harus menerapkan file app-ads.txt.
Jika belum melakukannya,
buat file app-ads.txt untuk Ad Manager.
Untuk menerapkan app-ads.txt untuk LY Ads Network, lihat
Tentang app-ads.txt.
Langkah 2: Menyiapkan permintaan LY Ads Network di UI Ad Manager
Mengonfigurasi setelan mediasi untuk unit iklan Anda
Android
Untuk mengetahui petunjuknya, lihat langkah 2 di panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 di panduan untuk iOS.
Langkah 3: Mengimpor LY Ads Network SDK dan adaptor
Integrasi melalui pub.dev
Tambahkan dependensi berikut dengan versi LY Ads Network SDK dan adaptor terbaru di file pubspec.yaml paket Anda:
dependencies:
gma_mediation_line: ^2.1.0
Integrasi Manual
Download plugin mediasi Google Mobile Ads versi terbaru untuk
LY Ads Network,
ekstrak file yang didownload, dan 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_line:
path: path/to/local/package
Langkah 4: Menambahkan kode yang diperlukan
Android
Tidak ada kode tambahan yang diperlukan untuk integrasi LY Ads Network.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi LY Ads Network
untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.
Langkah 5: Menguji penerapan Anda
Mengaktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan percobaan dari LY Ads Network, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan LY Ads Network sumber iklan.
Langkah opsional
Parameter khusus jaringan
Plugin mediasi LY Ads Network Flutter mendukung parameter permintaan tambahan berikut yang dapat diteruskan ke adaptor melalui class LineMediationExtras:
-
enableAdSound: Menentukan status awal suara default iklan banner, interstisial, dan reward.
Berikut contoh kode cara membuat permintaan iklan yang menetapkan parameter ini:
LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [lineExtras],
);
Kode error
Jika adaptor gagal menerima iklan dari LY Ads Network,
penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan
ResponseInfo di class berikut:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Berikut kode dan pesan yang menyertainya yang ditampilkan oleh adaptor LY Ads Network saat iklan gagal dimuat:
Android
iOS
Log Perubahan Adaptor Mediasi Flutter Line
Versi 2.1.1 (Dalam proses)
Versi 2.1.0
- Memperbarui versi Flutter minimum ke 3.38.1
- Diperbarui untuk mendukung Plugin Flutter Google Mobile Ads versi 8.0.0
- Mendukung adaptor Android Line versi 3.1.0.0.
- Mendukung adaptor iOS Line versi 3.0.1.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 8.0.0
Versi 2.0.0
- Memperbarui versi Flutter minimum ke 3.35.1
- Diperbarui untuk mendukung Plugin Flutter Google Mobile Ads versi 7.0.0
- Mendukung adaptor Android Line versi 3.0.1.0.
- Mendukung adaptor iOS Line versi 3.0.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0
Versi 1.0.6
- Mendukung adaptor Android Line versi 2.9.20251028.0.
- Mendukung adaptor iOS Line versi 2.9.20251119.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.5
- Mendukung adaptor Android Line versi 2.9.20250924.1.
- Mendukung adaptor iOS Line versi 2.9.20250930.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.4
- Mendukung adaptor Android Line versi 2.9.20250718.0.
- Mendukung adaptor iOS Line versi 2.9.20250512.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.3
- Mendukung adaptor Android Line versi 2.9.20250519.0.
- Mendukung adaptor iOS Line versi 2.9.20250512.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.2
- Mendukung adaptor Android Line versi 2.9.20250317.1.
- Mendukung adaptor iOS Line versi 2.9.20241106.3.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.1
- Mendukung adaptor Android Line versi 2.9.20250110.1.
- Mendukung adaptor iOS Line versi 2.9.20241106.2.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.
Versi 1.0.0
- Rilis awal.
- Mendukung adaptor Android Line versi 2.9.20250110.0.
- Mendukung adaptor iOS Line versi 2.9.20241106.1.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.