Mengintegrasikan LY Ads Network dengan mediasi

Pilih platform: Android Android iOS Unity Flutter

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari LY Ads Network menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini mencakup cara menambahkan LY Ads Network ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor LY Ads Network ke dalam aplikasi Android.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk LY Ads Network memiliki kemampuan berikut:

Persyaratan

• Level API Android 24 atau yang lebih tinggi

• [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan Adaptor LY Ads Network 2.9.20241129.0 atau yang lebih tinggi (sebaiknya gunakan versi terbaru)

• GMA Next-Gen SDK Terbaru

• Selesaikan Panduan memulai 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.

Isi formulir dan klik pendaftaran.

Catat ID Aplikasi.

Membuat slot iklan

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

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.

Catat ID 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.

Membuat Kunci API Pelaporan

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

Isi formulir lalu klik Simpan.

Catat ID Kunci API dan Rahasia Kunci API 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 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

Login ke akun Ad Manager Anda.

Menambahkan LY Ads Network di Perusahaan

Mengaktifkan berbagi sinyal aman

Membagikan sinyal aman pada permintaan bid

Mengizinkan berbagi sinyal aman untuk Bidding dengan SDK

Mengonfigurasi bidding LY Ads Network

Mengonfigurasi pemetaan unit iklan

Langkah 3: Impor SDK dan Adaptor Jaringan Iklan LY

Integrasi Android Studio (direkomendasikan)

Dalam file gradle level aplikasi, tambahkan implementasi dependencies dan konfigurasi berikut:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
    implementation("com.google.ads.mediation:line:3.1.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrasi manual

1. Download file .aar SDK LY Ads Networkversi terbaru dan tambahkan ke project Anda.

2. Buka artefak adaptor LY Ads Network di Repositori Maven Google. Pilih versi terbaru, download file .aar adapter Jaringan Iklan LY, lalu tambahkan ke project Anda.

Langkah 4: Tambahkan kode yang diperlukan

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

Langkah 5: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian Anda untuk Ad Manager.

Adaptor LY Ads Network berisi metode helper untuk mengaktifkan mode pengujian bagi LY Ads Network. Anda harus menyetel opsi ini sebelum menginisialisasi GMA Next-Gen SDK untuk memastikan opsi tersebut diteruskan dengan benar ke LY Ads Network SDK.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

Adaptor LY Ads Network mendukung parameter permintaan tambahan yang dapat diteruskan ke adaptor menggunakan class LineExtras. Konstruktor kelas ini mencakup parameter berikut:

enableAdSound

A boolean untuk menentukan status mulai suara default iklan banner, interstisial, dan reward.

Berikut adalah contoh kode cara membuat permintaan iklan yang menetapkan parameter ini:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

Menggunakan iklan native

Rendering iklan

Adaptor LY Ads Network mengisi kolom berikut untuk NativeAd.

¹ Untuk iklan native, LY Ads Network SDK tidak menyediakan aset ikon aplikasi. Sebagai gantinya, adaptor Jaringan Iklan LY mengisi ikon aplikasi dengan gambar transparan.

Kode error

Jika adaptor gagal menerima iklan dari LY Ads Network, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di bawah class berikut:

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

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

Log Perubahan Adaptor Mediasi Android LINE

Versi Berikutnya

• Memetakan AgeRestrictedTreatment ke ChildDirectedTreatment API Line.

Versi 3.1.1.0 (Dalam proses)

Versi 3.1.0.0

• Menambahkan properti untuk membuat adaptor dengan dependensi GMA Next-Gen SDK.
• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 3.1.0.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.1.0.
• Google Mobile Ads Next-Gen SDK versi 0.25.0-beta01.
• FiveAd SDK versi 3.1.0.0.

Versi 3.0.1.2

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.1.0.
• SDK FiveAd versi 3.0.1.2.

Versi 3.0.1.1

• Tayangan iklan native kini digantikan oleh FiveAd SDK saat menggunakan Google Mobile Ads SDK v24.4.0 atau yang lebih baru.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.9.0.
• FiveAd SDK versi 3.0.1.1.

Versi 3.0.1.0

• Menambahkan dukungan untuk meneruskan parameter tagForUnderAgeOfConsent Google Mobile Ads SDK ke FiveAd SDK.
• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 3.0.1.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.9.0.
• SDK FiveAd versi 3.0.1.0.

Versi 3.0.0.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 3.0.0.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.9.0.
• SDK FiveAd versi 3.0.0.0.

Versi 2.9.20251028.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.9.20251028.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.7.0.
• FiveAd SDK versi 2.9.20251028.0

Versi 2.9.20250924.1

• Menghapus referensi tingkat class ke Context. Dapat membantu mengurangi masalah kebocoran memori.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.7.0.
• FiveAd SDK versi 2.9.20250924.1.

Versi 2.9.20250924.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.9.20250924.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.6.0.
• FiveAd SDK versi 2.9.20250924.0

Versi 2.9.20250718.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.9.20250718.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.3.0.
• FiveAd SDK versi 2.9.20250718.0.

Versi 2.9.20250519.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.9.20250519.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.3.0.
• FiveAd SDK versi 2.9.20250519.0.

Versi 2.9.20250317.1

• Memperbaiki dimensi pemuatan banner untuk iklan bidding dengan FiveAd API baru

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.1.0.
• FiveAd SDK versi 2.9.20250317.0

Versi 2.9.20250317.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.9.20250317.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.1.0.
• FiveAd SDK versi 2.9.20250317.0

Versi 2.9.20250110.1

• Memperbarui level API Android minimum yang diperlukan menjadi 23.
• Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 24.0.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.0.0.
• FiveAd SDK versi 2.9.20250110.0

Versi 2.9.20250110.0

• Menghapus class UnifiedNativeAdMapper yang tidak digunakan lagi dan menggantinya dengan NativeAdMapper
• Memperbaiki proses pengumpulan sinyal.
• Memperbaiki proses inisialisasi untuk format iklan interstisial dan reward waterfall.
• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.9.20250110.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 23.6.0.
• FiveAd SDK versi 2.9.20250110.0

Versi 2.9.20241129.0

• Menambahkan dukungan bidding untuk format iklan banner, interstisial, reward, dan native.
• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.9.20241129.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 23.5.0.
• FiveAd SDK versi 2.9.20241129.0

Versi 2.8.20240827.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.8.20240827.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 23.3.0.
• FiveAd SDK versi 2.8.20240827.0

Versi 2.8.20240808.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.8.20240808.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 23.2.0.
• FiveAd SDK versi 2.8.20240808.0

Versi 2.8.20240722.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.8.20240722.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 23.2.0.
• FiveAd SDK versi 2.8.20240722.0

Versi 2.7.20240515.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240515.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 23.1.0.
• FiveAd SDK versi 2.7.20240515.0

Versi 2.7.20240214.1

• Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 23.0.0.
• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240214.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 23.0.0.
• FiveAd SDK versi 2.7.20240214.0.

Versi 2.7.20240214.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240214.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 22.6.0.
• FiveAd SDK versi 2.7.20240214.0.

Versi 2.7.20240126.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.7.20240126.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 22.6.0.
• FiveAd SDK versi 2.7.20240126.0.

Versi 2.7.20240112.0

• Menghapus FiveAdViewEventListener yang tidak digunakan lagi dan menggantinya dengan FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener, dan FiveAdNativeEventListener.
• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240112.
• Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 22.6.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 22.6.0.
• FiveAd SDK versi 2.7.20240112.

Versi 2.6.20230607.1

• Menambahkan class LineExtras agar penayang dapat menentukan setelan suara default untuk format iklan banner, interstisial, dan reward.
• Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 22.4.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 22.4.0.
• FiveAd SDK versi 2.6.20230607.

Versi 2.6.20230607.0

• Rilis awal.
• Menambahkan dukungan untuk format iklan banner, interstisial, reward, dan native.
• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.6.20230607.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 22.1.0.
• FiveAd SDK versi 2.6.20230607.