Mengintegrasikan BIGO Ads SDK dengan mediasi

Pilih platform: Android iOS Unity Android (Lama)

Panduan ini menunjukkan cara menggunakan Google Mobile Ads Unity Plugin untuk memuat dan menampilkan iklan dari BIGO Ads SDK menggunakan mediasi, 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 Unity.

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk BIGO Ads SDK memiliki kemampuan berikut:

Integrasi
Bidding  1
Air Terjun
Format
Membuka Aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native
1 Integrasi bidding masih dalam versi beta tertutup, hubungi Account Manager Anda untuk meminta akses.

Prasyarat

Sebelum Anda melanjutkan, verifikasi 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.
  • Menyiapkan mediasi.

Langkah 1: Siapkan konfigurasi di UI SDK Iklan BIGO

Login ke dasbor BIGO Ads.

Buat aplikasi

Buka tab Inventaris dan di bagian tabel Aplikasi dan Situs, pilih tombol + Tambahkan.

Tambahkan Aplikasi

Isi bagian formulir lainnya, lalu klik Kirim.

Formulir Aplikasi Baru

Catat ID Aplikasi Anda.

Android

ID Aplikasi Android

iOS

ID Aplikasi iOS

Membuat slot iklan

Setelah permohonan Anda ditinjau, buka tabel Slot Iklan dan pilih tombol + Tambahkan.

Tambahkan Slot Iklan

Pilih Bidding Server untuk Jenis Lelang, isi bagian formulir lainnya, lalu klik Kirim.

Formulir Slot Iklan Baru

Catat ID Slot

Android

ID Slot Iklan Android

iOS

ID Slot Iklan 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, buat file app-ads.txt untuk Ad Manager.

Untuk menerapkan app-ads.txt untuk BIGO Ads SDK, buka tab APP-ads.txt dari Dasbor dan ikuti petunjuk yang ada di tab tersebut.

App Ads Txt

Langkah 2: Siapkan permintaan BIGO Ads SDK di UI Ad Manager

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 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 Empathy Technology Pte.Ltd. (BIGO Ads) ke daftar partner iklan peraturan Eropa dan ** BIGOAds** ke daftar partner iklan peraturan negara bagian AS di UI Ad Manager.

Langkah 3: Impor BIGO Ads SDK dan adaptor

OpenUPM-CLI

Jika telah menginstal OpenUPM-CLI, Anda dapat menginstal Plugin Mediasi Google Mobile Ads SDK iklan BIGO Ads untuk Unity ke project dengan menjalankan perintah berikut dari direktori root project:

openupm add com.google.ads.mobile.mediation.bigo

OpenUPM

Di editor project Unity, pilih Edit > Setelan Project > Package Manager untuk membuka Unity Package Manager Settings.

Di tab Scoped Registries, tambahkan OpenUPM sebagai scoped registry dengan detail berikut:

  • Nama: OpenUPM
  • URL: https://package.openupm.com
  • Cakupan: com.google

Detail OpenUPM

Kemudian, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.

Registry Unity

Pilih paket Google Mobile Ads Bigo Mediation, lalu klik Install.

Menginstal dari OpenUPM

Paket Unity

Download plugin mediasi Google Mobile Ads versi terbaru untuk BIGO SDK iklan dari link download di Log perubahan dan ekstrak GoogleMobileAdsBigoMediation.unitypackage dari file ZIP.

Di editor project Unity, pilih Assets > Import Package > Custom Package, lalu temukan file GoogleMobileAdsBigoMediation.unitypackage yang telah Anda download. Pastikan semua file telah dipilih, lalu klik Impor.

Mengimpor dari Unity

Kemudian, pilih Assets > External Dependency Manager > Android Resolver > Force Resolve. Library External Dependency Manager akan melakukan resolusi dependensi dari awal dan menyalin dependensi yang dideklarasikan ke direktori Assets/Plugins/Android aplikasi Unity Anda.

Paksa Penyelesaian

Langkah 4: Terapkan setelan privasi di BIGO Ads SDK

Untuk menerapkan setelan privasi untuk BIGO Ads SDK dan mematuhi peraturan privasi yang relevan, baca bagian berikut.

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 disebarkan ke setiap sumber iklan dalam rantai mediasi Anda.

BIGO SDK iklan otomatis membaca izin GDPR yang ditetapkan oleh Platform Pengelolaan Izin, termasuk UMP SDK. Untuk informasi selengkapnya, lihat panduan GDPR SDK iklan BIGO Ads untuk Android dan iOS.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian Amerika Serikat mewajibkan pemberian hak kepada pengguna untuk menolak "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum ini), dengan pilihan tidak ikut yang disediakan 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 dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Kode contoh berikut menunjukkan cara meneruskan tanda izin ke BIGO SDK iklan. Panggil metode ini sebelum meminta iklan melalui Google Mobile Ads Unity Plugin.

using GoogleMobileAds.Mediation.Bigo.Api;
// ...

Bigo.SetCcpaConsent(true);

Langkah 5: Tambahkan kode yang diperlukan

Android

Tidak diperlukan kode tambahan untuk integrasi BIGO Ads SDK.

iOS

Integrasi 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 Ad Manager.

BIGO Ads menyediakan ID Aplikasi dan ID Slot Iklan percobaan untuk Android dan iOS untuk membantu pengujian dan integrasi.

Memverifikasi iklan pengujian

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari BIGO Ads SDK, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan BIGO Ads SDK (Bidding).

Kode error

Jika adapter gagal menerima iklan dari BIGO Ads SDK, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bawah class berikut:

Android

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

iOS

GADMediationAdapterBigo

Kode dan pesan yang menyertainya ditampilkan oleh adaptor BIGO Ads SDK saat iklan gagal dimuat:

Android

Kode error Domain Alasan
101 com.google.ads.mediation.bigo ID Slot Bigo tidak ada atau kosong.
1000-1100 Dikirim oleh BIGO SDK iklan BIGO SDK iklan menampilkan error. Lihat dokumentasi BIGO Ads SDK untuk mengetahui detail selengkapnya.

iOS

Kode error Domain Alasan
101 com.google.mediation.bigoadapter Konfigurasi server tidak memiliki ID aplikasi yang diperlukan.
102 com.google.mediation.bigoadapter Konfigurasi iklan tidak valid.
103 com.google.mediation.bigoadapter Kegagalan presentasi iklan.
104 com.google.mediation.bigoadapter Ukuran banner tidak didukung.
105 com.google.mediation.bigoadapter Bigo berhasil memuat iklan banner, tetapi tidak memiliki penayangan iklan.
1000-1100 Dikirim oleh BIGO SDK iklan BIGO SDK iklan menampilkan error. Lihat dokumentasi BIGO Ads SDK untuk mengetahui detail selengkapnya.

Log Perubahan Plugin Mediasi Unity SDK Iklan BIGO

Versi 3.1.0 (Dalam proses)

Versi 3.0.0

Versi 2.0.0

Versi 1.1.0

Versi 1.0.0