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 integrasi bidding. Panduan ini membahas cara menambahkan Meta Audience Network ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan Meta Audience Network dan adaptor ke dalam aplikasi Flutter.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Meta Audience Network memiliki kemampuan berikut:

Integrasi
Bidding
Waterfall  1
Format
Banner
Interstisial
Reward
Interstisial Reward

1 Meta Audience Network menjadi khusus bidding pada tahun 2021.

Persyaratan

  • Google Mobile Ads SDK Terbaru
  • Flutter 3.7.0 atau yang lebih tinggi
  • 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
    • SDK Meta Audience Network terbaru biasanya memerlukan versi Xcode terbaru.
  • Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
  • Selesaikan Panduan memulai mediasi

Langkah 1: Siapkan konfigurasi di UI Jaringan Audiens Meta

Daftar dan login ke halaman Mulai Pengelola Bisnis.

Klik Mulai, lalu Buat akun baru.

Isi kolom yang 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 Berikutnya.

Selanjutnya, pilih platform yang ingin Anda monetisasi.

Tambahkan detail aplikasi Anda, lalu klik Berikutnya.

Android

iOS

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

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

Pilih format, isi formulir, lalu klik Buat.

Catat ID Penempatan.

Klik Selesai.

Mengaktifkan mode pengujian

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

Langkah 2: Siapkan permintaan Meta Audience Network di UI AdMob

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 Meta ke daftar partner iklan GDPR dan peraturan negara bagian AS

Ikuti langkah-langkah di setelan GDPR dan setelan peraturan negara bagian AS untuk menambahkan Meta ke daftar partner iklan GDPR dan peraturan negara bagian AS di UI AdMob.

Langkah 3: Impor SDK dan adaptor Meta Audience Network

Integrasi melalui pub.dev

Tambahkan dependensi berikut dengan versi terbaru adaptor dan SDK Meta Audience Network di file pubspec.yaml paket Anda:

dependencies:
  gma_mediation_meta: ^1.0.0

Integrasi Manual

Download plugin mediasi Google Mobile Ads versi terbaru untuk Meta Audience Network, ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak (dan kontennya) ke project Flutter Anda. Kemudian, referensikan plugin di file pubspec.yaml dengan menambahkan dependensi berikut:

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

Langkah 4: Terapkan setelan privasi di Meta Audience Network SDK

Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu diberikan kepada, dan izin 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 Regulation (GDPR) Uni Eropa. Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini, Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Tinjau panduan Meta untuk mengetahui informasi tentang GDPR dan iklan Meta.

Hukum privasi negara bagian Amerika Serikat

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

Untuk pengguna di California, tinjau opsi pemrosesan data Meta.

Langkah 5: Tambahkan kode yang diperlukan

Android

Tidak diperlukan kode tambahan untuk integrasi Meta Audience Network.

iOS

Integrasi SKAdNetwork

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

Pelacakan iklan diaktifkan

Jika Anda mem-build untuk iOS 14 atau yang lebih baru, periksa petunjuk Meta Audience Network tentang cara menetapkan Flag Pelacakan Iklan.

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI Jaringan Audiens Meta.

Memverifikasi iklan percobaan

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

Langkah opsional

Penyimpanan dalam cache di Android 9

Android

Mulai Android 9 (level API 28), dukungan cleartext dinonaktifkan secara default, yang akan memengaruhi fungsi penyimpanan dalam cache media Meta Audience Network SDK dan dapat memengaruhi pengalaman pengguna serta pendapatan iklan. Ikuti dokumentasi Meta untuk mengupdate konfigurasi keamanan jaringan di aplikasi Anda.

iOS

Tidak berlaku untuk integrasi iOS.

Kode error

Jika adaptor gagal menerima iklan dari Audience Network, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bagian 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 adaptor Meta Audience Network 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 Meta Audience Network.
103 Penerbit harus meminta iklan dengan konteks Activity.
104 SDK Meta Audience Network gagal diinisialisasi.
105 Penayang tidak meminta iklan native Terpadu.
106 Iklan native yang dimuat adalah objek yang berbeda dengan 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 SDK Meta Audience Network gagal menampilkan iklan interstisial/reward.
111 Pengecualian ditampilkan saat membuat objek AdView Jaringan Audiens Meta.
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 Meta Audience Network.
103 Objek iklan Meta Audience Network gagal diinisialisasi.
104 SDK Meta Audience Network gagal menampilkan iklan interstisial/reward.
105 Pengontrol tampilan root iklan banner adalah nil.
106 SDK Meta Audience Network gagal diinisialisasi.
1000-9999 Meta Audience Network menampilkan error khusus SDK. Lihat dokumentasi Meta Audience Network untuk mengetahui detail selengkapnya.

Log Perubahan Adaptor Mediasi Flutter Meta Audience Network

Versi Berikutnya

  • Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.2.0.

1.1.0

  • Kompatibilitas terverifikasi dengan adaptor Android Meta versi 6.17.0.0
  • Kompatibilitas terverifikasi dengan adaptor iOS Meta versi 6.15.2.0
  • Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.

1.0.1

  • Menambahkan class dart untuk memungkinkan analisis kompatibilitas yang benar dengan platform host
  • Kompatibilitas terverifikasi dengan adaptor Android Meta versi 6.17.0.0
  • Kompatibilitas terverifikasi dengan adaptor iOS Meta versi 6.15.0.0
  • Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.

1.0.0

  • Rilis awal.
  • Kompatibilitas terverifikasi dengan adaptor Android Meta versi 6.17.0.0
  • Kompatibilitas terverifikasi dengan adaptor iOS Meta versi 6.15.0.0
  • Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.0.0.