Mengintegrasikan Meta Audience Network dengan bidding

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Meta Audience Network menggunakan mediasi, yang mencakup bidding integrasi. Artikel ini membahas cara menambahkan Meta Audience Network ke bagian konfigurasi mediasi, dan cara mengintegrasikan Jaringan Audiens Meta dan adaptor ke dalam aplikasi Unity .

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Meta Audience Jaringan memiliki kemampuan berikut:

Integrasi
Bidding
{i>Waterfall<i}  1
Format
Banner
Interstisial
Reward
Interstisial Reward

1 Jaringan Audiens Meta menjadi hanya bidding pada tahun 2021.

Persyaratan

  • Google Mobile Ads SDK terbaru
  • Unity 5.6 atau yang lebih baru
  • Plugin mediasi Google Mobile Ads untuk Meta Audience Network 2.11.0 (versi terbaru direkomendasikan)
  • Untuk men-deploy di Android
    • Android API level 21 atau yang lebih tinggi
  • Untuk men-deploy di iOS
    • Target deployment iOS 10.0 atau yang lebih tinggi
    • Meta Audience Network SDK terbaru biasanya memerlukan versi Xcode.
  • Project Unity yang berfungsi yang dikonfigurasi dengan Google Mobile Ads SDK. Lihat Mulai untuk mengetahui detailnya.
  • Selesaikan Panduan memulai mediasi

Langkah 1: Siapkan konfigurasi di UI Jaringan Audiens Meta

Daftar dan login ke halaman Awal Pengelola Bisnis.

Klik Mulai, lalu Buat akun baru.

Lengkapi kolom wajib diisi dengan detail bisnis Anda, lalu klik Berikutnya.

Buat properti

Setelah mengisi informasi yang diperlukan, Anda akan diminta untuk membuat properti untuk aplikasi Anda. Masukkan nama properti yang diinginkan untuk aplikasi Anda, lalu klik Next.

Selanjutnya, pilih platform yang akan dimonetisasi.

Tambahkan detail aplikasi, lalu klik Berikutnya.

Android

iOS

Siapkan akun pembayaran dengan mengklik Tambahkan akun pembayaran baru. Anda akan dialihkan ke halaman baru untuk memasukkan informasi pembayaran. Isi detail yang diperlukan, lalu klik Next.

Pilih Google AdMob sebagai Platform mediasi, lalu klik Buat penempatan.

Pilih format, isi formulir, lalu klik Buat.

Catat ID Penempatan.

Klik Done.

Aktifkan mode pengujian

Lihat panduan Penerapan Jaringan Audiens Pengujian untuk mengetahui petunjuk mendetail tentang cara mengaktifkan iklan pengujian Meta Audience Network.

Langkah 2: Siapkan permintaan Jaringan Audiens Meta 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.

Tambahkan Facebook 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 Facebook ke daftar partner iklan peraturan negara bagian AS dan GDPR di UI AdMob .

Langkah 3: Impor adaptor dan Meta Audience Network SDK

Download versi terbaru plugin mediasi Google Mobile Ads untuk Meta Jaringan Audiens dari link download di Changelog dan ekstrak GoogleMobileAdsFacebookMediation.unitypackage dari file ZIP.

Di editor project Unity, pilih Assets > Impor Paket > Paket Kustom dan temukan GoogleMobileAdsFacebookMediation.unitypackage yang didownload. Pastikan semua file dipilih dan klik Impor.

Pilih Aset > Resolver Layanan Play > Resolver Android > Paksa Selesaikan. Library Resolver Layanan Unity Play kemudian melakukan resolusi dependensi dari awal dan menyalin dependensi yang dideklarasikan ke dalam Direktori Assets/Plugins/Android aplikasi Unity Anda.

Langkah 4: Terapkan setelan privasi di Meta Audience Network SDK

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.

Tinjau panduan Meta untuk mendapatkan informasi tentang GDPR dan periklanan Meta.

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 mengaktifkan 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.

Untuk pengguna di California, tinjau pemrosesan data Meta lainnya.

Langkah 5: Tambahkan kode yang diperlukan

Android

Tidak perlu kode tambahan untuk integrasi Jaringan Audiens Meta.

iOS

Integrasi SKAdNetwork

Ikuti dokumentasi Meta Audience Network untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.

Pelacakan iklan diaktifkan

Jika Anda membangun aplikasi untuk iOS 14 atau yang lebih baru, lihat aplikasi Meta Audience Network petunjuk tentang cara menetapkan Pelacakan Iklan Laporkan.

Langkah 6: Uji penerapan

Aktifkan iklan percobaan

Pastikan Anda mendaftarkan perangkat pengujian Anda untuk AdMob dan mengaktifkan mode pengujian di Meta Audience Network UI.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Meta Audience Network, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan Meta Audience Network (Bidding) sumber iklan.

Langkah opsional

Menyimpan cache di Android 9

Android

Mulai Android 9 (level API 28), dukungan cleartext dinonaktifkan oleh default, yang akan memengaruhi fungsi penyimpanan media caching di Meta Audience SDK Jaringan dan dapat memengaruhi pengalaman pengguna dan pendapatan iklan. Ikuti Meta dokumentasi untuk memperbarui konfigurasi keamanan jaringan di aplikasi Anda.

iOS

Tidak berlaku untuk integrasi iOS.

Kode error

Jika adaptor gagal menerima iklan dari Jaringan Audiens, Anda dapat memeriksa error yang mendasar dari respons iklan dengan menggunakan ResponseInfo dalam class berikut:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh Meta Audience Adaptor jaringan saat iklan gagal dimuat:

Android

