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 dalam aplikasi Unity.
Integrasi dan format iklan yang didukung
Adaptor mediasi Ad Manager untuk 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 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
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 Line
Download plugin mediasi Google Mobile Ads versi terbaru untuk 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 dipilih, lalu klik
Import.
Kemudian, pilih Assets > Play Services Resolver > Android Resolver >
Force Resolve. Library Unity Play Services Resolver akan melakukan
resolusi dependensi dari awal dan menyalin dependensi yang dideklarasikan ke dalam
direktori Assets/Plugins/Android
aplikasi Unity Anda.
Langkah 4: Tambahkan kode yang diperlukan
Android
Tidak diperlukan kode tambahan untuk integrasi Line.
iOS
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 Android dan iOS Line tentang cara mengaktifkan iklan percobaan 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
Plugin mediasi Line Unity 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 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 saat iklan gagal dimuat:
Android
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. |
iOS
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 Line. |
103 | com.google.ads.mediation.line | Gagal memuat aset gambar ikon informasi di iklan native. |
Log Perubahan Plugin Mediasi Unity Line
Versi 1.3.1
- Mendukung adaptor Android Line versi 2.8.20240808.0.
- Mendukung Adaptor iOS Line versi 2.8.20240612.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.
Versi 1.3.0
- Mendukung adaptor Android Line versi 2.8.20240722.0.
- Mendukung Adaptor iOS Line versi 2.8.20240612.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.
Versi 1.2.0
- Mendukung Adaptor Android Line versi 2.7.20240515.0.
- Mendukung Adaptor iOS Line versi 2.8.20240612.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.1.
Versi 1.1.2
- Mendukung Adaptor Android Line versi 2.7.20240515.0.
- Mendukung Adaptor iOS Line versi 2.7.20240411.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 1.1.1
- Mendukung Adaptor Android Line versi 2.7.20240214.1.
- Mendukung Adaptor iOS Line versi 2.7.20240411.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 1.1.0
- Menambahkan class
LineMediationExtras
dengan metode berikut untuk mendukung penerusan tambahan mediasi.SetEnabledAdSound(bool)
- Mendukung Adaptor Android Line versi 2.7.20240214.1.
- Mendukung Adaptor iOS Line versi 2.7.20240318.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.0.0.
Versi 1.0.0
- Rilis Awal.
- Mendukung adaptor Android Line versi 2.6.20230607.0.
- Mendukung Adaptor iOS Line versi 2.6.20230609.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.5.1.