Mengintegrasikan LY Ads Network dengan mediasi

Pilih platform: Android Baru Android iOS Unity Flutter

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 mencakup cara menambahkan Jaringan Iklan LY ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor Jaringan Iklan LY ke dalam aplikasi Flutter.

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk LY Ads Network memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner
Interstisial
Reward
Native

Persyaratan

  • Google Mobile Ads Flutter Plugin Terbaru
  • Flutter 3.7.0 atau yang lebih tinggi
  • Untuk men-deploy di Android
    • Level API Android 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: Siapkan konfigurasi di UI Jaringan Iklan LY

Daftar dan login ke akun LY Ads Network Anda.

Menambahkan aplikasi baru

Buka tab App, lalu klik tombol New registration.

Pendaftaran Baru

Isi formulir dan klik pendaftaran.

Formulir Pendaftaran Baru

Catat ID Aplikasi.

Android

Detail Pendaftaran

iOS

Detail Pendaftaran

Membuat slot iklan

Di tab Aplikasi, pilih aplikasi Anda untuk melihat detail aplikasi. Di bagian Slot, klik Tambahkan.

Tambahkan Slot

Isi formulir untuk mengetahui detail tentang slot. Untuk Jenis Bidding, pilih Standar untuk mengonfigurasi slot ini untuk mediasi waterfall, atau Bidding dengan SDK Google untuk mengonfigurasi slot ini untuk Bidding. Klik Buat setelah formulir diisi.

Menambahkan Formulir Slot

Catat ID Slot.

Detail Slot

Setelah membuat slot pertama, klik Tinjau di halaman detail aplikasi untuk mendapatkan persetujuan dari Jaringan Iklan LY. Proses ini mungkin memerlukan waktu beberapa saat. Hubungi perwakilan Jaringan Iklan LY jika ada pertanyaan.

Minta Peninjauan

Membuat Kunci API Pelaporan

Buka tab Mengelola kunci API pelaporan, lalu klik tombol Buat kunci API.

Tab Kunci API Pelaporan

Isi formulir lalu klik Simpan.

Formulir Kunci API Pelaporan

Catat ID Kunci API dan Rahasia Kunci API Anda.

Formulir Kunci API Pelaporan

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 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 LY Ads Network, lihat Tentang app-ads.txt.

Langkah 2: Siapkan permintaan Jaringan Iklan LY di UI Ad Manager

Mengonfigurasi setelan mediasi untuk unit iklan

Android

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.

iOS

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.

Langkah 3: Impor SDK dan adaptor Jaringan Iklan LY

Integrasi melalui pub.dev

Tambahkan dependensi berikut dengan versi terbaru LY Ads Network SDK dan adaptor 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, lalu tambahkan folder plugin yang diekstrak (dan isinya) 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

Android

Tidak ada kode tambahan yang diperlukan untuk integrasi Jaringan Iklan LY.

iOS

Integrasi SKAdNetwork

Ikuti dokumentasi Jaringan Iklan LY untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.

Langkah 5: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian Anda 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 sumber iklan LY Ads Network.

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 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 LY, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di kelas berikut:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor LY Ads Network saat iklan gagal dimuat:

Android

Kode error Domain Alasan
1-10 com.five_corp.ad LY Ads Network SDK menampilkan error khusus SDK. Lihat dokumentasi LY 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 sesuai dengan ukuran iklan banner yang didukung Jaringan Iklan LY.
104 com.google.ads.mediation.line Gagal memuat iklan interstisial atau iklan reward karena konteks aktivitas tidak ada.
105 com.google.ads.mediation.line SDK Jaringan Iklan LY 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 LY Ads Network SDK LY Ads Network SDK menampilkan error khusus SDK. Lihat dokumentasi LY Ads Network untuk mengetahui detail selengkapnya.
101 com.google.ads.mediation.line Parameter server tidak valid (mis. ID Aplikasi atau ID Slot tidak ada).
102 com.google.ads.mediation.line Ukuran iklan yang diminta tidak sesuai dengan ukuran iklan banner yang didukung Jaringan Iklan LY.
103 com.google.ads.mediation.line Gagal memuat aset gambar ikon informasi di iklan native.

Log Perubahan Adaptor Mediasi Flutter Line

Versi 2.1.1 (Dalam proses)

Versi 2.1.0

Versi 2.0.0

Versi 1.0.6

Versi 1.0.5

Versi 1.0.4

Versi 1.0.3

Versi 1.0.2

Versi 1.0.1

Versi 1.0.0