Mengintegrasikan Jaringan Iklan LINE dengan mediasi

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

Antarmuka dasbor untuk LINE Ads Network menggunakan teks Jepang untuk label, tombol, dan deskripsinya. Screenshot dalam panduan ini belum diterjemahkan. Namun, dalam deskripsi dan petunjuk panduan ini, label dan tombol diterjemahkan dengan padanannya dalam bahasa Inggris di dalam tanda kurung.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk LINE Ads Network memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner
Interstisial
Reward
Native	^1

¹ Iklan native (untuk Bidding) masih dalam versi beta tertutup. Hubungi Account Manager Anda untuk meminta akses.

Persyaratan

• Target deployment iOS 12.0 atau yang lebih tinggi

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

• Google Mobile Ads SDK terbaru

• Selesaikan Panduan memulai mediasi

Langkah 1: Siapkan konfigurasi di UI LINE Ads Network

Daftar dan login ke akun LINE Ads Network Anda.

Menambahkan aplikasi baru

Klik 広告枠管理 (Pengelolaan Slot Iklan) > メディア (Media). Kemudian, klik 新規作成 (Buat Baru).

Isi formulir, lalu klik 登録 (Daftar).

Catat ID Aplikasi.

Membuat penempatan iklan

Klik ID aplikasi yang ingin Anda tambahi penempatan iklan. Kemudian, pilih 詳細 (Detail).

