Mengintegrasikan ironSource dengan mediasi

Pilih platform: Android (beta) Android iOS Unity Flutter

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari ironSource Ads menggunakan Mediasi AdMob, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan ironSource Ads ke konfigurasi mediasi unit iklan, cara menyiapkan pengoptimalan sumber iklan, dan cara mengintegrasikan ironSource Ads SDK dan adaptor ke dalam aplikasi Android Anda.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk ironSource Ads memiliki kemampuan berikut:

¹ Format ini hanya didukung dalam integrasi waterfall.

Persyaratan

• Android API level 24 atau yang lebih tinggi

• [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan adaptor IronSource 8.5.0.1 atau yang lebih tinggi (versi terbaru direkomendasikan)

• Terbaru GMA Next-Gen SDK.

• Selesaikan panduan Memulai mediasi .

Langkah 1: Siapkan konfigurasi di UI ironSource Ads

Daftar dan login ke akun ironSource Ads Anda.

Tambahkan aplikasi baru

Untuk menambahkan aplikasi baru, buka Ads > Apps , lalu klik Add app.

Isi formulir, lalu klik Add app.

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

Buat instance

Selanjutnya, konfigurasikan instance untuk aplikasi yang Anda tambahkan.

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

Temukan Kunci Reporting API Anda

Perbarui app-ads.txt Anda

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 yang signifikan pada pendapatan iklan, Anda harus menerapkan file app-ads.txt. Jika belum melakukannya, siapkan file app-ads.txt untuk aplikasi Anda.

Untuk menerapkan app-ads.txt untuk ironSource, lihat Penjual resmi ironSource.

Aktifkan mode pengujian

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

Langkah 2: Siapkan permintaan ironSource Ads di UI AdMob

Konfigurasikan setelan mediasi untuk unit iklan Anda

Anda harus menambahkan ironSource Ads ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan ironSource Ads sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Selesai.

Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang Anda pilih:

Tambahkan ironSource Ads sebagai sumber iklan

Bidding

Di bagian Sumber Iklan , di kartu Bidding , pilih Tambahkan sumber iklan. Kemudian, pilih ironSource Ads.

Klik Cara menandatangani perjanjian kemitraan dan siapkan kemitraan bidding dengan ironSource Ads.



Klik Saya telah membaca dan menyetujui perjanjian ini, lalu klik Lanjutkan.



Jika sudah memiliki pemetaan untuk ironSource Ads, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan App Key dan Instance ID yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Waterfall

Di bagian Sumber Iklan , di kartu Waterfall , pilih Tambahkan Sumber Iklan.

Pilih ironSource Ads dan aktifkan tombol Optimalkan. Masukkan Secret Key dan Refresh Token yang diperoleh di bagian sebelumnya untuk menyiapkan pengoptimalan sumber iklan untuk ironSource Ads. Kemudian, masukkan nilai eCPM untuk ironSource Ads dan klik Lanjutkan.



Jika sudah memiliki pemetaan untuk ironSource Ads, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan App Key dan Instance ID yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Tambahkan ironSource Mobile ke daftar partner iklan GDPR dan peraturan negara bagian Amerika Serikat

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

Langkah 3: Impor ironSource Ads SDK dan adaptor

Integrasi Android Studio (direkomendasikan)

Di file settings.gradle.kts level project, tambahkan repositori berikut:

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

Di file gradle level aplikasi, tambahkan dependensi dan konfigurasi implementasi berikut:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrasi Manual

1. Download ironSource Ads Android SDK versi terbaru dan tambahkan ke project Anda.

2. Buka artefak adaptor ironSource Ads di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor IronSource, dan tambahkan ke project Anda.

Langkah 4: Terapkan setelan privasi di ironSource Ads SDK

Izin Uni Eropa dan GDPR

Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna Anda di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss serta mendapatkan izin mereka atas penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, serta atas pengumpulan, pembagian, dan 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. Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Mulai ironSource SDK versi 7.7.0, ironSource otomatis membaca izin GDPR yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP SDK. Untuk mengetahui informasi selengkapnya, lihat Dukungan untuk UMP dan CMP Google yang mendukung Izin Tambahan Google.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada penduduk untuk tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan undang-undang), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan 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.

Di SDK versi 6.14.0, ironSource Ads menambahkan API untuk mendukung peraturan CCPA. Kode contoh berikut menunjukkan cara meneruskan informasi izin ini ke ironSource Ads SDK. Opsi ini harus ditetapkan sebelum Anda melakukan inisialisasi GMA Next-Gen SDK untuk memastikan opsi tersebut diteruskan dengan benar ke ironSource Ads SDK.

LevelPlay.setMetaData("do_not_sell", "true");
IronSourceMediationSnippets.java

LevelPlay.setMetaData("do_not_sell", "true")
IronSourceMediationSnippets.kt

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

Langkah 5: Tambahkan kode yang diperlukan

Muat iklan dengan konteks aktivitas

Teruskan konteks Activity saat memuat format iklan Banner, Interstisial, dan Reward. Tanpa konteks aktivitas, pemuatan iklan akan gagal.

Aturan Proguard

Jika Anda menyusutkan, 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.

Langkah 6: Uji penerapan Anda

Aktifkan iklan percobaan

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob danmengaktifkan mode pengujiandi UI ironSource Ads.

Verifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan percobaan 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, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di class berikut:

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

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