Mengintegrasikan Jaringan Iklan LY dengan Mediasi AdMob

Pilih platform: Android iOS Unity Flutter React Native Android (Lama)

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

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Jaringan Iklan LY memiliki kapabilitas berikut:

Integrasi
Bidding
Air Terjun
Format
Membuka Aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native

Prasyarat

Sebelum melanjutkan, pastikan hal berikut:

• Versi Google Mobile Ads SDK for React Native terbaru.
• Framework React Native versi 0.85.0 atau yang lebih baru.
• Untuk men-deploy di Android
  • Android API level 24 atau yang lebih baru.
• Untuk men-deploy di iOS
  • Target deployment iOS 13.0 atau yang lebih baru.
• Project React Native yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK for React Native. Lihat Menyiapkan Google Mobile Ads SDK for React Native untuk mengetahui detailnya.
  • Pastikan Anda telah mendownload dan mengekstrak folder adapters dari folder gma-sdk-react-native. Jika Anda tidak memiliki folder adapters, ikuti langkah satu, dua, dan tiga di Menginstal Google Mobile Ads SDK for React Native.
• Siapkan Mediasi AdMob.

Langkah 1: Siapkan konfigurasi di UI LY Ads Network

Daftar dan login ke akun Jaringan Iklan LY Anda.

Menambahkan aplikasi baru

Buka tab App, lalu klik tombol New registration.

Isi formulir dan klik pendaftaran.

Catatan: Anda harus membuat aplikasi terpisah untuk setiap platform yang ingin Anda dukung.

Catat ID Aplikasi.

Android

iOS

Membuat slot iklan

Di tab Aplikasi, pilih aplikasi Anda untuk melihat detail aplikasi. Di bagian Slot, klik Add.

Isi formulir untuk mengetahui detail tentang slot. Untuk Jenis Bidding, pilih Standar guna mengonfigurasi slot ini untuk mediasi waterfall, atau Bidding dengan SDK Google guna mengonfigurasi slot ini untuk Bidding. Klik Create setelah formulir diisi.

Catatan: Format Iklan dan Jenis Bidding tidak dapat diubah setelah mendaftarkan slot. Hubungi Account Manager LY Ads Network Anda untuk mendapatkan akses guna membuat penempatan iklan native di UI LY Ads Network.

Catat ID Slot.

Setelah membuat slot pertama, klik Review di halaman detail aplikasi untuk mendapatkan persetujuan dari Jaringan Iklan LY. Proses ini mungkin memerlukan waktu beberapa saat. Hubungi perwakilan Jaringan Iklan LY jika ada pertanyaan.

Membuat Kunci API Pelaporan

Buka tab Managing reporting API keys, lalu klik tombol Create API key.

Isi formulir lalu klik Simpan.

Catat ID Kunci API dan Rahasia Kunci API Anda.

Memperbarui app-ads.txt

Authorized Sellers for Apps app-ads.txt adalah inisiatif IAB Tech Lab yang membantu memastikan inventaris iklan aplikasi Anda hanya dijual melalui saluran yang telah Anda identifikasi sebagai resmi. Untuk mencegah kerugian pendapatan iklan yang signifikan, Anda harus menerapkan file app-ads.txt. Jika Anda belum melakukannya, siapkan file app-ads.txt untuk aplikasi Anda.

Untuk menerapkan app-ads.txt untuk LY Ads Network, lihat Tentang app-ads.txt.

Langkah 2: Siapkan permintaan jaringan iklan LY di UI AdMob

Mengonfigurasi setelan mediasi untuk unit iklan Anda

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 LY

Catatan: Kegagalan dalam mengintegrasikan versi LY Ads Network dan Google Mobile Ads SDK yang kompatibel dapat menyebabkan masalah build.

Di direktori root project Anda, instal adaptor mediasi Google Mobile Ads SDK for React Native untuk Jaringan Iklan LY. Selesaikan langkah-langkah berikut:

1. Salin file tar adaptor Google Mobile Ads SDK for React Native dari direktori gma-sdk-react-native/adapters/line/ ke direktori local_packages/ project Anda. Jika Anda tidak memiliki folder adapters, lihat Prasyarat.

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/
   

   Ganti EXTRACT_DIR dengan jalur ke direktori tempat Anda mengekstrak arsip.

2. Instal paket adaptor menggunakan pengelola paket pilihan Anda:

   npm

   npm install ./local_packages/gma-mediation-line-0.1.0.tgz
   

   benang

   yarn add ./local_packages/gma-mediation-line-0.1.0.tgz
   

Langkah 4: Tambahkan kode yang diperlukan

Android

Tidak diperlukan kode tambahan untuk integrasi Jaringan Iklan LY.

iOS

Integrasi SKAdNetwork

Ikuti dokumentasi jaringan iklan LY 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.

Penting: Nonaktifkan mode pengujian untuk AdMob dan Jaringan Iklan LY sebelum merilis aplikasi Anda.

Memverifikasi iklan pengujian

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Jaringan Iklan LY, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Jaringan Iklan LY.

Langkah opsional

Parameter khusus jaringan

Plugin mediasi React Native LY Ads Network mendukung parameter permintaan tambahan berikut yang dapat diteruskan ke adaptor melalui class LineMediationExtras:

• enableAdSound : Menentukan status awal suara default untuk iklan banner, interstisial, dan reward.

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

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

Kode error

Jika adaptor gagal menerima iklan dari Jaringan Iklan LY, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di 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 Jaringan Iklan LY saat iklan gagal dimuat:

Android

Kode error	Domain	Alasan
1-10	com.five_corp.ad	SDK Jaringan Iklan LY menampilkan error khusus SDK. Lihat dokumentasi Jaringan Iklan LY 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 sesuai dengan ukuran iklan banner yang didukung LY Jaringan Iklan.
104	com.google.ads.mediation.line	Gagal memuat iklan interstisial atau reward karena tidak ada konteks aktivitas.
105	com.google.ads.mediation.line	SDK Jaringan Iklan LY Ads gagal menampilkan iklan interstisial atau iklan reward.
106	com.google.ads.mediation.line	Gagal memuat iklan native karena aset tidak lengkap.
107	com.google.ads.mediation.line	FiveAd SDK menampilkan pemuat iklan null.

iOS

Kode error	Domain	Alasan
1-10	Dikirim oleh SDK Jaringan Iklan LY	SDK Jaringan Iklan LY menampilkan error khusus SDK. Lihat dokumentasi Jaringan Iklan LY 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 sesuai dengan ukuran iklan banner yang didukung LY Jaringan Iklan.
103	com.google.ads.mediation.line	Gagal memuat aset gambar ikon informasi di iklan native.
104	com.google.ads.mediation.line	Gagal mengumpulkan sinyal untuk bidding.
105	com.google.ads.mediation.line	Gagal melakukan inisialisasi loader SDK iklan LINE Ads.

Versi 0.1.0

• Rilis awal.

• Mendukung adaptor Android LINE versi 3.1.1.2.
• Mendukung adaptor iOS LINE versi 3.1.1.0.
• Dibuat dan diuji dengan Plugin React Native Google Mobile Ads versi 0.1.0.