Mengintegrasikan ironSource Ads 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 ironSource Ads menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan ironSource Ads ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan SDK dan adaptor ironSource Ads ke aplikasi React Native.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk ironSource Ads memiliki kemampuan berikut:

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

¹ Format ini hanya didukung dalam integrasi waterfall.

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

Daftar dan login ke akun ironSource Ads Anda.

Tambahkan aplikasi baru

Untuk menambahkan aplikasi baru, buka Iklan > Aplikasi, lalu klik Tambahkan aplikasi.

Isi formulir, lalu klik Tambahkan aplikasi.

Catat App Key, lalu pilih format iklan yang didukung aplikasi Anda dan klik Continue.

Android

iOS

Membuat instance

Selanjutnya, konfigurasikan instance untuk aplikasi yang Anda tambahkan.

Buka Ads > Setup > Instances. Pilih aplikasi, lalu klik Create instance.

Bidding

Isi formulir dan pilih Bidding untuk Penetapan harga. Klik Simpan dan tutup.

Android

iOS

Catatan: ironSource Ads membatasi jumlah instance yang dapat Anda buat. Jika Anda menerima error yang menyatakan bahwa Anda tidak dapat membuat instance lagi, hubungi tim dukungan ironSource Ads untuk mendapatkan bantuan.

Poin Penting: Jika Anda ingin mendukung iklan interstisial reward, pilih format Rewarded Video, dan gunakan Instance ID tersebut saat menambahkan ironSource Ads sebagai sumber iklan di langkah 2. Selain itu, Anda harus menghubungi tim dukungan ironSource Ads di [e-mail] untuk menyiapkan instance Anda untuk dukungan interstisial reward.

Catat ID Instance.

Android

iOS

Air Terjun

Isi formulir, lalu klik Simpan dan tutup.

Catatan: ironSource Ads membatasi jumlah instance yang dapat Anda buat. Jika Anda menerima error yang menyatakan bahwa Anda tidak dapat membuat instance lagi, hubungi tim dukungan ironSource Ads untuk mendapatkan bantuan.

Poin Penting: Jika Anda ingin mendukung iklan interstisial reward, pilih format Rewarded Video, dan gunakan Instance ID tersebut saat menambahkan ironSource Ads sebagai sumber iklan di langkah 2. Selain itu, Anda harus menghubungi tim dukungan ironSource Ads di [e-mail] untuk menyiapkan instance Anda untuk dukungan interstisial reward.

Catat ID Instance.

Menemukan Kunci API Pelaporan

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Air Terjun

Catatan: Hanya pengguna dengan izin Kontributor atau Administrator yang dapat mengakses Kunci API.

Klik tab API di halaman My Account, lalu catat Secret Key dan Refresh Token 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 ironSource, lihat reseller resmi ironSource.

Mengaktifkan mode pengujian

Ikuti petunjuk dalam panduan Pengujian integrasi ironSource Ads tentang cara mengaktifkan iklan pengujian ironSource Ads.

Langkah 2: Siapkan permintaan ironSource Ads 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.

Menambahkan ironSource Mobile ke daftar partner iklan GDPR dan peraturan negara bagian AS

Penting: Pastikan Anda memiliki izin Pengelolaan Akun untuk menyelesaikan konfigurasi untuk Izin dan GDPR Uni Eropa, peraturan Negara Bagian AS, dan Platform Pesan Pengguna. Lihat Mengelola akses pengguna ke akun Anda untuk mengetahui detailnya.

Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan ironSource Mobile ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI AdMob.

Langkah 3: Impor SDK dan adaptor ironSource Ads

Catatan: Kegagalan dalam mengintegrasikan versi SDK ironSource Ads dan Google Mobile Ads SDK for React Native yang kompatibel dapat menyebabkan masalah build.

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

1. Salin file tar adaptor Google Mobile Ads SDK for React Native dari direktori gma-sdk-react-native/adapters/ironsource/ 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/ironsource/gma-mediation-ironsource-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-ironsource-0.1.0.tgz
   

   benang

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

3. Jika Anda mem-build untuk Android, tambahkan repositori berikut ke file build.gradle di direktori android project Anda:

   repositories {
       google()
       mavenCentral()
       maven {
           url = uri("https://android-sdk.is.com/")
       }
   }
   

Langkah 4: Terapkan setelan privasi di SDK ironSource Ads

