Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari BIGO Ads SDK menggunakan Mediasi AdMob, yang mencakup integrasi bidding. Dokumen ini membahas cara menambahkan BIGO Ads SDK ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan BIGO Ads SDK dan adapter ke dalam aplikasi iOS.
Integrasi dan format iklan yang didukung
Adaptor mediasi untuk BIGO Ads SDK memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | 1 |
| Air Terjun | |
| Format | |
| Pembukaan aplikasi | |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
| Native | |
1 Integrasi bidding masih dalam versi beta tertutup. Hubungi Account Manager Anda untuk meminta akses.
Persyaratan
- Target deployment iOS 13.0 atau yang lebih tinggi
Google Mobile Ads SDK Terbaru
Selesaikan Panduan memulai mediasi
Langkah 1: Siapkan konfigurasi di UI BIGO Ads SDK
Login ke dasbor BIGO Ads Anda.
Buat aplikasi
Buka tab Inventaris, lalu di bagian tabel Aplikasi dan Situs, pilih tombol + Tambahkan.
Isi bagian formulir lainnya, lalu klik Kirim.
Catat ID Aplikasi Anda.
Membuat slot iklan
Setelah permohonan Anda ditinjau, buka tabel Slot Iklan dan pilih tombol + Tambahkan.
Pilih Server Bidding untuk Auction Type, isi formulir lainnya, lalu klik Submit.
Catat ID Slot
Memperbarui app-ads.txt
Penjual Resmi untuk Aplikasi 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 BIGO Ads SDK, buka tab APP-ads.txt dari Dasbor dan ikuti petunjuk yang ada di tab tersebut.
Langkah 2: Siapkan permintaan BIGO Ads SDK di UI AdMob
Mengonfigurasi setelan mediasi untuk unit iklan
Anda perlu menambahkan BIGO Ads SDK ke konfigurasi mediasi untuk unit iklan Anda.
Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan BIGO Ads SDK sebagai sumber iklan.
Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.
Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.
Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.
Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Done.
Sekarang Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang Anda pilih:
Menambahkan BIGO Ads SDK sebagai sumber iklan
Di bagian kartu Bidding di bagian Sumber Iklan, pilih Tambahkan sumber iklan. Kemudian pilih BIGO Ads SDK .
Klik Cara menandatangani perjanjian kemitraan dan siapkan kemitraan bidding dengan BIGO Ads SDK.
Klik Konfirmasi & setujui, lalu klik Lanjutkan.
Jika sudah memiliki pemetaan untuk BIGO Ads SDK, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.
Selanjutnya, masukkan Slot ID yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.
Menambahkan BIGO TECHNOLOGY PTE LTD 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 BIGO TECHNOLOGY PTE LTD ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI AdMob.
Langkah 3: Impor BIGO Ads SDK dan adapter
CocoaPods
Tambahkan baris berikut ke Podfile project Anda:
pod 'GoogleMobileAdsMediationBigo'Dari command line, jalankan:
pod install --repo-update
Langkah 4: Terapkan setelan privasi di BIGO Ads SDK
Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka untuk penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, dan untuk pengumpulan, pembagian, serta 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 diteruskan ke setiap sumber iklan dalam rantai mediasi Anda. Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.
BIGO Ads SDK secara otomatis membaca izin GDPR yang ditetapkan oleh platform pengelolaan izin, termasuk UMP SDK. Untuk mengetahui informasi selengkapnya, lihat panduan integrasi BIGO Ads SDK tentang GDPR.
Hukum privasi negara bagian Amerika Serikat
Hukum privasi negara bagian AS mewajibkan pemberian hak kepada pengguna untuk menolak "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum), dengan pilihan penolakan yang ditawarkan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan terhadap 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 rangkaian mediasi yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.
Contoh kode berikut menunjukkan cara meneruskan tanda izin ke BIGO Ads SDK. Panggil metode ini sebelum meminta iklan melalui Google Mobile Ads SDK.
Swift
BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)
Objective-C
[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];
Untuk mengetahui informasi selengkapnya, lihat panduan integrasi BIGO Ads SDK di CCPA.
Langkah 5: Tambahkan kode yang diperlukan
Menerapkan SKAdNetwork
Ikuti dokumentasi BIGO Ads SDK
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.
BIGO Ads menyediakan ID Aplikasi dan ID Slot Iklan percobaan untuk iOS untuk membantu pengujian dan integrasi.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan percobaan dari BIGO Ads SDK, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan BIGO Ads SDK (Bidding).
Langkah Opsional
Iklan native
Penayangan iklan
Adaptor BIGO Ads SDK menampilkan iklan native-nya sebagai objek
GADNativeAd. Kolom berikut diisi
untuk
GADNativeAd.
| Kolom | Aset yang selalu disertakan oleh adaptor BIGO Ads SDK |
|---|---|
| Judul | |
| Gambar | |
| Isi | |
| Ikon | |
| Pesan ajakan (CTA) | |
| Rating bintang | |
| Toko | |
| Harga | |
| Pengiklan |
Kode error
Jika adaptor gagal menerima iklan dari BIGO Ads SDK, Anda dapat memeriksa
error yang mendasarinya dari respons iklan menggunakan
GADResponseInfo.adNetworkInfoArray
di bawah class berikut:
GADMediationAdapterBigo
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor BIGO Ads SDK saat iklan gagal dimuat:
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.ads.mediation.bigo | Konfigurasi server tidak memiliki ID aplikasi yang diperlukan. |
| 102 | com.google.ads.mediation.bigo | Konfigurasi iklan tidak valid. |
| 103 | com.google.ads.mediation.bigo | Gagal menampilkan iklan. |
| 104 | com.google.ads.mediation.bigo | Ukuran banner tidak didukung. |
| 105 | com.google.ads.mediation.bigo | Bigo berhasil memuat iklan banner, tetapi tidak ada tayangan iklan. |
| 1000-1100 | Dikirim oleh BIGO Ads SDK | BIGO Ads SDK menampilkan error. Lihat dokumentasi BIGO Ads SDK untuk mengetahui detail selengkapnya. |
Log Perubahan Adapter Mediasi iOS Bigo Ads
Versi 5.2.1.0
- Kompatibilitas terverifikasi dengan BIGO Ads SDK versi 5.2.1.
- Update dependensi Google Mobile Ads SDK minimum ke 13.3.0 untuk menggunakan API privasi baru.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.4.0.
- BIGO Ads SDK versi 5.2.1.
Versi 5.2.0.0
- Kompatibilitas terverifikasi dengan BIGO Ads SDK versi 5.2.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.4.0.
- BIGO Ads SDK versi 5.2.0.
Versi 5.1.2.1
- Adapter kini meneruskan tanda
ageRestrictedTreatmentGoogle Mobile Ads SDK ke COPPA API BIGO Ads SDK.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.3.0.
- BIGO Ads SDK versi 5.1.2.
Versi 5.1.2.0
- Kompatibilitas terverifikasi dengan BIGO Ads SDK versi 5.1.2.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.2.0.
- BIGO Ads SDK versi 5.1.2.
Versi 5.1.1.0
- Kompatibilitas terverifikasi dengan BIGO Ads SDK versi 5.1.1.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.2.0.
- BIGO Ads SDK versi 5.1.1.
Versi 5.1.0.1
- Memperbarui adapter untuk mencegah kegagalan permintaan iklan saat iklan banner dimuat dengan ukuran iklan yang tidak didukung.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.1.0.
- BIGO Ads SDK versi 5.1.0.
Versi 5.1.0.0
- Kompatibilitas yang terverifikasi dengan BIGO Ads SDK versi 5.1.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.1.0.
- BIGO Ads SDK versi 5.1.0.
Versi 5.0.6.2
- Memperbarui dependensi Google Mobile Ads SDK ke versi 13.0.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.0.0.
- BIGO Ads SDK versi 5.0.6.
Versi 5.0.6.1
- Memperbarui versi iOS minimum CocoaPods ke
13.0.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 13.0.0.
- BIGO Ads SDK versi 5.0.6.
Versi 5.0.6.0
- Rilis awal!
- Menambahkan dukungan bidding untuk format iklan layar pembuka aplikasi, banner (termasuk MREC), interstisial, reward, dan native.
- Kompatibilitas yang terverifikasi dengan BIGO Ads SDK versi 5.0.6.
Dibuat dan diuji dengan:
- Google Mobile Ads SDK versi 12.14.0.
- BIGO Ads SDK versi 5.0.6.