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 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:

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

Persyaratan

• GMA Next-Gen SDK terbaru.

• Selesaikan Panduan memulai mediasi.

• Level API Android 24 atau yang lebih tinggi

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

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 AdMob 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, 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 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 AdMob

Mengonfigurasi setelan mediasi untuk unit iklan

Anda perlu 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 lanjutkan ke 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 Done.

Sekarang 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 peraturan GDPR dan 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 AdMob.

Langkah 3: Impor SDK dan adaptor Meta Audience Network

Integrasi Android Studio (direkomendasikan)

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

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")
}

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

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

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

Langkah 4: Terapkan 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 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 AdMob 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:

Berikut adalah 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 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 ini mengisi Deskripsi kolom iklan native untuk NativeAd.

¹ 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.

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.

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: