Mengintegrasikan Meta Audience Network dengan bidding

Pilih platform: Android (beta) Android iOS Unity Flutter

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

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Meta Audience Network memiliki kemampuan berikut:

¹ Meta Audience Network hanya menjadi bidding pada tahun 2021.
² Meta Audience Network tidak mendukung banner adaptif yang disematkan dan inline.

Persyaratan

• Terbaru GMA Next-Gen SDK.

• Selesaikan panduan Memulai mediasi .

• Android API level 24 atau yang lebih tinggi

• Adaptor Meta Audience Network 5.10.0.0 atau yang lebih tinggi (versi terbaru direkomendasikan)

Langkah 1: Menyiapkan 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.

Membuat 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 Anda. 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.

Memperbarui app-ads.txt

Penjual Resmi untuk Aplikasi 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 yang signifikan pada pendapatan iklan, Anda harus menerapkan file app-ads.txt. Jika belum melakukannya, siapkan file app-ads.txt untuk aplikasi Anda.

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 mengetahui petunjuk mendetail tentang cara mengaktifkan iklan pengujian Meta Audience Network.

Langkah 2: Menyiapkan permintaan Meta Audience Network di UI AdMob

Mengonfigurasi setelan mediasi untuk unit iklan Anda

Anda harus menambahkan Meta Audience Network ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu langsung buka Menambahkan Meta Audience Network sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Selesai.

Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang Anda pilih:

Menambahkan Meta Audience Network sebagai sumber iklan

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 Amerika Serikat untuk menambahkan Meta ke daftar partner iklan peraturan Eropa dan negara bagian Amerika Serikat di UI AdMob.

Langkah 3: Mengimpor Meta Audience Network SDK dan adaptor

Integrasi Android Studio (direkomendasikan)

Di file gradle level aplikasi Anda, tambahkan dependensi dan konfigurasi penerapan berikut:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    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")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    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

• Download Meta Audience Network SDK versi terbaru untuk Android . Ekstrak AudienceNetwork.aar di folder AudienceNetwork/bin dan tambahkan ke project Anda.

• Buka artefak adaptor Meta Audience Network di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor Meta Audience Network, dan tambahkan ke project Anda.

Langkah 4: Menerapkan setelan privasi di Meta Audience Network SDK

Izin Uni Eropa dan GDPR

Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna Anda di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka atas penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, serta atas pengumpulan, pembagian, dan 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. 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) IAB Eropa versi 2. Spesifikasi ini memungkinkan Anda, bersama dengan Platform Pengelolaan Izin (CMP) dan partner, 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 Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada pengguna untuk menolak "penjualan" "informasi pribadi" mereka (sebagaimana kedua istilah tersebut didefinisikan dalam hukum), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan 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.

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

Langkah 5: Menambahkan kode yang diperlukan

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

Langkah 6: Menguji penerapan Anda

Mengaktifkan iklan pengujian

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

Memverifikasi iklan pengujian

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

Iklan native

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

Berikut contoh kode yang menunjukkan cara mengekstrak aset ini:

Contoh:

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

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 mengharuskan MediaView aset dirender. 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 Audience Network menampilkan iklan native sebagai NativeAd objek. Adaptor ini mengisi Deskripsi kolom iklan native berikut untuk NativeAd.

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

Pelacakan tayangan dan klik

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

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

Caching di Android 9

Mulai dari Android 9 (API level 28), dukungan cleartext dinonaktifkan secara default, yang akan memengaruhi fungsi caching 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 class berikut:

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

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