Panduan ini menunjukkan cara menggunakan Google Mobile Ads Unity Plugin untuk memuat dan menampilkan iklan dari BidMachine menggunakan Mediasi AdMob, yang mencakup integrasi bidding. Panduan ini mencakup cara menambahkan BidMachine ke konfigurasi mediasi unit iklan dan cara mengintegrasikan SDK dan adapter BidMachine ke dalam aplikasi Unity.
Integrasi dan format iklan yang didukung
Adaptor mediasi AdMob untuk BidMachine memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Air Terjun | 1 |
| Format | |
| Membuka Aplikasi | |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
Integrasi Waterfall 1 masih dalam versi beta tertutup. Hubungi Account Manager Anda untuk meminta akses.
Prasyarat
Sebelum melanjutkan, pastikan hal berikut:
- Versi Google Mobile Ads Unity Plugin terbaru.
- Unity Editor versi 2019.4 atau yang lebih baru.
- Untuk men-deploy di Android
- Level API Android 24 atau yang lebih baru.
- Untuk men-deploy di iOS
- Target deployment iOS 13.0 atau yang lebih baru.
- Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Unity Plugin. Lihat Mulai untuk mengetahui detailnya.
- Siapkan Mediasi AdMob.
Langkah 1: Siapkan konfigurasi di UI BidMachine
Login ke dasbor akun BidMachine Anda.
Membuat penempatan baru
Buka tab Sumber, lalu di bagian tabel Sumber, pilih tombol Edit.
Anda akan melihat daftar semua penempatan yang Anda miliki. Untuk membuat penempatan baru, klik tombol Tambahkan Penempatan pada dialog.
Pilih Bidding sebagai Jenis Penempatan. Isi formulir, lalu klik Simpan.
Android
iOS
Terakhir, catat ID Penempatan.
Android
iOS
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,
siapkan file app-ads.txt untuk aplikasi Anda.
Untuk menerapkan app-ads.txt untuk BidMachine, buka tab app-ads.txt
dari Dasbor. Kemudian, salin daftar dan
tambahkan ke file app-ads.txt situs Anda.
Langkah 2: Siapkan permintaan BidMachine di UI AdMob
Mengonfigurasi setelan mediasi untuk unit iklan Anda
Android
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.
Menambahkan BidMachine ke daftar partner iklan untuk GDPR dan peraturan negara bagian Amerika Serikat
Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan BidMachine ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI AdMob.
Langkah 3: Impor BidMachine SDK dan adaptor
Tidak ada kode tambahan yang diperlukan untuk integrasi BidMachine.iOS
Integrasi SKAdNetwork
Ikuti dokumentasi BidMachine tentang
Dukungan SKAdNetwork
untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.
Langkah 6: Uji penerapan Anda
Mengaktifkan iklan pengujian
Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.
Ikuti petunjuk dalam dokumentasi BidMachine untuk Android dan iOS untuk mengaktifkan mode pengujian BidMachine.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan percobaan dari BidMachine, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan BidMachine (Bidding).
Kode error
Jika adapter gagal menerima iklan dari BidMachine, penayang dapat memeriksa
error yang mendasarinya dari respons iklan menggunakan
ResponseInfo di bawah
class berikut:
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
Berikut adalah kode dan pesan yang ditampilkan oleh adaptor BidMachine saat iklan gagal dimuat:
Android
| Kode error | Domain | Alasan |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | ID penempatan yang diterima tidak valid atau kosong. |
| 101 | com.google.ads.mediation.bidmachine | Error selama pengumpulan sinyal: Tidak ada Konfigurasi Data Sinyal yang ditemukan. |
| 102 | com.google.ads.mediation.bidmachine | Format iklan tidak valid diterima selama pengumpulan sinyal. |
| 103 | com.google.ads.mediation.bidmachine | Ukuran iklan yang diminta tidak dapat dipetakan ke bidmachine.BannerSize |
| 104 | com.google.ads.mediation.bidmachine | Masa berlaku panggilan iklan BidMachine yang dimuat telah berakhir. |
| 105 | com.google.ads.mediation.bidmachine | Iklan layar penuh tidak dapat ditampilkan. |
| 106 | com.google.ads.mediation.bidmachine | BidMachine SDK menampilkan callback onAdLoaded() dengan data iklan null. |
iOS
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.mediation.bidmachine | Konfigurasi server tidak memiliki ID penayang yang diperlukan. |
| 102 | com.google.mediation.bidmachine | Permintaan pengumpulan sinyal bidding gagal karena parameter RTB tidak berisi format iklan atau format yang ditentukan tidak didukung. |
| 103 | com.google.mediation.bidmachine | Konfigurasi iklan tidak valid untuk memuat iklan. |
| 104 | com.google.mediation.bidmachine | SDK BidMachine menampilkan iklan non-banner ke metode delegasi BidMachineAdProtocol didLoadAd iklan banner. Seharusnya tidak terjadi. |
| 105 | com.google.mediation.bidmachine | Iklan layar penuh belum siap untuk presentasi. |
| 106 | com.google.mediation.bidmachine | SDK Bid Machine menampilkan iklan non-native ke metode delegasi BidMachineAdProtocol didLoadAd iklan native. Seharusnya tidak terjadi. |
| 107 | com.google.mediation.bidmachine | Gagal memuat salah satu sumber gambar iklan native. |
| 108 | com.google.mediation.bidmachine | BidMachine tidak mendukung ukuran iklan banner ini. |
Log Perubahan Plugin Mediasi BidMachine Unity
Versi 1.5.0
- Mendukung BidMachine Android adapter versi 3.8.0.0.
- Mendukung BidMachine iOS adapter versi 3.8.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.5.0.
Versi 1.4.2
- Mendukung BidMachine Android adapter versi 3.7.1.1.
- Mendukung BidMachine iOS adapter versi 3.7.1.0.1.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.1.0.
Versi 1.4.1
- Mendukung BidMachine Android adapter versi 3.7.0.0.
- Mendukung BidMachine iOS adapter versi 3.7.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.1.0.
Versi 1.4.0
- Mendukung BidMachine Android adapter versi 3.7.0.0.
- Mendukung BidMachine iOS adapter versi 3.7.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.1.0.
Versi 1.3.0
- Mendukung BidMachine Android adapter versi 3.7.0.0.
- Mendukung BidMachine iOS adapter versi 3.6.1.1.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.1.0.
Versi 1.2.1
- Mendukung BidMachine Android adapter versi 3.6.1.0.
- Mendukung BidMachine iOS adapter versi 3.6.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.0.0.
Versi 1.2.0
- Mendukung BidMachine Android adapter versi 3.6.1.0.
- Mendukung BidMachine iOS adapter versi 3.6.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.0.0.
Versi 1.1.0
- Mendukung BidMachine Android adapter versi 3.5.1.2.
- Mendukung BidMachine iOS adapter versi 3.6.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.0.0.
Versi 1.0.2
- Mendukung BidMachine Android adapter versi 3.5.1.2.
- Mendukung BidMachine iOS adapter versi 3.5.1.2.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 11.0.0.
Versi 1.0.1
- Mendukung BidMachine Android adapter versi 3.5.1.1.
- Mendukung BidMachine iOS adapter versi 3.5.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 10.7.0.
Versi 1.0.0
- Rilis Awal!
- Mendukung BidMachine Android adapter versi 3.5.1.0.
- Mendukung BidMachine iOS adapter versi 3.5.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 10.6.0.