Mengintegrasikan LY Ads Network dengan mediasi

Pilih platform: Android iOS Unity Flutter Android (Legacy)

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 aplikasi Flutter.

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk Jaringan Iklan LY Ads memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner
Interstisial
Reward
Native

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
    • Level API Android 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.
  • Menyiapkan mediasi.

    • Langkah 1: Siapkan konfigurasi di UI Jaringan Iklan LY

    Daftar dan login ke akun Jaringan Iklan LY 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 Add.

    Tambahkan Slot

    Isi formulir untuk mengetahui detail tentang slot. Untuk Bidding Type, pilih Standard guna mengonfigurasi slot ini untuk mediasi waterfall, atau Google SDK Bidding guna 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 Anda untuk mendapatkan persetujuan dari Jaringan Iklan LY. Proses ini mungkin memerlukan waktu beberapa saat. Hubungi perwakilan Jaringan Iklan LY Anda jika ada pertanyaan.

    Minta Peninjauan

    Membuat Kunci API Pelaporan

    Buka tab Managing reporting API keys, lalu klik tombol Create API key.

    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

    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 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 Anda

    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.2.1

    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 Anda 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 LY Ads Network untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.

    Langkah 5: Uji penerapan Anda

    Mengaktifkan iklan pengujian

    Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.

    Memverifikasi iklan pengujian

    Untuk memverifikasi bahwa Anda menerima iklan pengujian 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 Flutter LY 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 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 LY Jaringan Iklan, 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 adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Jaringan Iklan LY saat iklan gagal dimuat:

    Android

    Kode error Domain Alasan
    1-10 com.five_corp.ad SDK Jaringan Iklan LY menampilkan error khusus SDK. Lihat dokumentasi Jaringan Iklan LY 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 LY Jaringan Iklan.
    104 com.google.ads.mediation.line Gagal memuat iklan interstisial atau reward karena tidak ada konteks aktivitas.
    105 com.google.ads.mediation.line SDK Jaringan Iklan LY Ads gagal menampilkan iklan interstisial atau iklan reward.
    106 com.google.ads.mediation.line Gagal memuat iklan native karena aset tidak lengkap.
    107 com.google.ads.mediation.line SDK FiveAd menampilkan pemuat iklan null.

    iOS

    Kode error Domain Alasan
    1-10 Dikirim oleh LY Jaringan Iklan SDK SDK Jaringan Iklan LY menampilkan error khusus SDK. Lihat dokumentasi Jaringan Iklan LY 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 sesuai dengan ukuran iklan banner yang didukung LY Jaringan Iklan.
    103 com.google.ads.mediation.line Gagal memuat aset gambar ikon informasi di iklan native.
    104 com.google.ads.mediation.line Gagal mengumpulkan sinyal untuk bidding.
    105 com.google.ads.mediation.line Gagal melakukan inisialisasi loader SDK iklan LINE Ads.

    Log Perubahan Adaptor Mediasi Flutter LINE

    Versi 2.2.2 (Dalam proses)

    • Kini memerlukan iOS versi minimum 15.0.

    Versi 2.2.1

    Versi 2.2.0

    Versi 2.1.3

    Versi 2.1.2

    Versi 2.1.1

    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