Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Chartboost menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini mencakup cara menambahkan Chartboost ke konfigurasi mediasi unit iklan, serta 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 | |
Waterfall | |
Format | |
Banner | |
Interstisial | |
Diberikan sebagai reward |
Persyaratan
- Unity 4 atau yang lebih tinggi
- 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 yang lebih tinggi
- Project Unity berfungsi yang dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
- Selesaikan mediasi Panduan memulai
Langkah 1: Siapkan konfigurasi di UI Chartboost
Daftar untuk mendapatkan akun Chartboost dan login setelah akun Anda diverifikasi. Lalu, buka tab Pengelolaan aplikasi.
Klik tombol Add new app untuk membuat aplikasi.
Isi seluruh formulir, lalu klik tombol Add App untuk menyelesaikan aplikasi Anda.
Setelah aplikasi dibuat, Anda akan diarahkan ke dasbornya. Catat ID Aplikasi dan Tanda Tangan Aplikasi pada aplikasi Anda.
Android
iOS
AdMob memerlukan User ID dan Tanda Tangan Pengguna Chartboost untuk menyiapkan AdMob ID unit iklan. Anda dapat menemukan parameter ini dengan mengklik Mediasi Chartboost di UI Chartboost.
Buka tab Resource > API Explorer, lalu catat User ID dan Tanda Tangan Pengguna yang terletak di bagian Authentication.
Aktifkan mode pengujian
Anda dapat mengaktifkan mode pengujian di aplikasi dengan membuka tab Apps management dari UI Chartboost, memilih aplikasi Anda dari daftar dan mengklik Edit app settings.
Android
iOS
Dari setelan aplikasi, Anda dapat mengalihkan Mode pengujian di aplikasi.
Setelah mode pengujian diaktifkan, Anda dapat meminta iklan menggunakan ID unit iklan yang dibuat sebelumnya dan menerima iklan pengujian Chartboost.
Setelah dapat menerima iklan pengujian Chartboost, aplikasi Anda akan ditempatkan di Tinjauan Aplikasi Penayang Chartboost. Agar monetisasi di Chartboost dapat berfungsi, peninjauan aplikasi penayang 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
Ikuti langkah-langkah di Setelan GDPR dan Setelan peraturan negara bagian AS untuk menambahkan Chartboost ke daftar partner iklan peraturan negara bagian AS dan GDPR di UI AdMob .
Langkah 3: Impor Chartboost SDK dan adaptor
Download versi terbaru plugin mediasi Google Mobile Ads untuk Chartboost
dari link download di
Changelog dan ekstrak
GoogleMobileAdsChartboostMediation.unitypackage
dari file zip.
Di editor project Unity, pilih Assets > Import Package >
Custom Package, lalu temukan file GoogleMobileAdsChartboostMediation.unitypackage
yang telah Anda download. Pastikan semua file dipilih, lalu klik
Import.
Lalu, pilih Assets > Play Services Resolver > Android Resolver >
Force Resolve. Library Resolver Layanan Unity Play akan melakukan
penyelesaian dependensi dari awal dan menyalin dependensi yang dideklarasikan ke
direktori Assets/Plugins/Android
aplikasi Unity Anda.
Langkah 4: Terapkan setelan privasi di Chartboost SDK
Izin Uni Eropa dan GDPR
Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu telah 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 Regulation (GDPR) Uni Eropa. Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini, Google tidak dapat secara otomatis meneruskan pilihan izin pengguna ke jaringan tersebut.
Plugin mediasi Google Mobile Ads untuk Chartboost versi 3.1.0 menyertakan metode Chartboost.AddDataUseConsent()
. Kode contoh berikut menetapkan izin penggunaan
data ke NonBehavioral
. Jika memilih untuk memanggil metode ini, sebaiknya Anda melakukannya sebelum meminta iklan menggunakan Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
Hukum privasi negara bagian Amerika Serikat
Hukum privasi negara bagian Amerika Serikat mengharuskan pengguna untuk 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 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 dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhannya.
Plugin mediasi Google Mobile Ads untuk Chartboost versi 3.1.0 menyertakan metode Chartboost.AddDataUseConsent()
. Kode contoh berikut menetapkan izin penggunaan
data ke OptInSale
. Jika memilih untuk memanggil metode ini, sebaiknya Anda melakukannya 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 diperlukan kode tambahan untuk integrasi Chartboost.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi
Chartboost
untuk menambahkan ID SKAdNetwork ke file Info.plist
project Anda.
Langkah 6: Uji penerapan Anda
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 izin opsional berikut 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 mendasarinya dari respons iklan menggunakan ResponseInfo
dalam kelas 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 banner 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 interstisial atau reward 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 disimpan dalam cache pada waktu penayangan. |
104 | Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Chartboost. |
105 | Versi OS perangkat lebih rendah dari versi OS minimum Chartboost SDK yang didukung. |
200-299 | Error cache Chartboost SDK. Lihat kode untuk detail selengkapnya. |
300-399 | Chartboost SDK menampilkan error. Lihat kode untuk detail selengkapnya. |
400-499 | Error klik Chartboost SDK. Lihat kode untuk detail selengkapnya. |
Log Perubahan Plugin Mediasi Chartboost Unity
Versi 4.5.0
- Mendukung Adaptor Android Chartboost versi 9.6.0.0.
- Mendukung adaptor iOS Chartboost versi 9.6.0.0.
- Dibuat 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 iOS Chartboost versi 9.5.1.0.
- Dibuat 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 iOS Chartboost versi 9.4.0.0.
- Dibuat 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 iOS Chartboost versi 9.3.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.2.0.
Versi 4.1.1
- Memindahkan konten adaptor ke
GoogleMobileAds/Mediation/Chartboost/
. - Namespace adaptor telah difaktorkan ulang untuk menggunakan
GoogleMobileAds.Mediation.Chartboost
. - Mendukung Adaptor Android Chartboost versi 9.2.1.1.
- Mendukung adaptor iOS Chartboost versi 9.2.0.0.
- Dibuat 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 iOS Chartboost versi 9.2.0.0.
- Dibuat 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 iOS Chartboost versi 8.5.0.2.
- Dibuat 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 iOS Chartboost 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 iOS Chartboost 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 iOS Chartboost versi 8.5.0.1.0.
Versi 3.3.1
- Mendukung Adaptor Android Chartboost versi 8.2.1.0.
- Mendukung adaptor iOS Chartboost versi 8.4.1.1.
Versi 3.3.0
- Mendukung Adaptor Android Chartboost versi 8.2.0.0.
- Mendukung adaptor iOS Chartboost versi 8.4.0.0.
Versi 3.2.0
- Mendukung Adaptor Android Chartboost versi 8.1.0.0.
- Mendukung adaptor iOS Chartboost 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 iOS Chartboost 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 iOS Chartboost versi 8.0.4.0.
Versi 2.0.0
- Mendukung Chartboost adaptor Android versi 7.5.0.0.
- Mendukung adaptor iOS Chartboost versi 8.0.1.1.
Versi 1.3.0
- Mengupdate plugin untuk mendukung Reward API baru.
- Mendukung Chartboost adaptor Android versi 7.3.1.1.
- Mendukung adaptor iOS Chartboost versi 7.5.0.0.
Versi 1.2.0
- Mendukung Chartboost adaptor Android versi 7.3.0.0.
- Mendukung adaptor iOS Chartboost versi 7.3.0.0.
Versi 1.1.1
- Mendukung Chartboost adaptor Android versi 7.2.0.1.
- Mendukung adaptor iOS Chartboost 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()
untuk 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.