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

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
Bidding
Air Terjun  1
Format
Banner
Interstisial
Reward
Native
1 Integrasi waterfall masih dalam versi beta terbuka.

Persyaratan

  • Android API level 21 atau yang lebih tinggi

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 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 Jaringan Iklan LINE di UI Ad Manager

Login ke akun Ad Manager Anda.

Menambahkan Jaringan Iklan 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 Ads Network sebagai Jaringan iklan, masukkan Nama 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 LINE Ads Network

Bidding

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

Pilih LINE Ads Network 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 Jaringan Iklan 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 Ads Network 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 Jaringan Iklan LINE

Di file build.gradle.kts tingkat aplikasi, tambahkan dependensi dan konfigurasi penerapan berikut. Gunakan SDK dan adaptor LINE Ads Network versi terbaru:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:line:2.9.20241129.0")
}

Integrasi manual

  1. Download versi terbaru file .aar LINE Ads Network SDK dan tambahkan ke project Anda.

  2. Buka artefak adaptor LINE Ads Network di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor LINE Ads Network, lalu tambahkan ke project Anda.

Langkah 4: Tambahkan kode yang diperlukan

Tidak diperlukan kode tambahan untuk integrasi Jaringan Iklan LINE.

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

Kolom Aset yang selalu disertakan oleh adaptor LINE Ads Network
Judul
Gambar
Isi
Ikon aplikasi 1
Pesan ajakan (CTA)
Rating bintang
Toko
Harga

1 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 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 Ads Network saat iklan gagal dimuat:

Kode error Domain Alasan
1-10 com.five_corp.ad LINE Ads Network SDK menampilkan error khusus SDK. Lihat dokumentasi LINE Ads Network 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 Jaringan Iklan LINE.
104 com.google.ads.mediation.line Gagal memuat iklan interstisial atau reward karena konteks aktivitas tidak ada.
105 com.google.ads.mediation.line SDK Jaringan Iklan LINE gagal menampilkan iklan interstisial atau reward.
106 com.google.ads.mediation.line Gagal memuat iklan native karena aset tidak ada.

Log Perubahan LINE Android Mediation Adapter

Versi Berikutnya

  • Memperbaiki proses pengumpulan sinyal.

Versi 2.9.20241129.0

  • Menambahkan dukungan bidding untuk format iklan banner, interstisial, reward, dan native.
  • Memverifikasi kompatibilitas dengan FiveAd SDK versi 2.9.20241129.0

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 23.5.0.
  • FiveAd SDK versi 2.9.20241129.0

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.