Mengintegrasikan Chartboost 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 Chartboost menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini membahas cara menambahkan Chartboost ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan Chartboost SDK dan adapter ke dalam aplikasi Android.

Integrasi dan format iklan yang didukung

Adapter mediasi untuk Chartboost memiliki kemampuan berikut:

Persyaratan

• Android API level 24 atau lebih tinggi

• TerbaruGMA Next-Gen SDK

• Selesaikan mediasi Panduan memulai

Langkah 1: Menyiapkan konfigurasi di UI Chartboost

Daftar akun Chartboost dan login setelah akun Anda diverifikasi. Kemudian, buka tab Apps management.

Klik tombol Add new app untuk membuat aplikasi Anda.

Isi bagian formulir lainnya, lalu klik tombol Add App untuk menyelesaikan aplikasi Anda.

Setelah aplikasi Anda dibuat, Anda akan diarahkan ke dasbornya. Catat App ID dan App Signature aplikasi Anda.

Ad Manager memerlukan User ID dan User Signature Chartboost untuk menyiapkan ID unit iklan Ad Manager Anda. Anda dapat menemukan parameter ini dengan mengklik Chartboost mediation di UI Chartboost.

Buka tab Resources > API Explorer dan catat User ID dan User Signature Anda yang terletak di bagian Authentication.

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

Untuk menerapkan app-ads.txt untuk Chartboost, lihat app-ads.txt.

Mengaktifkan mode pengujian

Anda dapat mengaktifkan mode pengujian di aplikasi dengan membuka tab Apps management dari UI Chartboost, memilih aplikasi dari daftar, dan mengklik Edit app settings.

Dari setelan aplikasi, Anda dapat mengaktifkan Test mode di aplikasi.

Setelah mode pengujian diaktifkan, Anda dapat meminta iklan menggunakan ID unit iklan yang dibuat sebelumnya dan menerima iklan pengujian Chartboost.

Setelah Anda dapat menerima iklan pengujian Chartboost, aplikasi Anda akan ditempatkan di Peninjauan Aplikasi Penayang Chartboost. Agar monetisasi di Chartboost berfungsi, peninjauan aplikasi penayang harus disetujui oleh Chartboost.

Langkah 2: Menyiapkan permintaan Chartboost di UI Ad Manager

Mengonfigurasi setelan mediasi untuk unit iklan Anda

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 Chartboost, Anda dapat memilihnya. Jika tidak, pilih Buat partner hasil baru.

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

Aktifkan Pengumpulan data otomatis, lalu masukkan User ID dan User Signature yang diperoleh di bagian sebelumnya.

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

Lokasi Iklan Chartboost (Lokasi Bernama) adalah nama sederhana yang mewakili tempat di aplikasi Anda tempat Anda ingin menampilkan iklan. Ad Manager mengirimkan permintaan ke lokasi yang ditentukan dalam setelan. Setelah permintaan dikirim, Chartboost akan menambahkan lokasi ke UI-nya untuk tujuan pelaporan.

Di UI Chartboost, Lokasi Iklan Anda dapat ditampilkan di halaman Basic Settings dengan mengklik Advanced Settings. Lihat panduan Lokasi Bernama Chartboost untuk mengetahui detail selengkapnya.

Klik Simpan di bagian bawah halaman setelah selesai.

Menambahkan Chartboost 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 Chartboost ke daftar partner iklan peraturan Eropa dan negara bagian Amerika Serikat di UI Ad Manager.

Langkah 3: Mengimpor Chartboost SDK dan adapter

Integrasi Android Studio (direkomendasikan)

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

Dalam file gradle level aplikasi, tambahkan dependensi dan konfigurasi penerapan berikut:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:chartboost:9.11.1.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:chartboost:9.11.1.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 file .aar Chartboost SDK versi terbaru dari Maven Central, lalu tambahkan ke project Anda.

2. Buka artefak adapter Chartboost di Repositori Maven Google. Pilih versi terbaru, download file .aar adapter Chartboost, lalu tambahkan ke project Anda.

Langkah 4: Menerapkan setelan privasi di Chartboost 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.

Di SDK versi 8.1.0, Chartboost menambahkan metode addDataUseConsent(). Kode contoh berikut menetapkan izin penggunaan data ke NON_BEHAVIORAL. Jika Anda memilih untuk memanggil metode ini, sebaiknya lakukan sebelum meminta iklan melalui GMA Next-Gen SDK.

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

Lihat artikel GDPR Chartboost dan Metode Privasi Android mereka untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan di setiap metode.

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 yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Di SDK versi 8.1.0, Chartboost menambahkan metode addDataUseConsent(). Kode contoh berikut menetapkan izin penggunaan data ke OPT_IN_SALE. Jika Anda memilih untuk memanggil metode ini, sebaiknya lakukan sebelum meminta iklan melalui GMA Next-Gen SDK.

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

Lihat artikel CCPA Chartboost dan Metode Privasi Android mereka untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan di setiap metode.

Langkah 5: Menambahkan kode yang diperlukan

Memperbarui perubahan konfigurasi Aktivitas

Tambahkan atribut berikut ke setiap aktivitas dalam file AndroidManifest.xml yang menampilkan iklan Chartboost dan mendukung orientasi yang berbeda:

android:configChanges="keyboardHidden|orientation|screenSize"

Langkah 6: Menguji penerapan Anda

Mengaktifkan iklan pengujian

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

Memverifikasi iklan pengujian

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Chartboost, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan Chartboost (Waterfall) sumber iklan.

Langkah opsional

Izin

Untuk performa yang optimal, Chartboost merekomendasikan untuk menambahkan izin opsional berikut ke file AndroidManifest.xml aplikasi Anda:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Kode error

Jika adapter gagal menerima iklan dari Chartboost, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di bawah class berikut:

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adapter Chartboost saat iklan gagal dimuat: