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 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

¹ 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.

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

Mengonfigurasi setelan mediasi untuk unit iklan

Login ke akun Ad Manager Anda.

Buka Penayangan > Grup hasil, lalu klik tombol Grup hasil baru.

Masukkan Nama unik untuk grup hasil Anda, tetapkan Status ke Aktif, pilih Format Iklan, dan tetapkan Jenis inventaris ke Aplikasi seluler. Di bagian Penargetan > Inventaris, pilih unit iklan di bagian Inventaris dan Aplikasi seluler yang ingin Anda tambahkan mediasi.

Selanjutnya, klik tombol Tambahkan partner hasil.

Jika sudah memiliki Partner hasil untuk Line, Anda dapat memilihnya. Jika tidak, pilih Buat partner hasil baru.

Pilih Line sebagai Jaringan iklan, masukkan Nama unik, lalu aktifkan Mediasi.

Setelah Partner hasil dipilih, pilih Mediasi SDK Seluler sebagai Jenis integrasi, Android sebagai Platform, dan Aktif sebagai Status. Masukkan Application ID and Slot ID yang diperoleh di bagian sebelumnya. Kemudian, masukkan nilai CPM Default.

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

Klik Simpan di bagian bawah halaman jika sudah selesai.

Langkah 3: Impor SDK dan Adaptor Line

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

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

1. Download file .aar Line SDK versi terbaru dan tambahkan ke project Anda.

2. 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 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 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 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 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 dengan FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener, dan FiveAdNativeEventListener.
• 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 untuk penayang guna 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.