Mengintegrasikan LY dengan mediasi

Pilih platform: Android iOS Unity Flutter Android (Lama)

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

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Jaringan Iklan LY memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner
Interstisial
Reward
Native

Prasyarat

Sebelum melanjutkan, verifikasi hal berikut:

• Android API level 24 atau yang lebih baru.

• [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan adaptor jaringan iklan LY Ads 2.9.20241129.0 atau yang lebih baru (versi terbaru direkomendasikan).

• Versi GMA Next-Gen SDK terbaru.

• Siapkan Mediasi AdMob.

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.

Isi formulir dan klik pendaftaran.

Catat ID Aplikasi.

Membuat slot iklan

Di tab Aplikasi, pilih aplikasi Anda untuk melihat detailnya. Di bagian Slot, klik Add.

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 Create setelah formulir diisi.

Catatan: Format iklan dan Jenis Bidding tidak dapat diubah setelah mendaftarkan slot. Hubungi Account Manager LY Ads Network Anda untuk mendapatkan akses guna membuat penempatan iklan native di UI LY Ads Network.

Catat ID Slot.

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

Membuat Kunci API Pelaporan

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

Isi formulir lalu klik Simpan.

Catat ID Kunci API dan Rahasia Kunci API Anda.

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, siapkan file app-ads.txt untuk aplikasi Anda.

Untuk menerapkan app-ads.txt untuk LY Ads Network, lihat Tentang app-ads.txt.

Langkah 2: Siapkan permintaan jaringan iklan LY di UI AdMob

Mengonfigurasi setelan mediasi untuk unit iklan Anda

Anda harus menambahkan LY Ads Network ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan LY Ads Network sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Aktif, lalu klik Tambahkan Unit Iklan.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Done.

Sekarang Anda akan melihat kartu unit iklan diisi dengan unit iklan yang Anda pilih:

Menambahkan LY Ads Network sebagai jaringan iklan

Bidding

Di bagian Sumber Iklan, temukan kartu Bidding, lalu pilih Tambahkan sumber iklan. Lalu, pilih LY Ads Network .

Klik Cara menandatangani perjanjian kemitraan dan siapkan kemitraan bidding dengan LY Ads Network.



Klik Konfirmasi & setuju, lalu klik Lanjutkan.



Jika sudah memiliki pemetaan untuk Jaringan Iklan LY, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan ID Aplikasi dan ID Slot yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Penting: ID Aplikasi harus dikaitkan dengan aplikasi yang ditargetkan seperti di UI Jaringan Iklan LY.

Air Terjun

Di bagian kartu Waterfall di bagian Ad Sources, pilih Add Ad Source.

Pilih LY Ads Network dan aktifkan tombol Optimize. Masukkan ID Kunci API dan Secret Kunci API yang diperoleh di bagian sebelumnya untuk menyiapkan pengoptimalan sumber iklan untuk Jaringan Iklan LY. Kemudian, masukkan nilai eCPM untuk LY Ads Network, lalu klik Lanjutkan.

Catatan: Anda hanya perlu menyiapkan pengoptimalan sumber iklan satu kali per jaringan.

Jika sudah memiliki pemetaan untuk LY Ads Network, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan ID Aplikasi dan ID Slot yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Penting: ID Aplikasi harus dikaitkan dengan aplikasi yang ditargetkan seperti di UI Jaringan Iklan LY.

Catatan: Pengoptimalan sumber iklan memerlukan waktu beberapa hari untuk mengumpulkan data yang cukup guna menghitung eCPM secara akurat untuk jaringan mediasi. Sementara itu, status pengoptimalan sumber iklan adalah PENDING, jadi Anda harus menetapkan nilai eCPM secara manual untuk jaringan. Setelah eCPM dapat dihitung, sumber iklan akan otomatis mulai memperbarui eCPM atas nama Anda.

Langkah 3: Impor SDK dan Adaptor Jaringan Iklan LY

Catatan: Kegagalan dalam mengintegrasikan versi LY Ads Network dan GMA Next-Gen SDK yang kompatibel dapat menyebabkan masalah build.

Integrasi Android Studio (direkomendasikan)

Di file gradle level aplikasi, tambahkan dependensi dan konfigurasi implementasi berikut:

Kotlin

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

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

Groovy

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

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 LY jaringan iklan SDK versi terbaru dan tambahkan ke project Anda.

2. Buka artefak adaptor jaringan iklan LY di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor LY jaringan iklan, lalu tambahkan ke project Anda.

Langkah 4: Tambahkan kode yang diperlukan

Tidak diperlukan kode tambahan untuk integrasi Jaringan Iklan LY.

Langkah 5: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.

Adaptor Jaringan Iklan LY berisi metode bantuan untuk mengaktifkan mode pengujian untuk Jaringan Iklan LY. Anda harus menetapkan opsi ini sebelum melakukan inisialisasi GMA Next-Gen SDK untuk memastikan opsi tersebut diteruskan dengan benar ke SDK Jaringan Iklan LY.

Java

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

Kotlin

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Penting: Nonaktifkan mode pengujian untuk AdMob dan Jaringan Iklan LY sebelum merilis aplikasi Anda.

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

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

enableAdSound

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

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

Java

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

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

Kotlin

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 jaringan iklan LY Ads mengisi Deskripsi kolom iklan native advanced berikut untuk NativeAd.

Kolom	Aset yang selalu disertakan oleh adaptor jaringan iklan LY
Judul
Gambar
Isi
Ikon aplikasi	^1
Pesan ajakan (CTA)
Rating bintang
Toko
Harga

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

Kode error

Jika adaptor gagal menerima iklan dari Jaringan Iklan LY, 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 Jaringan Iklan LY saat iklan gagal dimuat:

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	FiveAd SDK menampilkan pemuat iklan null.

Log Perubahan Adaptor Mediasi Android LINE

Versi 3.1.1.2

• Sematkan dependensi Kotlin adaptor ke 1.9.0 (versi Kotlin minimum yang didukung oleh GMA NextGen SDK).

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.4.0.
• Google Mobile Ads Next-Gen SDK versi 1.4.0.
• FiveAd SDK versi 3.1.1.1.

Versi 3.1.1.1

• Memetakan AgeRestrictedTreatment ke ChildDirectedTreatment API Line.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.4.0.
• Google Mobile Ads Next-Gen SDK versi 1.2.1.
• FiveAd SDK versi 3.1.1.1.

Versi 3.1.1.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 3.1.1.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.2.0.
• Google Mobile Ads Next-Gen SDK versi 1.2.1.
• FiveAd SDK versi 3.1.1.0.

Versi 3.1.0.0

• Menambahkan properti untuk mem-build adaptor dengan dependensi GMA Next-Gen SDK.
• Kompatibilitas 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.
• FiveAd SDK versi 3.0.1.2.

Versi 3.0.1.1

• Tayangan iklan native kini ditimpa 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 terverifikasi dengan FiveAd SDK versi 3.0.1.0.

Dibuat dan diuji dengan:

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

Versi 3.0.0.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 3.0.0.0.

Dibuat dan diuji dengan:

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

Versi 2.9.20251028.0

• Kompatibilitas 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 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 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 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

• Mengupdate API level Android minimum yang diperlukan menjadi 23.
• Mengupdate 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 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 ke 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 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 bagi penayang untuk 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.