Panduan ini menunjukkan cara menggunakan Google Mobile Ads Flutter Plugin untuk memuat dan menampilkan iklan dari LINE Ads Network menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini mencakup cara menambahkan LINE Ads Network ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan LINE Ads Network SDK dan adaptor ke dalam aplikasi Flutter.
Integrasi dan format iklan yang didukung
Adaptor mediasi Ad Manager untuk LINE 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 tinggi
- Untuk men-deploy di Android
- Android API level 23 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 13.0 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 LINE Ads Network
Daftar dan login ke akun LINE Ads Network Anda.
Menambahkan aplikasi baru
Buka tab アプリ (App) , lalu klik tombol 新規登録 (New Registration).
Isi formulir, lalu klik 登録 (Register).
Catat アプリID (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.
Hubungi account manager LINE Ads Network Anda untuk mendapatkan akses guna membuat penempatan iklan native di UI LINE Ads Network.
Catat スロットID (Slot ID).
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 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 LINE Ads Network, lihat
Tentang app-ads.txt.
Langkah 2: Menyiapkan permintaan LINE 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 LINE Ads Network SDK dan adaptor
Integrasi melalui pub.dev
Tambahkan dependensi berikut dengan versi terbaru LINE Ads Network SDK dan adaptor di file pubspec.yaml paket Anda:
dependencies:
gma_mediation_line: ^2.0.0
Integrasi Manual
Download plugin mediasi Google Mobile Ads versi terbaru untuk
LINE Ads Network,
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_line:
path: path/to/local/package
Langkah 4: Menambahkan kode yang diperlukan
Android
Tidak ada kode tambahan yang diperlukan untuk integrasi LINE Ads Network.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi LINE 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 LINE Ads Network, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan LINE Ads Network (Waterfall) sumber iklan.
Langkah opsional
Parameter khusus jaringan
Plugin mediasi Flutter LINE Ads Network 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 LINE 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 LINE Ads Network saat iklan gagal dimuat:
Android
| Kode error | Domain | Alasan |
|---|---|---|
| 1-10 | com.five_corp.ad | LINE Ads Network SDK menampilkan error khusus SDK. Lihat dokumentasi LINE Ads Network untuk mengetahui detail selengkapnya. |
| 101 | com.google.ads.mediation.line | ID Aplikasi tidak ada atau tidak valid. |
| 102 | com.google.ads.mediation.line | ID Slot tidak ada atau tidak valid. |
| 103 | com.google.ads.mediation.line | Ukuran iklan yang diminta tidak cocok dengan ukuran iklan banner yang didukung LINE Ads Network. |
| 104 | com.google.ads.mediation.line | Gagal memuat iklan interstisial atau reward karena konteks aktivitas tidak ada. |
| 105 | com.google.ads.mediation.line | LINE Ads Network SDK gagal menampilkan iklan interstisial atau reward. |
| 106 | com.google.ads.mediation.line | Gagal memuat iklan native karena aset tidak ada. |
iOS
| Kode error | Domain | Alasan |
|---|---|---|
| 1-10 | Dikirim oleh LINE Ads Network SDK | LINE Ads Network SDK menampilkan error khusus SDK. Lihat dokumentasi LINE Ads Network untuk mengetahui detail selengkapnya. |
| 101 | com.google.ads.mediation.line | Parameter server tidak valid (misalnya, ID Aplikasi atau ID Slot tidak ada). |
| 102 | com.google.ads.mediation.line | Ukuran iklan yang diminta tidak cocok dengan ukuran iklan banner yang didukung LINE Ads Network. |
| 103 | com.google.ads.mediation.line | Gagal memuat aset gambar ikon informasi di iklan native. |
Log Perubahan Adaptor Mediasi Flutter LINE
Versi 2.0.2 (Dalam proses)
Versi 2.0.1 (Dalam proses)
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 Line Android versi 3.0.1.0.
- Mendukung adaptor Line iOS versi 3.0.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0
Versi 1.0.6
- Mendukung adaptor Line Android versi 2.9.20251028.0.
- Mendukung adaptor Line iOS versi 2.9.20251119.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.5
- Mendukung adaptor Line Android versi 2.9.20250924.1.
- Mendukung adaptor Line iOS versi 2.9.20250930.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.4
- Mendukung adaptor Line Android versi 2.9.20250718.0.
- Mendukung adaptor Line iOS versi 2.9.20250512.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.3
- Mendukung adaptor Line Android versi 2.9.20250519.0.
- Mendukung adaptor Line iOS versi 2.9.20250512.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.2
- Mendukung adaptor Line Android versi 2.9.20250317.1.
- Mendukung adaptor Line iOS versi 2.9.20241106.3.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0
Versi 1.0.1
- Mendukung adaptor Line Android versi 2.9.20250110.1.
- Mendukung adaptor Line iOS 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 Line Android versi 2.9.20250110.0.
- Mendukung adaptor Line iOS versi 2.9.20241106.1.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.