Kode error Alasan
101 Parameter server tidak valid (misalnya, ID Penempatan tidak ada).
102 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Jaringan Audiens Meta.
103 Penayang harus meminta iklan dengan konteks Activity.
104 Meta Audience Network SDK gagal diinisialisasi.
105 Penayang tidak meminta Iklan native terpadu.
106 Iklan native yang dimuat adalah objek yang berbeda dari yang diharapkan.
107 Objek Context yang digunakan tidak valid.
108 Iklan yang dimuat tidak memiliki aset iklan native yang diperlukan.
109 Gagal membuat iklan native dari payload bid.
110 Meta Audience Network SDK gagal menayangkan iklan interstisial/reward.
111 Pengecualian ditampilkan saat membuat objek AdView Meta Audience Network.
1000-9999 Meta Audience Network menampilkan error khusus SDK. Lihat Dokumentasi Meta Audience Network untuk mengetahui detail selengkapnya.

iOS

Kode error Alasan
101 Parameter server tidak valid (misalnya, ID Penempatan tidak ada).
102 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Jaringan Audiens Meta.
103 Objek iklan Meta Audience Network gagal diinisialisasi.
104 Meta Audience Network SDK gagal menayangkan iklan interstisial/reward.
105 Pengontrol tampilan root iklan banner adalah nil.
106 Meta Audience Network SDK gagal diinisialisasi.
1000-9999 Meta Audience Network menampilkan error khusus SDK. Lihat Dokumentasi Meta Audience Network untuk mengetahui detail selengkapnya.

Log Perubahan Plugin Mediasi Unity Jaringan Audiens Meta

Versi 3.12.1

Versi 3.12.0

Versi 3.11.0

Versi 3.10.0

Versi 3.9.1

Versi 3.9.0

Versi 3.8.0

Versi 3.7.0

Versi 3.6.1

Versi 3.6.0

Versi 3.5.0

Versi 3.4.0

Versi 3.3.2

Versi 3.3.1

Versi 3.3.0

Versi 3.2.0

Versi 3.1.0

Versi 3.0.0

Versi 2.12.0

Versi 2.11.1

Versi 2.11.0

Versi 2.10.0

Versi 2.9.2

Versi 2.9.1

Versi 2.9.0

Versi 2.8.1

Versi 2.8.0

Versi 2.7.1 (Tidak digunakan lagi, gunakan 2.8.0 atau yang lebih baru)

Versi 2.7.0 (Tidak digunakan lagi, gunakan 2.8.0 atau yang lebih baru)

Versi 2.6.1 (Tidak digunakan lagi, gunakan 2.8.0 atau yang lebih baru)

Versi 2.6.0

Versi 2.5.1

  • Mendukung adaptor Android Facebook versi 5.5.0.0.
  • Mendukung adaptor Facebook iOS versi 5.5.1.0.

Versi 2.5.0

  • Mendukung adaptor Android Facebook versi 5.5.0.0.
  • Mendukung adaptor Facebook iOS versi 5.5.0.0.

Versi 2.4.1

  • Mendukung adaptor Android Facebook versi 5.4.1.1.
  • Mendukung adaptor Facebook iOS versi 5.4.0.0.

Versi 2.4.0

  • Mendukung adaptor Android Facebook versi 5.4.0.0.
  • Mendukung adaptor Facebook iOS versi 5.4.0.0.

Versi 2.3.2

  • Mendukung adaptor Android Facebook versi 5.3.1.2.
  • Mendukung adaptor Facebook iOS versi 5.3.2.0.

Versi 2.3.1

  • Mendukung adaptor Android Facebook versi 5.3.1.0.
  • Mendukung adaptor Facebook iOS versi 5.3.2.0.

Versi 2.3.0

  • Mendukung adaptor Android Facebook versi 5.3.0.0.
  • Mendukung adaptor Facebook iOS versi 5.3.0.0.

Versi 2.2.0

  • Mengupdate plugin untuk mendukung API Reward open-beta yang baru.
  • Mendukung adaptor Android Facebook versi 5.2.0.1.
  • Mendukung adaptor Facebook iOS versi 5.2.0.1.

Versi 2.1.1

  • Mendukung adaptor Android Facebook versi 5.1.0.1.
  • Mendukung adaptor Facebook iOS versi 5.1.0.0.

Versi 2.1.0

  • Mendukung adaptor Android Facebook versi 5.1.0.0.
  • Mendukung adaptor Facebook iOS versi 5.1.0.0.

Versi 2.0.0

  • Mendukung adaptor Android Facebook versi 5.0.1.0.
  • Mendukung adaptor Facebook iOS versi 5.0.1.0.

Versi 1.2.1

  • Mendukung adaptor Android Facebook versi 4.99.3.0.
  • Mendukung adaptor Facebook iOS versi 4.99.3.0.

Versi 1.2.0

  • Mendukung adaptor Android Facebook versi 4.99.1.1.
  • Mendukung adaptor Facebook iOS versi 4.99.2.0.

Versi 1.1.3

  • Mendukung adaptor Android Facebook versi 4.28.2.1.
  • Mendukung adaptor Facebook iOS versi 4.28.1.2.

Versi 1.1.2

  • Memperbaiki potensi konflik dengan plugin mediasi Unity Ads Unity.

Versi 1.1.1

  • Mendukung adaptor Android Facebook versi 4.28.2.0.
  • Mendukung adaptor Facebook iOS versi 4.28.1.1.

Versi 1.1.0

  • Mendukung Facebook Android SDK versi 4.28.1.
  • Mendukung Facebook iOS SDK versi 4.28.1.

Versi 1.0.0

  • Rilis pertama!
  • Mendukung Facebook Android SDK versi 4.27.0.
  • Mendukung Facebook iOS SDK versi 4.27.1.