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 Android .
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 |
1 Integrasi urutan iklan masih dalam versi beta tertutup. Hubungi Account Manager Anda untuk meminta akses.
Persyaratan
- Android API level 21 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
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
Login ke akun Ad Manager Anda.
Menambahkan Baris 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 yang unik, lalu aktifkan Mediasi.
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.
Mengonfigurasi bidding Baris
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 bagian 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 dan Slot ID yang diperoleh di bagian sebelumnya. Terakhir, klik Simpan.
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, Android sebagai Platform, dan Aktif sebagai Status.
Masukkan ID Aplikasi dan ID Slot yang diperoleh di bagian sebelumnya, dan nilai CPM Default. Klik Simpan.
Langkah 3: Impor SDK dan Adaptor Line
Integrasi Android Studio (direkomendasikan)
Di file build.gradle.kts
tingkat aplikasi, tambahkan dependensi dan konfigurasi
penerapan berikut. Gunakan SDK dan adaptor Line versi terbaru:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:line:2.8.20240827.0")
}
Integrasi manual
Download file
.aar
Line SDK versi terbaru dan tambahkan ke project Anda.Buka Artefak adaptor baris di Repositori Maven Google. Pilih versi terbaru, download file
.aar
adaptor Line, lalu tambahkan ke project Anda.
Langkah 4: Tambahkan kode yang diperlukan
Tidak diperlukan kode tambahan untuk integrasi Line.
Langkah 5: Uji penerapan Anda
Mengaktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.
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 LineExtras
. Konstruktor class ini mencakup
parameter berikut:
enableAdSound
boolean
untuk menentukan status awal suara default iklan banner, interstisial, dan reward.
Berikut adalah contoh kode cara membuat permintaan iklan yang menetapkan parameter ini:
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
.build()
Menggunakan iklan native
Rendering iklan
Adaptor Baris mengisi
kolom
berikut untuk
NativeAd
.
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
ResponseInfo.getAdapterResponses()
di bawah class berikut:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Line saat iklan gagal dimuat:
Kode error | Domain | Alasan |
---|---|---|
1-10 | com.five_corp.ad | Line SDK menampilkan error khusus SDK. Lihat dokumentasi Line untuk mengetahui detail selengkapnya. |
101 | com.google.ads.mediation.line | ID Aplikasi tidak ada atau tidak valid. |
102 | com.google.ads.mediation.line | ID Slot tidak ada atau tidak valid. |
103 | com.google.ads.mediation.line | Ukuran iklan yang diminta tidak cocok dengan ukuran iklan banner yang didukung Line. |
104 | com.google.ads.mediation.line | Gagal memuat iklan interstisial atau reward karena konteks aktivitas tidak ada. |
105 | com.google.ads.mediation.line | Line SDK gagal menampilkan iklan interstisial atau reward. |
106 | com.google.ads.mediation.line | Gagal memuat iklan native karena aset tidak ada. |
Log Perubahan Adaptor Mediasi Android LINE
Versi Berikutnya
- Mengimplementasikan AdLoader untuk mengaktifkan RTB untuk Iklan Banner.
- Menerapkan AdLoader untuk mengaktifkan RTB untuk Iklan Interstisial.
- Menerapkan AdLoader untuk mengaktifkan RTB untuk Iklan Reward.
- Mengimplementasikan AdLoader untuk mengaktifkan RTB untuk Iklan Native.
Versi 2.8.20240827.0
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.8.20240827.0
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 23.3.0.
- FiveAd SDK versi 2.8.20240827.0
Versi 2.8.20240808.0
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.8.20240808.0
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 23.2.0.
- FiveAd SDK versi 2.8.20240808.0
Versi 2.8.20240722.0
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.8.20240722.0
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 23.2.0.
- FiveAd SDK versi 2.8.20240722.0
Versi 2.7.20240515.0
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240515.0
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 23.1.0.
- FiveAd SDK versi 2.7.20240515.0
Versi 2.7.20240214.1
- Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 23.0.0.
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240214.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 23.0.0.
- FiveAd SDK versi 2.7.20240214.0.
Versi 2.7.20240214.0
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240214.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- FiveAd SDK versi 2.7.20240214.0.
Versi 2.7.20240126.0
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240126.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- FiveAd SDK versi 2.7.20240126.0.
Versi 2.7.20240112.0
- Menghapus
FiveAdViewEventListener
yang tidak digunakan lagi dan diganti denganFiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
, danFiveAdNativeEventListener
. - Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.7.20240112.
- Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 22.6.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.6.0.
- FiveAd SDK versi 2.7.20240112.
Versi 2.6.20230607.1
- Menambahkan class
LineExtras
bagi penayang untuk menentukan setelan suara default untuk format iklan banner, interstisial, dan reward. - Memperbarui versi minimum Google Mobile Ads SDK yang diperlukan menjadi 22.4.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.4.0.
- FiveAd SDK versi 2.6.20230607.
Versi 2.6.20230607.0
- Rilis awal.
- Menambahkan dukungan untuk format iklan banner, interstisial, reward, dan native.
- Kompatibilitas terverifikasi dengan FiveAd SDK versi 2.6.20230607.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 22.1.0.
- FiveAd SDK versi 2.6.20230607.