Izin Uni Eropa dan GDPR

Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka untuk penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, dan untuk pengumpulan, pembagian, serta penggunaan data pribadi untuk personalisasi iklan. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Anda bertanggung jawab untuk memverifikasi bahwa izin disebarkan ke setiap sumber iklan dalam rantai mediasi Anda.

Adaptor React Native ironSource Ads versi 0.1.0 dan yang lebih baru mendukung penerusan sinyal izin GDPR dari UMP SDK dan platform pengelolaan izin yang terintegrasi dengan spesifikasi Izin Tambahan Google ke ironSource Ads SDK. Untuk mengetahui informasi selengkapnya, lihat Kepatuhan GDPR ironSource.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada pengguna guna menolak "penjualan" "informasi pribadi" mereka (sebagaimana kedua istilah tersebut didefinisikan dalam hukum), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan terhadap hukum privasi negara bagian Amerika Serikat menawarkan kemampuan untuk mengaktifkan pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap jaringan iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Plugin mediasi Google Mobile Ads untuk ironSource Ads menyertakan metode GmaMediationIronsource().setDoNotSell. Kode contoh berikut menunjukkan cara meneruskan informasi izin ke ironSource SDK iklan. Opsi ini harus ditetapkan sebelum Anda melakukan inisialisasi Google Mobile Ads SDK for React Native untuk memastikan opsi tersebut diteruskan dengan benar ke ironSource SDK iklan.

import { IronSourceMediation } from '@google/gma-mediation-ironsource';
// ...
IronSourceMediation.setDoNotSell(true);

Lihat dokumentasi ironSource Ads tentang Setelan Lanjutan Peraturan untuk Android dan iOS guna mengetahui detail selengkapnya dan nilai yang dapat diberikan dalam metode ini.

Langkah 5: Tambahkan kode yang diperlukan

Android

Aturan Proguard

Jika Anda menyingkat, meng-obfuscate, dan mengoptimalkan aplikasi, ironSource Ads memerlukan aturan ProGuard tambahan untuk project Anda.

Lihat panduan Integrasi Android SDK ironSource Ads untuk mengetahui informasi selengkapnya tentang aturan ProGuard yang diperlukan untuk project Anda, dan tambahkan aturan tersebut ke file proguard-user.txt Anda.

iOS

Integrasi SKAdNetwork

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI ironSource Ads.

Penting: Nonaktifkan mode pengujian untuk AdMob dan ironSource Ads sebelum merilis aplikasi Anda.

Memverifikasi iklan pengujian

Untuk memastikan bahwa Anda menerima iklan pengujian dari ironSource Ads, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan ironSource Ads (Bidding) dan ironSource Ads (Waterfall).

Kode error

Jika adaptor gagal menerima iklan dari ironSource Ads, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bawah class berikut:

Android

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

Kode error	Alasan
101	Parameter server ironSource Ads yang dikonfigurasi di UI AdMob tidak ada/tidak valid.
102	ironSource Ads memerlukan konteks Aktivitas untuk melakukan inisialisasi SDK-nya.
103	ironSource Ads hanya dapat memuat 1 iklan per ID instance ironSource.
105	Ukuran iklan banner yang diminta tidak didukung oleh ironSource Ads.
106	SDK ironSource Ads tidak diinisialisasi.
107	Permintaan penayangan iklan dibuat sebelum iklan berhasil dimuat.
108	ironSource SDK iklan menampilkan sinyal bidding kosong atau null.
501-1056	Error SDK ironSource Ads. Lihat dokumentasi untuk mengetahui detail selengkapnya.

iOS

Kode error	Alasan
101	Parameter server ironSource Ads yang dikonfigurasi di UI AdMob tidak ada/tidak valid.
102	Adaptor ironSource Ads tidak mendukung format iklan yang diminta.
103	Iklan ironSource sudah dimuat untuk konfigurasi jaringan ini.
104	Ukuran iklan banner yang diminta tidak didukung oleh ironSource Ads.
105	ironSource Ads gagal menampilkan iklan.
508-1037	Error SDK ironSource Ads. Lihat dokumentasi untuk mengetahui detail selengkapnya.

Versi 0.1.0

• Rilis awal.

• Mendukung adaptor Android ironSource versi 9.6.0.1.
• Mendukung adaptor iOS ironSource versi 9.5.0.0.0.