Mengintegrasikan Jaringan Iklan LINE dengan mediasi (Beta)

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari LINE Ads Network menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan Jaringan Iklan LINE ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor Jaringan Iklan LINE ke dalam aplikasi Unity.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Jaringan Iklan LINE memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun  1
Format
Banner
Interstisial
Reward

1 Integrasi waterfall masih dalam uji beta tertutup. Hubungi Account Manager Anda untuk meminta akses.

Persyaratan

  • Unity 4 atau yang lebih tinggi
  • Google Mobile Ads SDK Terbaru
  • Untuk men-deploy di Android
    • Android API level 21 atau yang lebih tinggi
  • Untuk men-deploy di iOS
    • Target deployment iOS 12.0 atau yang lebih tinggi
  • Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
  • Selesaikan Panduan memulai mediasi

Langkah 1: Siapkan konfigurasi di UI 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

Mengonfigurasi setelan mediasi untuk unit iklan

Android

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.

iOS

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.

Langkah 3: Impor SDK dan adaptor Jaringan Iklan LINE

OpenUPM-CLI

Jika telah menginstal OpenUPM-CLI, Anda dapat menginstal Plugin Mediasi Jaringan Iklan LINE Google Mobile Ads untuk Unity ke project dengan menjalankan perintah berikut dari direktori root project:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

Di editor project Unity, pilih Edit > Project Settings > Package Manager untuk membuka Unity Package Manager Settings.

Di tab Scoped Registries, tambahkan OpenUPM sebagai registry terbatas dengan detail berikut:

  • Nama: OpenUPM
  • URL: https://package.openupm.com
  • Cakupan: com.google

Detail OpenUPM

Kemudian, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.

Registry Unity

Pilih paket Google Mobile Ads LINE Ads Network Mediation dan klik Install.

Menginstal dari OpenUPM

Paket Unity

Download plugin mediasi Google Mobile Ads versi terbaru untuk Jaringan Iklan LINE dari link download di Log Perubahan dan ekstrak GoogleMobileAdsLineMediation.unitypackage dari file zip.

Di editor project Unity, pilih Assets > Import Package > Custom Package, lalu temukan file GoogleMobileAdsLineMediation.unitypackage yang telah Anda download. Pastikan semua file telah dipilih, lalu klik Import.

Mengimpor dari Unity

Kemudian, pilih Assets > External Dependency Manager > Android Resolver > Force Resolve. Library External Dependency Manager akan melakukan resolusi dependensi dari awal dan menyalin dependensi yang dideklarasikan ke direktori Assets/Plugins/Android aplikasi Unity Anda.

Paksa Selesaikan

Langkah 4: Tambahkan kode yang diperlukan

Android

Tidak diperlukan kode tambahan untuk integrasi Jaringan Iklan LINE.

iOS

Integrasi SKAdNetwork

Ikuti dokumentasi Jaringan Iklan 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.

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

Plugin mediasi Unity Jaringan Iklan LINE mendukung parameter permintaan tambahan berikut yang dapat diteruskan ke adaptor melalui class LineMediationExtras:

  • SetEnableAdSound(boolean): Menentukan status awal suara default banner, interstisial, dan iklan reward.

Berikut adalah contoh kode cara membuat permintaan iklan yang menetapkan parameter ini:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

Kode error

Jika adaptor gagal menerima iklan dari Jaringan Iklan LINE, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bagian class berikut:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

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

Android

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.

iOS

Kode error Domain Alasan
1-10 Dikirim oleh LINE Ads Network SDK LINE Ads Network SDK menampilkan error khusus SDK. Lihat dokumentasi LINE Ads Network 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 Jaringan Iklan LINE.
103 com.google.ads.mediation.line Gagal memuat aset gambar ikon informasi di iklan native.

Log Perubahan Plugin Mediasi Unity Line

Versi 1.4.0

Versi 1.3.1

Versi 1.3.0

Versi 1.2.0

Versi 1.1.2

Versi 1.1.1

Versi 1.1.0

Versi 1.0.0