Mengintegrasikan Line dengan Mediasi (Beta)

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

Antarmuka dasbor untuk Line 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 padanan bahasa Inggrisnya dalam tanda kurung.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Line memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun	^1
Format
Banner
Interstisial
Reward
Native

¹ Integrasi urutan iklan masih dalam versi beta tertutup. Hubungi Account Manager Anda untuk meminta akses.

Persyaratan

• Target deployment iOS 12.0 atau yang lebih tinggi

• Google Mobile Ads SDK Terbaru

• Selesaikan Panduan memulai mediasi

Langkah 1: Siapkan konfigurasi di UI Line

Login ke akun Line Anda.

Menambahkan aplikasi baru

Klik 広告枠管理 (Ad Slot Management) > メディア (Media). Kemudian, klik 新規作成 (Create New).

Isi formulir dan klik 登録 (Daftar).

Catat ID Aplikasi.

Membuat penempatan iklan

Ikuti langkah-langkah yang sama untuk membuat penempatan iklan bagi integrasi bidding dan waterfall. Setiap penempatan iklan dapat digunakan untuk keduanya.

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

Klik スロット 追加 (Tambahkan Slot).

Isi formulir dan setelah selesai, klik (登録) Daftar.

Catatan: Hubungi Account Manager Jaringan Iklan Line Anda untuk mendapatkan akses guna membuat penempatan iklan native di UI Line.

Catat ID Slot.

Langkah 2: Siapkan permintaan Jalur di Ad Manager UI

Login ke akun Ad Manager Anda.

Menambahkan Line 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 sebagai Jaringan iklan, masukkan Nama unik, lalu aktifkan Mediasi.

Anda tidak perlu memasukkan Nama Pengguna atau Sandi. Klik Simpan jika 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.

Mengonfigurasi Line bidding

Bidding

Buka Penayangan > Bidder, lalu klik Bidder baru di bagian tab Bidding dengan SDK.

Pilih Line sebagai bidder.

Aktifkan Tambahkan library sinyal bidder ini ke daftar sinyal yang diizinkan dan Izinkan sinyal dibagikan kepada bidder ini. Kemudian, klik Lanjutkan.

Klik Lanjutkan.

Klik Selesai.

Air Terjun

Langkah ini tidak diperlukan untuk integrasi waterfall.

Mengonfigurasi pemetaan unit iklan

Bidding

Buka Penayangan > Bidder, lalu pilih perusahaan untuk Line di tab Bidding dengan SDK.

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

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

Penting: Targetkan unit iklan yang dipilih dengan minimal satu grup hasil, dan Application ID harus dikaitkan dengan aplikasi yang ditargetkan seperti di UILine .

Air Terjun

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

Scroll ke bawah, lalu klik Tambahkan partner hasil.

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

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

Penting: Application ID harus dikaitkan dengan aplikasi yang ditargetkan seperti dalam UILine .

Langkah 3: Impor SDK dan Adaptor Line

Catatan: Kegagalan untuk mengintegrasikan versi Line 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 SDK versi terbaru dan tautkan FiveAd.framework dalam project Anda.
• Download adaptor Line versi terbaru dari link download di Changelog dan tautkan LineAdapter.framework dalam project Anda.

Langkah 4: Tambahkan kode yang diperlukan

Integrasi SKAdNetwork

Ikuti dokumentasi Line 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.

Ikuti petunjuk dalam dokumentasi Line tentang cara mengaktifkan iklan pengujian Line.

Penting: Nonaktifkan mode pengujian untuk Ad Manager dan Line sebelum merilis aplikasi.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Line, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Line (Waterfall).

Langkah opsional

Parameter khusus jaringan

Adaptor Line mendukung parameter permintaan tambahan yang dapat diteruskan ke adaptor menggunakan class GADMediationAdapterLineExtras. Class ini menyertakan 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:

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 Baris mengisi kolom berikut untuk GADNativeAd.

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

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

Kode error

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

Kode error	Domain	Alasan
1-10	Dikirim oleh Line SDK	Line SDK menampilkan error khusus SDK. Lihat dokumentasi Line 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 cocok dengan ukuran iklan banner yang didukung Line.
103	com.google.ads.mediation.line	Gagal memuat aset gambar ikon informasi di iklan native.

Log Perubahan Adaptor Mediasi LINE iOS

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.
• FiveAd SDK versi 2.7.20240214.

Versi 2.7.20240126.0

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