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, yang mencakup integrasi waterfall. Panduan ini mencakup cara menambahkan ironSource Ads ke konfigurasi mediasi unit iklan, cara menyiapkan pengoptimalan sumber iklan, dan cara mengintegrasikan SDK dan adaptor ironSource Ads ke 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

• Level API Android 24 atau yang lebih tinggi

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

• GMA Next-Gen SDK terbaru.

• Selesaikan Panduan memulai mediasi.

Langkah 1: Siapkan konfigurasi di UI Iklan ironSource

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 Kunci Aplikasi, lalu pilih format iklan yang didukung aplikasi Anda dan klik Lanjutkan.

Membuat instance

Selanjutnya, konfigurasi instance untuk aplikasi yang Anda tambahkan.

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

Menemukan Kunci API Pelaporan

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, buat file app-ads.txt untuk Ad Manager.

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

Mengaktifkan mode pengujian

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

Langkah 2: Siapkan permintaan Iklan ironSource di UI Ad Manager

Mengonfigurasi setelan mediasi untuk unit iklan

Login ke akun Ad Manager Anda.

Buka Penayangan > Grup hasil, lalu klik tombol Grup hasil baru.

Masukkan Nama unik untuk grup hasil Anda, tetapkan Status ke Aktif, pilih Format Iklan, dan tetapkan Jenis inventaris ke Aplikasi Seluler. Di bagian Penargetan > Inventaris, pilih unit iklan di bagian Inventaris dan Aplikasi seluler yang ingin Anda tambahkan mediasi.

Selanjutnya, klik tombol Tambahkan partner hasil.

Jika sudah memiliki Partner hasil untuk ironSource Ads, Anda dapat memilihnya. Jika tidak, pilih Buat partner hasil baru.

Pilih ironSource Ads sebagai Jaringan iklan, masukkan Nama unik, dan aktifkan Mediasi.

Aktifkan Pengumpulan data otomatis, lalu masukkan Secret Key dan Refresh Token yang diperoleh di bagian sebelumnya.

Setelah Partner hasil dipilih, pilih Mediasi SDK Seluler sebagai Jenis integrasi, Android sebagai Platform, dan Aktif sebagai Status. Masukkan Kunci Aplikasi dan ID Instance yang diperoleh di bagian sebelumnya. Kemudian, masukkan nilai CPM Default.

Klik Simpan di bagian bawah halaman setelah selesai.

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

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 Ad Manager.

Langkah 3: Impor ironSource Ads SDK dan adaptor

Integrasi Android Studio (direkomendasikan)

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

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

Dalam file gradle level aplikasi, tambahkan implementasi dependencies dan konfigurasi berikut:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    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.24.0-beta02'
    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 versi terbaru ironSource Ads Android SDK dan tambahkan ke project Anda.

2. Buka artefak adaptor Iklan ironSource di Repositori Maven Google. Pilih versi terbaru, download file .aar adapter 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 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 diteruskan 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 AS mewajibkan pemberian hak kepada pengguna untuk memilih tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh 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 rangkaian mediasi yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Pada SDK versi 6.14.0, ironSource Ads menambahkan API untuk mendukung peraturan CCPA. Contoh kode berikut menunjukkan cara meneruskan informasi izin ini ke ironSource Ads SDK. Opsi ini harus ditetapkan sebelum Anda menginisialisasi 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

Memuat 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 mengecilkan, 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

Mengaktifkan iklan pengujian

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

Memverifikasi 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 bawah 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 Iklan ironSource saat iklan gagal dimuat: