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 bahasa 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 |
1 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 guna membuat penempatan iklan untuk 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.
Catat ID Slot.
Langkah 2: Siapkan permintaan Jalur di Ad Manager UI
Langkah 3: Impor SDK dan Adaptor 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 SDK versi terbaru dan tautkan
FiveAd.framework
dalam project Anda. - Download adaptor Line versi terbaru dari link download di
Changelog dan tautkan
LineAdapter.framework
di 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 AdMob.
Ikuti petunjuk dalam dokumentasi Line tentang cara mengaktifkan iklan pengujian Line.
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 yang selalu disertakan oleh adaptor Baris |
---|---|
Judul | |
Gambar | |
Isi | |
Ikon aplikasi | 1 |
Pesan ajakan (CTA) | |
Rating bintang | |
Toko | |
Harga |
1 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 Baris. |
103 | com.google.ads.mediation.line | Gagal memuat aset gambar ikon informasi di iklan native. |
Log Perubahan Adaptor Mediasi LINE iOS
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.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.5.0.
- FiveAd SDK versi 2.8.20240612.
Versi 2.7.20240411.0
- Kompatibilitas yang diverifikasi dengan FiveAd SDK versi 2.7.20240411.
Dibangun 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 dalamLineAdapter.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.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.0.1.
- FiveAd SDK versi 2.7.20240214.
Versi 2.7.20240126.0
- Kompatibilitas yang diverifikasi 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 modulmap.
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.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.9.0.
- FiveAd SDK versi 2.6.20230609.