Mengintegrasikan Meta Audience Network dengan bidding

Pilih platform: Android iOS Unity Flutter Android (Lama)

Panduan ini menunjukkan cara menggunakan Google Mobile Ads Unity Plugin 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 adapter ke dalam aplikasi Unity.

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager 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.

Prasyarat

Sebelum melanjutkan, verifikasi hal berikut:

  • Versi Google Mobile Ads Unity Plugin terbaru.
  • Unity Editor versi 5.6 atau yang lebih baru.
  • Plugin mediasi Google Mobile Ads untuk Meta Audience Network 2.11.0 (direkomendasikan versi terbaru).
  • Untuk men-deploy di Android
    • Android API level 24 atau yang lebih baru.
  • Untuk men-deploy di iOS
    • Target deployment iOS 15.0 atau yang lebih baru.
    • Meta Audience Network SDK terbaru biasanya memerlukan Xcode versi terbaru.
  • Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Unity Plugin. Lihat Menyiapkan Google Mobile Ads Unity Plugin untuk mengetahui detailnya.
  • Siapkan mediasi.

    • Langkah 1: Siapkan konfigurasi di UI Meta Audience Network

    Daftar dan login ke halaman Mulai Pengelola Bisnis.

    Klik Mulai, lalu Buat akun baru.

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

    Selanjutnya, pilih platform untuk memonetisasi.

    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 Ad Manager sebagai Platform mediasi, lalu klik Buat penempatan.

    Pilih format, isi formulir, lalu klik Buat.

    Catat ID Penempatan.

    Klik Selesai.

    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 Meta Audience Network, lihat Mengidentifikasi Penjual Resmi dengan app-ads.txt.

    Mengaktifkan mode pengujian

    Lihat panduan Menguji Penerapan Audience Network untuk mendapatkan petunjuk mendetail tentang cara mengaktifkan iklan pengujian Meta Audience Network.

    Langkah 2: Siapkan permintaan Meta Audience Network 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 Meta ke daftar partner iklan GDPR dan peraturan negara bagian Amerika Serikat

    Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan Meta ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI Ad Manager.

    Langkah 3: Impor SDK dan adaptor Meta Audience Network

    OpenUPM-CLI

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

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

    OpenUPM

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

    Di tab Scoped Registries, tambahkan OpenUPM sebagai registry tercakup 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 MetaAudienceNetwork Mediation, lalu klik Install.

    Menginstal dari OpenUPM

    Paket Unity

    Download plugin mediasi Google Mobile Ads versi terbaru untuk Meta Audience Network dari link download di Changelog dan ekstrak GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage dari file ZIP.

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

    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 Selesaikan

    Langkah 4: Terapkan setelan privasi di Meta Audience Network 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 disebarkan ke setiap sumber iklan dalam rantai mediasi Anda.

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

    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 rantai mediasi Anda yang mungkin 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 membangun untuk iOS 14 atau yang lebih tinggi, lihat petunjuk Meta Audience Network tentang cara menetapkan Flag Pelacakan Iklan mereka.

    Langkah 6: Uji penerapan Anda

    Mengaktifkan iklan pengujian

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

    Memverifikasi iklan percobaan

    Untuk memverifikasi bahwa Anda menerima iklan percobaan 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 caching media Meta Audience Network SDK dan dapat memengaruhi pengalaman pengguna serta pendapatan iklan. Ikuti dokumentasi Meta untuk memperbarui 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 bawah class berikut:

    Android

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

    iOS

    GADMAdapterFacebook
GADMediationAdapterFacebook

    Berikut adalah kode dan pesan 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 sesuai dengan ukuran banner yang didukung Meta Audience Network.
    103 Penayang 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 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/rewarded.
    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 sesuai 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/rewarded.
    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 Plugin Mediasi Unity Meta Audience Network

    Versi 3.20.1

    Versi 3.20.0

    Versi 3.19.0

    Versi 3.18.7

    Versi 3.18.6

    Versi 3.18.5

    Versi 3.18.4

    Versi 3.18.3

    Versi 3.18.2

    Versi 3.18.1

    Versi 3.18.0

    Versi 3.17.3

    Versi 3.17.2

    Versi 3.17.1

    Versi 3.17.0

    Versi 3.16.0

    Versi 3.15.0

    Versi 3.14.0

    Versi 3.13.1

    Versi 3.13.0

    Versi 3.12.2

    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 iOS Facebook 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 iOS Facebook versi 5.4.0.0.

    Versi 2.4.0

    • Mendukung adaptor Android Facebook versi 5.4.0.0.
    • Mendukung adaptor iOS Facebook 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 Facebook Android versi 5.3.1.0.
    • Mendukung adaptor Facebook iOS versi 5.3.2.0.

    Versi 2.3.0

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

    Versi 2.2.0

    • Memperbarui plugin untuk mendukung Rewarded API beta terbuka yang baru.
    • Mendukung adaptor Android Facebook versi 5.2.0.1.
    • Mendukung adaptor iOS Facebook 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 iOS Facebook versi 5.1.0.0.

    Versi 2.0.0

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

    Versi 1.2.1

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

    Versi 1.2.0

    • Mendukung adaptor Facebook Android versi 4.99.1.1.
    • Mendukung adaptor iOS Facebook 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.