Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Jaringan Iklan LINE menggunakan mediasi, yang mencakup integrasi waterfall. Codelab ini membahas cara menambahkan Jaringan Iklan LINE ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor Jaringan Iklan LINE ke dalam aplikasi Flutter.
Integrasi dan format iklan yang didukung
Adaptor mediasi AdMob untuk Jaringan Iklan LINE memiliki kemampuan berikut:
Integrasi | |
---|---|
Bidding | 1 |
Air Terjun | |
Format | |
Banner | |
Interstisial | |
Reward | |
Native |
1 Integrasi bidding masih dalam versi beta tertutup. Hubungi Account Manager Anda untuk meminta akses.
Persyaratan
- Google Mobile Ads SDK Terbaru
- Flutter 3.7.0 atau yang lebih tinggi
- Untuk men-deploy di Android
- Android API level 21 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 12.0 atau yang lebih tinggi
- Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
- Selesaikan Panduan memulai mediasi
Langkah 1: Siapkan konfigurasi di UI Jaringan Iklan LINE
Login ke akun Jaringan Iklan LINE Anda.
Menambahkan aplikasi baru
Klik 広告枠管理 (Ad Slot Management) > メディア (Media). Kemudian, klik 新規作成 (Create New).
Isi formulir, lalu klik 登録 (Daftar).
Catat ID Aplikasi.
Membuat penempatan iklan
Klik ID aplikasi yang ingin Anda tambahi penempatan iklan. Kemudian, pilih 詳細 (Detail).
Klik スロット 追加 (Tambahkan Slot).
Isi formulir dan setelah selesai, klik (登録) Daftar.
Catat ID Slot.
Langkah 2: Siapkan permintaan Jaringan Iklan LINE di UI AdMob
Mengonfigurasi setelan mediasi untuk unit iklan
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.
Langkah 3: Impor SDK dan adaptor Jaringan Iklan LINE
Integrasi melalui pub.dev
Tambahkan dependensi berikut dengan versi terbaru
adaptor dan LINE Ads Network SDK di
file pubspec.yaml
paket Anda:
dependencies:
gma_mediation_line: ^
Integrasi Manual
Download plugin mediasi Google Mobile Ads versi terbaru untuk
LINE 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
dengan menambahkan dependensi berikut:
dependencies:
gma_mediation_line:
path: path/to/local/package
Langkah 4: Tambahkan kode yang diperlukan
Tidak diperlukan kode tambahan untuk integrasi Jaringan Iklan LINE.
Integrasi SKAdNetwork
Ikuti dokumentasi Jaringan Iklan LINE
untuk menambahkan ID SKAdNetwork ke file Info.plist
project Anda.
Langkah 5: Uji penerapan Anda
Mengaktifkan iklan pengujian
Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Jaringan Iklan LINE, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Jaringan Iklan LINE (Waterfall).
Langkah opsional
Parameter khusus jaringan
Plugin mediasi Flutter Jaringan Iklan LINE mendukung parameter permintaan tambahan
berikut yang dapat diteruskan ke adaptor melalui
class LineMediationExtras
:
-
enableAdSound
: Menentukan status awal suara default banner, interstisial, dan iklan reward.
Berikut adalah 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 Jaringan Iklan LINE,
penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan
ResponseInfo
di bagian class berikut:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
GADMediationAdapterLine
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor LINE Ads Network saat iklan gagal dimuat:
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 Jaringan Iklan LINE. |
104 | com.google.ads.mediation.line | Gagal memuat iklan interstisial atau reward karena konteks aktivitas tidak ada. |
105 | com.google.ads.mediation.line | SDK Jaringan Iklan LINE gagal menampilkan iklan interstisial atau reward. |
106 | com.google.ads.mediation.line | Gagal memuat iklan native karena aset tidak ada. |
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 Jaringan Iklan LINE. |
103 | com.google.ads.mediation.line | Gagal memuat aset gambar ikon informasi di iklan native. |
Log Perubahan Adaptor Mediasi Flutter Line
1.0.0
- Rilis awal.
- Mendukung Adaptor Android Line versi 2.9.20250110.0.
- Mendukung Adaptor iOS Line versi 2.9.20241106.1.
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.