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 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 baru
- 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 akan dimonetisasi.
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 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 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
Meta Audience Network SDK dan adaptor dalam file
pubspec.yaml paket Anda:
dependencies:
gma_mediation_meta: ^1.0.0
Integrasi Manual
Download versi terbaru plugin mediasi Google Mobile Ads untuk Meta Audience Network, ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak (beserta 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
Izin Uni Eropa dan GDPR
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 Peraturan (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 memberikan hak kepada pengguna untuk memilih tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum tersebut), dengan pilihan tidak ikut yang diberikan melalui link "Jangan Jual Informasi Pribadi" 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
Mengaktifkan iklan pengujian
Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI Jaringan Audiens Meta.
Memverifikasi iklan percobaan
Untuk memastikan bahwa Anda menerima iklan percobaan dari Jaringan Audiens Meta, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Jaringan Audiens Meta.
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 Jaringan Audiens Meta 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 | 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 | 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 Meta Android 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.