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 Ad Manager 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 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
Ad Manager memerlukan User ID dan Tanda Tangan Pengguna Chartboost untuk menyiapkan Ad Manager 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 Ad Manager 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 Ad Manager .
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 > Impor Paket >
Paket Kustom dan temukan GoogleMobileAdsChartboostMediation.unitypackage
yang didownload. Pastikan semua file dipilih dan klik
Impor.
Lalu, pilih Assets > Resolver Layanan Play > Resolver Android >
Paksa Selesaikan. Library Unity Play Services Resolver akan melakukan
resolusi dependensi dari awal dan salin dependensi yang dideklarasikan ke dalam
Direktori Assets/Plugins/Android
aplikasi Unity Anda.
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 Ad Manager 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 Ad Manager 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 Ad Manager 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 iOS Chartboost 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 iOS Chartboost 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 iOS Chartboost 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 Chartboost iOS 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.