Klik スロット 追加 (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 登録 (Daftar) setelah formulir diisi.

Catatan: フォーマット (Format) dan Bidding Type (Jenis Bidding) tidak dapat diubah setelah mendaftarkan slot. Hubungi account manager LINE Ads Network Anda untuk mendapatkan akses guna membuat penempatan iklan native di UI LINE Ads Network.

Catat ID Slot.

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 yang signifikan pada pendapatan iklan, 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 LINE Ads Network, lihat Tentang app-ads.txt.

Langkah 2: Siapkan permintaan LINE Ads Network di UI Ad Manager

Login ke akun Ad Manager Anda.

Menambahkan LINE Ads Network di Perusahaan

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Air Terjun

Buka Admin > Perusahaan, lalu klik tombol Perusahaan baru di tab Semua perusahaan. Pilih Jaringan iklan.

Pilih LINE Ads Network sebagai Jaringan iklan, masukkan Nama unik, lalu aktifkan Mediasi. Aktifkan Pengumpulan data otomatis, lalu masukkan Nama login dan Sandi yang diperoleh di bagian sebelumnya.

Anda tidak perlu memasukkan Nama Pengguna atau Sandi. Klik Simpan setelah selesai.

Mengaktifkan berbagi sinyal aman

Bidding

Buka Admin > Setelan global. Buka tab Setelan akun Ad Exchange, lalu tinjau dan aktifkan Berbagi sinyal aman. Klik Simpan.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Membagikan sinyal aman pada permintaan bid

Bidding

Buka Inventaris > Sinyal Aman. Di bagian Sinyal aman, cari LINE dan aktifkan Aktifkan integrasi aplikasi.

Klik Simpan.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Mengizinkan berbagi sinyal aman untuk Bidding dengan SDK

Bidding

Buka Penayangan > Setelan saluran permintaan. Di tab Setelan default, aktifkan Izinkan berbagi sinyal aman untuk Bidding SDK.

Klik Simpan.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Mengonfigurasi bidding LINE Ads Network

Bidding

Buka Penayangan > Bidder, lalu klik Buka Bidding dengan SDK.

Klik Bidder baru.

Pilih LINE Ads Network sebagai bidder.

Klik Lanjutkan untuk mengaktifkan Bidding dengan SDK untuk bidder ini.

Klik Selesai.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Mengonfigurasi pemetaan unit iklan

Bidding

Buka Penayangan > Bidder, lalu klik Buka Bidding dengan SDK.

Pilih perusahaan untuk LINE Ads Network.

Buka tab Pemetaan unit iklan, lalu klik Pemetaan unit iklan baru.

Pilih Unit iklan tertentu. Pilih unit iklan dan format, Aplikasi seluler sebagai Jenis inventaris, dan Aplikasi seluler Anda. Kemudian, masukkan ID Aplikasi dan ID Slot yang diperoleh di bagian sebelumnya. Terakhir, klik Simpan.

Penting: Targetkan unit iklan yang dipilih oleh setidaknya satu grup hasil, dan ID Aplikasi harus dikaitkan dengan aplikasi yang ditargetkan seperti di UI Jaringan Iklan LINE.

Air Terjun

Buka Penayangan > Grup hasil, lalu klik tombol Grup hasil baru. Pilih Aplikasi seluler Anda.

Scroll ke bawah, lalu klik Tambahkan partner hasil.

Pilih perusahaan yang Anda buat untuk LINE Ads Network di bagian sebelumnya. Pilih Mediasi SDK seluler sebagai Jenis integrasi, iOS sebagai Platform, dan Aktif sebagai Status.

Masukkan ID Aplikasi dan ID Slot yang diperoleh di bagian sebelumnya, dan nilai CPM Default. Klik Simpan.

Penting: ID Aplikasi harus dikaitkan dengan aplikasi target seperti di UI Jaringan Iklan LINE.

Catatan: Pengumpulan data otomatis membutuhkan waktu beberapa hari untuk mengumpulkan data sebelum dapat menghitung nilai CPM Dinamis untuk jaringan mediasi secara akurat. Setelah eCPM dapat dihitung, eCPM tersebut akan otomatis diperbarui atas nama Anda.

Langkah 3: Impor LINE Ads Network SDK dan Adaptor

Catatan: Kegagalan mengintegrasikan versi LINE Ads Network dan Google Mobile Ads SDK yang kompatibel dapat menyebabkan masalah build.

Menggunakan CocoaPods (direkomendasikan)

Tambahkan baris berikut ke Podfile project Anda:

pod 'GoogleMobileAdsMediationLine'

Dari command line, jalankan:

pod install --repo-update

Integrasi manual

• Download LINE Ads Network SDK versi terbaru dan tautkan FiveAd.framework di project Anda.
• Download versi terbaru adaptor LINE Ads Network dari link download di Log Perubahan dan tautkan LineAdapter.framework di project Anda.

Langkah 4: Tambahkan kode yang diperlukan

Integrasi SKAdNetwork

Ikuti dokumentasi LINE Ads Network untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.

Langkah 5: Uji penerapan Anda

Mengaktifkan iklan percobaan

Pastikan Anda mendaftarkan perangkat pengujian Anda untuk Ad Manager.

Penting: Nonaktifkan mode pengujian untuk Ad Manager dan LINE Ads Network sebelum merilis aplikasi Anda.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan percobaan dari LINE Ads Network, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan LINE Ads Network (Waterfall).

Langkah opsional

Parameter khusus jaringan

Adaptor LINE 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 iklan banner, interstisial, dan rewarded.

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

Swift

import LineAdapter
// ...

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

Objective-C

#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 LINE Ads Network mengisi kolom berikut untuk GADNativeAd.

Kolom	Aset yang selalu disertakan oleh adaptor LINE Ads Network
Judul
Gambar
Isi
Ikon aplikasi	^1
Pesan ajakan (CTA)
Rating bintang
Toko
Harga

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

Kode error

Jika adapter gagal menerima iklan dari LINE 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 LINE saat iklan gagal dimuat:

Kode error	Domain	Alasan
1-10	Dikirim oleh LINE Ads Network SDK	LINE Ads Network SDK menampilkan error khusus SDK. Lihat dokumentasi LINE 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 LINE Ads Network.
103	com.google.ads.mediation.line	Gagal memuat aset gambar ikon informasi di iklan native.

Log Perubahan Adaptor Mediasi LINE iOS

Versi 2.9.20250825.0 (Sedang dalam proses)

Versi 2.9.20250805.0 (Sedang dalam proses)

• Sekarang mencoba mendaftarkan FiveAd SDK sebelum setiap permintaan iklan.

Versi 2.9.20250512.0

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

Dibuat dan diuji dengan:

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

Versi 2.9.20241106.3

• Memperbaiki masalah saat GADMediationAdapterLine.h bukan header publik.
• Mengaktifkan tanda -fobjc-arc dan -fstack-protector-all.
• 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 disetel sebelum melakukan inisialisasi Google Mobile Ads SDK.
• Menghapus pemeriksaan status inisialisasi FiveAd SDK sebelum melakukan inisialisasi 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

• Memperbarui 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 yang 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

• Sekarang memerlukan versi iOS minimum 12.0.
• Sekarang memerlukan Google Mobile Ads SDK versi 11.0 atau yang lebih tinggi.
• Menyertakan Info.plist dalam framework di 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.
• FiveAd SDK versi 2.7.20240214.

Versi 2.7.20240126.0

• Kompatibilitas yang terverifikasi dengan FiveAd SDK versi 2.7.20240126.
• Memperbarui 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.