Mengintegrasikan Jaringan Iklan 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 Jaringan Iklan 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 Jaringan Iklan LINE memiliki kemampuan berikut:

² Integrasi waterfall masih dalam versi beta terbuka.

³ Format ini hanya didukung dalam integrasi waterfall.

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 Jaringan Iklan LINE

Login ke akun Jaringan Iklan LINE Anda.

Menambahkan aplikasi baru

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

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 dan setelah selesai, klik (登録) Daftar.

Catat ID Slot.

Langkah 2: Siapkan permintaan Jaringan Iklan LINE di UI Ad Manager

Login ke akun Ad Manager Anda.

Menambahkan Jaringan Iklan LINE di Perusahaan

Mengaktifkan berbagi sinyal aman

Membagikan sinyal aman pada permintaan bid

Mengizinkan berbagi sinyal aman untuk Bidding dengan SDK

Mengonfigurasi bidding LINE Ads Network

Mengonfigurasi pemetaan unit iklan

Langkah 3: Impor SDK dan Adaptor Jaringan Iklan LINE

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 dalam project Anda.
• Download adaptor Jaringan Iklan LINE versi terbaru dari link download di Changelog dan link 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 pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.

Memverifikasi iklan percobaan

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

Langkah opsional

Parameter khusus jaringan

Adaptor Jaringan Iklan LINE 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 LINE mengisi kolom berikut untuk GADNativeAd.

¹ 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 adaptor gagal menerima iklan dari Jaringan Iklan LINE, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan GADResponseInfo.adNetworkInfoArray di bagian class berikut:

GADMediationAdapterLine

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

Log Perubahan LINE iOS Mediation Adapter

Versi berikutnya

• Menghapus logika yang memeriksa apakah FAD SDK terdaftar dalam penyiapan adaptor.
• Memperbarui API "show" iklan interstisial dan reward dengan API "showWithViewController:" baru.
• Menghapus pemeriksaan status iklan native sebelum mendownload aset iklan native, karena tidak digunakan lagi dan tidak ada penggantinya.

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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build 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.

Di-build dan diuji dengan:

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