Mengintegrasikan Meta Audience Network dengan bidding

Pilih platform: Android (beta) Baru dipilih Android iOS Unity Flutter

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari Meta Audience Network menggunakan mediasi, yang mencakup integrasi bidding. Panduan ini mencakup cara menambahkan Meta Audience Network ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor Meta Audience Network ke dalam aplikasi Android.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Meta Audience Network memiliki kemampuan berikut:

Integrasi
Bidding
Waterfall  1
Format
Banner 2
Interstisial
Reward
Interstisial Reward
Native

1 Meta Audience Network menjadi khusus bidding pada tahun 2021.
2 Meta Audience Network tidak mendukung banner adaptif anchor dan inline.

Persyaratan

  • Level API Android 24 atau yang lebih tinggi

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 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 untuk memonetisasi.

Tambahkan detail aplikasi Anda, lalu klik Berikutnya.

Siapkan akun pembayaran Anda dengan mengklik Tambahkan akun pembayaran baru. Anda akan dialihkan ke halaman baru untuk memasukkan informasi pembayaran. Lengkapi 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 Pengujian Implementasi Audience Network untuk mengetahui petunjuk mendetail tentang cara mengaktifkan iklan percobaan Meta Audience Network.

Langkah 2: Siapkan permintaan Meta Audience Network di UI Ad Manager

Login ke akun Ad Manager Anda.

Mengaktifkan berbagi sinyal aman

Buka Admin > Setelan global. Buka tab Setelan akun Ad Exchange, lalu tinjau dan aktifkan Berbagi sinyal aman. Klik Simpan.

Membagikan sinyal aman pada permintaan bid

Buka Inventaris > Sinyal Aman. Di bagian Sinyal aman, telusuri Facebook dan aktifkan Aktifkan integrasi aplikasi.

Klik Simpan.

Mengizinkan berbagi sinyal aman untuk Bidding dengan SDK

Buka Penayangan > Setelan saluran permintaan. Di tab Setelan default, aktifkan Izinkan berbagi sinyal aman untuk Bidding SDK.

Klik Simpan.

Mengonfigurasi Meta bidding

Buka Penayangan > Bidder, lalu klik Buka Bidding dengan SDK.

Klik Bidder baru.

Pilih Meta sebagai bidder.

Klik Lanjutkan untuk mengaktifkan Bidding dengan SDK untuk bidder ini.

Klik Selesai.

Mengonfigurasi pemetaan unit iklan

Buka Penayangan > Bidder, lalu klik Buka Bidding dengan SDK.

Pilih perusahaan untuk Meta Audience Network.

Buka tab Pemetaan unit iklan, lalu klik Pemetaan unit iklan baru.

Pilih Unit iklan tertentu. Pilih unit iklan dan format, Aplikasi seluler sebagai Jenis inventaris, dan Aplikasi seluler Anda. Kemudian, masukkan Placement ID yang diperoleh di bagian sebelumnya.

Jika Anda mengonfigurasi pemetaan unit iklan untuk iklan interstisial reward dalam UI Ad Manager, pilih format Reward dan gunakan ID penempatan interstisial reward.

Terakhir, klik Simpan.

Menambahkan Meta ke daftar partner iklan peraturan GDPR dan negara bagian Amerika Serikat

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

Langkah 3: Impor SDK dan adaptor Meta Audience Network

Dalam file gradle level aplikasi, tambahkan implementasi dependencies dan konfigurasi berikut:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrasi manual

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 diteruskan ke setiap sumber iklan dalam rantai mediasi Anda. Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Meta tidak terdaftar di Global Vendor List (GVL) IAB Eropa. Sebagai gantinya, Anda harus menggunakan spesifikasi teknis Izin Tambahan. Untuk mengetahui detail selengkapnya, lihat Komponen Izin Tambahan. Spesifikasi Izin Tambahan berfungsi bersama dengan Transparency & Consent Framework (TCF) versi 2 IAB Eropa. Spesifikasi ini memungkinkan Anda, bersama dengan Platform Pengelolaan Izin (CMP) dan partnernya, mengumpulkan dan mengirimkan sinyal izin tambahan untuk perusahaan yang tercantum dalam daftar Penyedia Teknologi Iklan (ATP) Google, tetapi belum menjadi bagian dari GVL IAB Eropa.

Ikuti panduan dalam dokumentasi Meta untuk GDPR dan iklan Meta.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian AS mewajibkan pemberian hak kepada pengguna untuk memilih tidak ikut "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 rangkaian mediasi yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Ikuti panduan dalam dokumentasi Meta untuk opsi pemrosesan data bagi pengguna di California.

Langkah 5: Tambahkan kode yang diperlukan

Tidak ada kode tambahan yang diperlukan untuk integrasi Meta Audience Network.

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

Iklan native

Beberapa aset iklan native Meta Audience Network tidak dipetakan satu-ke-satu dengan aset iklan native Google. Aset tersebut diteruskan kembali ke penayang dalam paket melalui metode getExtras() di NativeAd. Adaptor mendukung penerusan aset berikut:

Parameter dan nilai permintaan
FacebookMediationAdapter.KEY_ID String. ID unik iklan native
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET String. Konteks sosial iklan

Berikut adalah contoh kode yang menunjukkan cara mengekstrak aset ini:

Contoh:

Kotlin 

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Java 

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Menggunakan iklan native Meta Audience Network tanpa MediaView

Format iklan native Meta Audience Network memerlukan rendering aset MediaView. Jika Anda berencana merender iklan native tanpa aset tersebut, pastikan untuk menggunakan format iklan banner native Meta Audience Network.

Untuk menggunakan iklan banner native Meta Audience Network, Anda harus memilih format Native Banner saat menyiapkan Meta Audience Network dan adaptor akan otomatis memuat format iklan native yang sesuai.

Rendering iklan

Adaptor Jaringan Audiens menampilkan iklan native-nya sebagai objek NativeAd. Kolom berikut diisi untuk kolom NativeAd.

Kolom Diisi oleh adaptor Meta Audience Network
Judul
Gambar 1
Isi
Ikon aplikasi
Pesan ajakan (CTA)
Nama Pengiklan
Rating bintang
Toko
Harga

1 Adaptor Meta Audience Network tidak memberikan akses langsung ke aset gambar utama untuk iklan native-nya. Sebagai gantinya, adaptor mengisi MediaView dengan video atau gambar.

Pelacakan tayangan dan klik

Tabel berikut menunjukkan kapan tayangan dan klik iklan native dicatat oleh GMA Next-Gen SDK.

Perekaman tayangan iklan Klik rekaman
Aset iklan native Meta Audience Network 1 px di layar + persyaratan rendering aset Callback SDK Meta Audience Network

Meta Audience Network memiliki persyaratan rendering aset tertentu agar tayangan iklan dianggap valid, bergantung pada apakah Anda memilih format Native atau Banner Native saat menyiapkan Meta Audience Network.

Format native Meta Audience Network Aset yang diperlukan Class rendering yang diperlukan
Native Tampilan Media MediaView
Banner Native Ikon aplikasi ImageView

Caching di Android 9

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

Kode error

Jika adaptor gagal menerima iklan dari Audience Network, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di bawah class berikut:

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

Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Audience Network saat iklan gagal dimuat:

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 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 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 yang terjadi 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.