Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Chartboost menggunakan mediasi, yang membahas integrasi waterfall. Artikel ini membahas cara menambahkan Chartboost ke bagian mediasi, dan cara mengintegrasikan Chartboost SDK dan adaptor ke dalam aplikasi Unity.
Integrasi dan format iklan yang didukung
Adaptor mediasi AdMob untuk Chartboost memiliki kemampuan berikut:
Integrasi | |
---|---|
Bidding | |
Air Terjun | |
Format | |
Banner | |
Interstisial | |
Reward |
Persyaratan
- Unity 4 atau yang lebih baru
- Google Mobile Ads SDK terbaru
- Untuk men-deploy di Android
- Android API level 21 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 12.0 atau versi yang lebih tinggi
- Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Mulai untuk mengetahui detailnya.
- Selesaikan mediasi Panduan memulai
Langkah 1: Siapkan konfigurasi di UI Chartboost
Daftar untuk membuat akun Chartboost dan login setelah akun Anda diverifikasi. Lalu, buka tab Pengelolaan aplikasi.
Klik tombol Add new app untuk membuat aplikasi.
Isi sisa formulir dan klik tombol Tambahkan Aplikasi untuk menyelesaikan proses .
Setelah aplikasi dibuat, Anda akan diarahkan ke dasbornya. Perhatikan ID Aplikasi dan Tanda Tangan Aplikasi aplikasi Anda.
Android
iOS
AdMob memerlukan ID Pengguna Chartboost dan Tanda Tangan Pengguna untuk menyiapkan iklan AdMob ID unit iklan. Anda dapat menemukan parameter ini dengan mengklik Mediasi Chartboost di UI Chartboost.
Buka Referensi > tab API Explorer dan perhatikan User ID dan Tanda Tangan Pengguna yang ada di bagian Authentication.
Aktifkan mode pengujian
Anda dapat mengaktifkan mode pengujian di aplikasi dengan membuka Pengelolaan aplikasi tab dari Chartboost UI, memilih aplikasi Anda dari daftar dan mengeklik Edit setelan aplikasi.
Android
iOS
Dari setelan aplikasi, Anda dapat mengaktifkan/menonaktifkan Mode pengujian di aplikasi.
Setelah mode pengujian diaktifkan, Anda dapat meminta iklan menggunakan ID unit iklan yang dibuat sebelumnya dan menerima iklan percobaan Chartboost.
Setelah dapat menerima iklan percobaan Chartboost, aplikasi Anda akan ditempatkan di Tinjauan Aplikasi Penayang Chartboost. Agar monetisasi di Chartboost dapat berjalan, peninjauan aplikasi penayang akan harus disetujui oleh Chartboost.
Langkah 2: Siapkan permintaan Chartboost di AdMob UI
Mengonfigurasi setelan mediasi untuk unit iklan
Android
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.
Menambahkan Chartboost ke daftar partner iklan peraturan negara bagian Amerika Serikat dan GDPR
Langkah 3: Impor Chartboost SDK dan adaptor
OpenUPM-CLI
Jika Anda memiliki OpenUPM-CLI Anda dapat menginstal Chartboost Google Mobile Ads Plugin Mediasi untuk Unity ke project Anda dengan menjalankan perintah berikut dari direktori utama project Anda:
openupm add com.google.ads.mobile.mediation.chartboost
OpenUPM
Di editor project Unity, pilih Edit > Setelan Project > Package Manager untuk membuka Setelan Pengelola Paket Unity.
Pada tab Scoped Registries, tambahkan OpenUPM sebagai scope registry dengan detail berikut:
- Nama:
OpenUPM
- URL:
https://package.openupm.com
- Cakupan:
com.google
Lalu, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.
Pilih paket Google Mobile Ads Chartboost Mediation dan klik Install.
Paket Unity
Download versi terbaru plugin mediasi Google Mobile Ads untuk
Chartboost dari tautan unduhan
tindakan
Log perubahan
lalu mengekstrak
GoogleMobileAdsChartboostMediation.unitypackage
dari zip
.
Di editor project Unity, pilih Assets > Impor Paket >
Custom Package dan temukan
GoogleMobileAdsChartboostMediation.unitypackage
yang didownload. Pastikan semua file dipilih dan klik
Impor.
Lalu, pilih Aset > Resolver Layanan Play >
Resolver Android > Paksa Selesaikan. Resolver Layanan Unity Play
library akan melakukan resolusi dependensi dari awal, lalu menyalin
dependensi yang dideklarasikan ke dalam direktori Assets/Plugins/Android
aplikasi Unity.
Langkah 4: Terapkan setelan privasi di Chartboost SDK
Izin Uni Eropa dan GDPR
Berdasarkan Izin Pengguna Uni Eropa Google Google Ads, Anda harus memastikan bahwa pengungkapan tertentu diberikan kepada, dan izin yang diperoleh dari, pengguna di Wilayah Ekonomi Eropa (EEA) terkait penggunaan ID perangkat dan data pribadi. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Uni Eropa Peraturan (GDPR). Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi, dan menyediakan informasi tentang penggunaan setiap jaringan. Google saat ini tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.
Plugin mediasi Google Mobile Ads untuk Chartboost versi 3.1.0 mencakup
Metode Chartboost.AddDataUseConsent()
. Contoh penggunaan data set kode berikut
mengizinkan NonBehavioral
. Jika Anda memilih untuk memanggil metode ini, sebaiknya
yang Anda lakukan sebelum meminta iklan menggunakan Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
Hukum privasi negara bagian Amerika Serikat
Amerika Serikat hukum privasi negara bagian harus memberikan izin yang tepat kepada pengguna untuk memilih tidak ikut dalam "penjualan" "informasi pribadi" mereka (sebagaimana ditentukan oleh hukum persyaratan tersebut), dengan pilihan tidak ikut yang ditawarkan melalui iklan "Jangan Jual Pribadi Saya" Informasi" tautan di bagian "penjualan" beranda pihak ketiga. Tujuan Amerika Serikat privasi status panduan kepatuhan hukum menawarkan kemampuan untuk pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat berpartisipasi dalam penjualan aset dan mengikuti panduan dari masing-masing jaringan tersebut untuk memastikan kepatuhan.
Plugin mediasi Google Mobile Ads untuk Chartboost versi 3.1.0 mencakup
Metode Chartboost.AddDataUseConsent()
. Contoh penggunaan data set kode berikut
mengizinkan OptInSale
. Jika Anda memilih untuk memanggil metode ini, sebaiknya
yang Anda lakukan sebelum meminta iklan menggunakan Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
Langkah 5: Tambahkan kode yang diperlukan
Android
Tidak ada kode tambahan yang diperlukan untuk integrasi Chartboost.
iOS
Integrasi SKAdNetwork
Ikuti Chartboost
dokumentasi
untuk menambahkan ID SKAdNetwork ke file Info.plist
project Anda.
Langkah 6: Uji penerapan
Aktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian Anda untuk AdMob dan mengaktifkan mode pengujian di Chartboost UI.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Chartboost, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan Chartboost (Waterfall) sumber iklan.
Langkah Opsional
Android
Izin
Untuk performa yang optimal, Chartboost merekomendasikan penambahan opsi
izin ke file AndroidManifest.xml
aplikasi Anda:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
Tidak ada langkah tambahan yang diperlukan untuk integrasi iOS.
Kode error
Jika adaptor gagal menerima
iklan dari Chartboost,
penayang dapat memeriksa error yang mendasar dari respons iklan menggunakan
ResponseInfo
dalam class berikut:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Chartboost saat iklan gagal dimuat:
Android
Kode error | Alasan |
---|---|
0-99 | Chartboost SDK menampilkan error. |
101 | Ukuran iklan yang diminta tidak cocok dengan ukuran spanduk yang didukung Chartboost. |
102 | Chartboost hanya dapat memuat 1 iklan per lokasi dalam satu waktu. |
103 | Parameter server Chartboost yang dikonfigurasi di UI AdMob tidak ada/tidak valid. |
104 | Iklan reward atau interstisial Chartboost belum siap ditampilkan. |
iOS
Kode error | Alasan |
---|---|
101 | Parameter server Chartboost yang dikonfigurasi di UI AdMob tidak ada/tidak valid. |
102 | Chartboost SDK menampilkan error inisialisasi. |
103 | Iklan Chartboost tidak di-cache pada waktu pertunjukan. |
104 | Ukuran iklan yang diminta tidak cocok dengan ukuran spanduk yang didukung Chartboost. |
105 | Versi OS perangkat lebih rendah daripada versi OS minimum yang didukung Chartboost SDK. |
200-299 | Error cache Chartboost SDK. Lihat kode untuk mengetahui detail selengkapnya. |
300-399 | Chartboost SDK menampilkan error. Lihat kode untuk mengetahui detail selengkapnya. |
400-499 | Error klik Chartboost SDK. Lihat kode untuk mengetahui detail selengkapnya. |
Log Perubahan Plugin Mediasi Unity Chartboost
Versi Berikutnya
- Mengganti nama
DummyClient
menjadiPlaceholderClient
.
Versi 4.6.0
- Mendukung Adaptor Android Chartboost versi 9.7.0.0.
- Mendukung Adaptor iOS Chartboost versi 9.7.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 9.0.0.
Versi 4.5.0
- Mendukung Adaptor Android Chartboost versi 9.6.0.0.
- Mendukung Adaptor Chartboost iOS versi 9.6.0.0.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.
Versi 4.4.0
- Mendukung Adaptor Android Chartboost versi 9.5.0.0.
- Mendukung Adaptor Chartboost iOS versi 9.5.1.0.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 8.5.3.
Versi 4.3.0
- Mendukung Adaptor Android Chartboost versi 9.4.0.0.
- Mendukung Adaptor Chartboost iOS versi 9.4.0.0.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 8.5.0.
Versi 4.2.0
- Mendukung Adaptor Android Chartboost versi 9.3.0.0.
- Mendukung Adaptor Chartboost iOS versi 9.3.0.0.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 8.2.0.
Versi 4.1.1
- Konten adaptor dipindahkan ke
GoogleMobileAds/Mediation/Chartboost/
. - Namespace adaptor difaktorkan ulang untuk menggunakan
GoogleMobileAds.Mediation.Chartboost
. - Mendukung Adaptor Android Chartboost versi 9.2.1.1.
- Mendukung Adaptor Chartboost iOS versi 9.2.0.0.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 8.1.0.
Versi 4.1.0
- Mendukung Adaptor Android Chartboost versi 9.2.0.0.
- Mendukung Adaptor Chartboost iOS versi 9.2.0.0.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.1.
Versi 4.0.0
- Mendukung Adaptor Android Chartboost versi 9.1.1.0.
- Mendukung Adaptor iOS Chartboost versi 9.1.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.3.0.
Versi 3.5.1
- Mendukung Adaptor Android Chartboost versi 8.4.3.1.
- Mendukung Adaptor Chartboost iOS versi 8.5.0.2.
- Dibangun dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.2.
Versi 3.5.0
- Mendukung Adaptor Android Chartboost versi 8.4.2.0.
- Mendukung Adaptor Chartboost iOS versi 8.5.0.2.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.0.
Versi 3.4.1
- Mendukung Adaptor Android Chartboost versi 8.3.1.0.
- Mendukung Adaptor Chartboost iOS versi 8.5.0.2.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.0.
Versi 3.4.0
- Mendukung Adaptor Android Chartboost versi 8.3.0.0.
- Mendukung Adaptor Chartboost iOS versi 8.5.0.1.0.
Versi 3.3.1
- Mendukung Adaptor Android Chartboost versi 8.2.1.0.
- Mendukung Adaptor Chartboost iOS versi 8.4.1.1.
Versi 3.3.0
- Mendukung Adaptor Android Chartboost versi 8.2.0.0.
- Mendukung Adaptor Chartboost iOS versi 8.4.0.0.
Versi 3.2.0
- Mendukung Adaptor Android Chartboost versi 8.1.0.0.
- Mendukung Adaptor Chartboost iOS versi 8.3.1.0.
Versi 3.1.0
- Menghapus metode
RestrictDataCollection()
dari classChartboost
. - Menambahkan metode bantuan
AddDataUseConsent()
untuk meneruskan informasi GDPR dan CCPA ke Chartboost. - Mendukung Adaptor Android Chartboost versi 8.1.0.0.
- Mendukung Adaptor Chartboost iOS versi 8.2.0.0.
Versi 3.0.1
- Mendukung Adaptor Android Chartboost versi 8.0.3.1.
- Mendukung Adaptor iOS Chartboost versi 8.1.0.1.
Versi 3.0.0
- Mendukung Adaptor Android Chartboost versi 8.0.2.0.
- Mendukung Adaptor iOS Chartboost versi 8.1.0.0.
Versi 2.0.1
- Mendukung Adaptor Android Chartboost versi 7.5.0.1.
- Mendukung Adaptor Chartboost iOS versi 8.0.4.0.
Versi 2.0.0
- Mendukung adaptor Android Chartboost versi 7.5.0.0.
- Mendukung adaptor Chartboost iOS versi 8.0.1.1.
Versi 1.3.0
- Mengupdate plugin untuk mendukung Reward API yang baru.
- Mendukung adaptor Android Chartboost versi 7.3.1.1.
- Mendukung adaptor Chartboost iOS versi 7.5.0.0.
Versi 1.2.0
- Mendukung adaptor Android Chartboost versi 7.3.0.0.
- Mendukung adaptor Chartboost iOS versi 7.3.0.0.
Versi 1.1.1
- Mendukung adaptor Android Chartboost versi 7.2.0.1.
- Mendukung adaptor Chartboost iOS versi 7.2.0.1.
Versi 1.1.0
- Mendukung Chartboost Android SDK versi 7.2.0.
- Mendukung Chartboost iOS SDK versi 7.2.0.
- Menambahkan metode
Chartboost.RestrictDataCollection()
guna mengaktifkan batasan pengumpulan data GDPR untuk Chartboost SDK.
Versi 1.0.0
- Rilis pertama!
- Mendukung Chartboost Android SDK versi 7.0.1.
- Mendukung Chartboost iOS SDK versi 7.1.2.