Mengintegrasikan LY Ads Network dengan mediasi

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Jaringan Iklan LY menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan Jaringan Iklan LY ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor Jaringan Iklan LY ke aplikasi iOS.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Jaringan Iklan LY memiliki kemampuan berikut:

Prasyarat

Sebelum melanjutkan, verifikasi hal berikut:

• Target deployment iOS 13.0 atau yang lebih baru.

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

• Versi Google Mobile Ads SDK terbaru.

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

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

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

Aktifkan 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 LY Ads Network SDK dan Adapter

Menggunakan Swift Package Manager

Sebelum melanjutkan, Anda harus memiliki versi adaptor minimum yang didukung, yaitu 2.9.20251119.

Untuk menambahkan dependensi paket ke project Anda, ikuti langkah-langkah berikut:

1. Di Xcode, buka File > Add Package Dependencies....

2. Pada dialog yang muncul, telusuri URL paket berikut:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. Di Dependency Rule, pilih Branch.

4. Di kolom teks, masukkan main.

Menggunakan CocoaPods

Tambahkan baris berikut ke Podfile project Anda:

pod 'GoogleMobileAdsMediationLine'

Dari command line, jalankan:

pod install --repo-update

Integrasi manual

• Download LY Jaringan Iklan SDK versi terbaru dan tautkan FiveAd.framework di project Anda.
• Download adaptor Jaringan Iklan LY versi terbaru dari link download di Changelog dan tautkan LineAdapter.framework di project Anda.

Langkah 4: Tambahkan kode yang diperlukan

Menerapkan 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 untuk Ad Manager.

Adaptor Jaringan Iklan LY berisi metode bantuan untuk mengaktifkan mode pengujian untuk Jaringan Iklan LY. Anda harus menyetel opsi ini sebelum melakukan inisialisasi Google Mobile Ads SDK untuk memastikan opsi tersebut diteruskan dengan benar ke SDK Jaringan Iklan LY.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

Memverifikasi iklan pengujian

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 GADMediationAdapterLineExtras. Class ini mencakup properti berikut:

adAudio

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

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

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Menggunakan iklan native

Rendering iklan

Adaptor jaringan iklan LY Ads mengisi kolom berikut untuk GADNativeAd.

¹ Untuk iklan native, LY Ads Network SDK tidak menyediakan aset ikon aplikasi. Sebagai gantinya, adaptor Jaringan Iklan LY akan 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 GADResponseInfo.adNetworkInfoArray di bawah class berikut:

GADMediationAdapterLine

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

Log Perubahan Adapter Mediasi LINE iOS

Versi 3.1.1.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 3.1.1.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 13.9.0.
• FiveAd SDK versi 3.1.1.

Versi 3.1.0.0

• Sekarang memerlukan versi iOS minimum 15.0.
• Kompatibilitas terverifikasi dengan FiveAd SDK versi 3.1.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 13.8.0.
• FiveAd SDK versi 3.1.0.

Versi 3.0.1.2

• Perbarui versi iOS minimum untuk mengurangi dependensi Google Mobile Ads SDK agar memungkinkan versi kecil.
• Memperbaiki masalah saat ikon AdChoices untuk iklan native terlalu besar.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 13.4.0.
• FiveAd SDK versi 3.0.1.

Versi 3.0.1.1

• Adaptor kini meneruskan flag ageRestrictedTreatment Google Mobile Ads SDK ke COPPA API FiveAd SDK.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 13.3.0.
• SDK FiveAd versi 3.0.1.

Versi 3.0.1.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 3.0.1.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 13.1.0.
• FiveAd SDK versi 3.0.1.

Versi 3.0.0.1

• Memperbarui dependensi Google Mobile Ads SDK ke versi 13.0.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 13.0.0.
• FiveAd SDK versi 3.0.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 12.14.0.
• FiveAd SDK versi 3.0.0.

Versi 2.9.20251119.1

• Menambahkan dukungan untuk meneruskan parameter tagForUnderAgeOfConsent Google Mobile Ads SDK ke FiveAd SDK.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 12.14.0.
• FiveAd SDK versi 2.9.20251119.

Versi 2.9.20251119.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.9.20251119.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 12.14.0.
• FiveAd SDK versi 2.9.20251119.

Versi 2.9.20250930.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.9.20250930.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 12.12.0.
• SDK FiveAd versi 2.9.20250930.

Versi 2.9.20250912.0

• Adaptor kini melakukan inisialisasi FiveAd SDK sebelum setiap panggilan iklan.
• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.9.20250912.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 12.11.0.
• FiveAd SDK versi 2.9.20250912.

Versi 2.9.20250512.0

• Sekarang memerlukan versi iOS minimum 13.0.
• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.9.20250512.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 12.4.0.
• FiveAd SDK versi 2.9.20250512.

Versi 2.9.20241106.3

• Memperbaiki masalah saat GADMediationAdapterLine.h bukan header publik.
• Flag -fobjc-arc dan -fstack-protector-all diaktifkan.
• Menghapus verifikasi ukuran iklan banner untuk bidding setelah berhasil dimuat.
  • Iklan banner waterfall akan terus memeriksa ukuran iklan banner setelah berhasil dimuat.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 12.2.0.
• FiveAd SDK versi 2.9.20241106.

Versi 2.9.20241106.2

• Menambahkan properti GADMediationAdapterLine.testMode untuk menunjukkan apakah FiveAd SDK harus diinisialisasi dalam mode pengujian. Flag ini harus ditetapkan sebelum melakukan inisialisasi Google Mobile Ads SDK.
• Menghapus pemeriksaan status inisialisasi FiveAd SDK sebelum menginisialisasi FiveAd SDK.
• Menghapus pemeriksaan status iklan native yang tidak digunakan lagi sebelum mendownload aset iklan native.
• Sekarang memerlukan Google Mobile Ads SDK versi 12.0.0 atau yang lebih tinggi.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 12.0.0.
• FiveAd SDK versi 2.9.20241106.

Versi 2.9.20241106.1

• Mengupdate adaptor untuk menggunakan API pemuatan iklan terbaru untuk iklan banner bidding.
• Memperbaiki masalah yang mencegah peristiwa iklan diteruskan dengan benar untuk iklan interstisial bidding.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.12.0.
• FiveAd SDK versi 2.9.20241106.

Versi 2.9.20241106.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.9.20241106.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.12.0.
• FiveAd SDK versi 2.9.20241106.

Versi 2.8.20240827.1

• Memperbarui CFBundleShortVersionString agar memiliki tiga komponen, bukan empat.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.10.0.
• FiveAd SDK versi 2.8.20240827.

Versi 2.8.20240827.0

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

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.8.0.
• FiveAd SDK versi 2.8.20240827.

Versi 2.8.20240612.0

• Menambahkan kontrol audio untuk iklan native melalui GADVideoOptions.
• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.8.20240612.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.5.0.
• FiveAd SDK versi 2.8.20240612.

Versi 2.7.20240411.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240411.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.3.0.
• FiveAd SDK versi 2.7.20240411.

Versi 2.7.20240318.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240318.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.2.0.
• FiveAd SDK versi 2.7.20240318.

Versi 2.7.20240214.1

• Kini memerlukan iOS versi minimum 12.0.
• Sekarang memerlukan Google Mobile Ads SDK versi 11.0 atau yang lebih tinggi.
• Menyertakan Info.plist dalam framework dalam LineAdapter.xcframework.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.0.1.
• FiveAd SDK versi 2.7.20240214.

Versi 2.7.20240214.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240214.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 11.0.1.
• SDK FiveAd versi 2.7.20240214.

Versi 2.7.20240126.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240126.
• Mengupdate implementasi adaptor dengan protokol delegasi baru FiveAd SDK.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 10.14.0.
• FiveAd SDK versi 2.7.20240126.

Versi 2.7.20231115.0

• Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20231115.
• Menyertakan header GADMediationAdapterLineExtras dalam modulemap.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 10.14.0.
• FiveAd SDK versi 2.7.20231115.

Versi 2.6.20230609.1

• Menambahkan GADMediationAdapterLineAudioState untuk mengelola status audio awal iklan banner, interstisial, dan reward saat pertama kali ditampilkan.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 10.14.0.
• FiveAd SDK versi 2.6.20230609.

Versi 2.6.20230609.0

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

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 10.9.0.
• FiveAd SDK versi 2.6.20230609.