Iklan terbatas memungkinkan aplikasi menayangkan iklan saat pengguna tidak memberikan izin untuk membagikan data pribadi. Mode iklan terbatas menghentikan pengumpulan, pembagian, dan penggunaan data pribadi untuk pemilihan iklan. Jika pengguna memilih untuk tidak membagikan data pribadi, fitur ini memungkinkan iklan terus ditayangkan.
Panduan ini membahas penggunaan setelan iklan terbatas di aplikasi Anda, dan mencocokkan perilaku aplikasi dengan setelan global jaringan Google Ad Manager Anda.
Mengonfigurasi setelan iklan terbatas klien
PAL versi 1.109.0 memperkenalkan properti forceLimitedAds dan menghapus properti allowStorage. Properti ini berada di
ConsentSettings
class.
Mulai versi 1.109.0, PAL membaca data Transparency and Consent Framework (TCF) dari perangkat untuk menentukan izin pengguna untuk penyimpanan lokal. Sebelumnya, aplikasi Anda bertanggung jawab untuk menentukan izin penyimpanan. Aplikasi Anda tetap harus meneruskan parameter gdpr= dan gdpr_consent= di URL tag iklan.
Jika penentuan otomatis berbasis TCF tidak memadai, tetapkan properti
forceLimitedAds secara langsung di aplikasi Anda. Untuk mengetahui detailnya, lihat
Integrasi penayang dengan TCF IAB Eropa.
Menetapkan properti forceLimitedAds ke nilai true akan mencegah PAL menyimpan atau mengirim ID pengguna dalam nonce yang dikirim ke server.
Menetapkan properti forceLimitedAds ke nilai true sama dengan menambahkan parameter ltd=1 ke URL permintaan iklan di IMA (Interactive Media Ads) SDK. Untuk mengetahui detail tentang iklan terbatas, lihat
ltd (Iklan terbatas).
Saat Anda menetapkan properti forceLimitedAds ke nilai true, PAL akan menyertakan parameter ltd=1 dalam nonce.
Untuk mempertahankan perilaku saat ini di aplikasi, Anda mungkin perlu mengupdate implementasi, meskipun Anda belum pernah menetapkan properti allowStorage.
Properti allowStorage ditetapkan secara default ke nilai false, yang mengaktifkan iklan terbatas. Properti forceLimitedAds ditetapkan secara default ke nilai false, yang tidak mengaktifkan iklan terbatas.
Mencocokkan setelan global Google Ad Manager
Jika Anda memperbarui setelan Ad Manager Iklan terbatas terprogram atau Cookie pihak pertama untuk iklan di web, gunakan API baru ini untuk mencocokkan setelan di Ad Manager. Jika Anda tidak menggunakan API, PAL mungkin akan menyertakan ID dalam nonce yang digunakan dalam permintaan iklan ke server. Namun, Ad Manager mungkin akan menghapus sinyal berdasarkan setelan di Ad Manager.
API-nya adalah sebagai berikut:
disableLimitedAdsStorage- menonaktifkan cookie khusus deteksi traffic tidak valid dan penggunaan penyimpanan lokal untuk iklan terbatas. Jika Anda memperbarui setelan Iklan terbatas terprogram di Ad Manager dalam Admin > Setelan global, gunakan API ini untuk menonaktifkan penggunaan penyimpanan lokal untuk iklan terbatas di PAL. Perhatikan bahwa setelan ini tidak berlaku untuk iklan non-terbatas.disableFirstPartyIdentifiers- menonaktifkan ID pihak pertama yang digunakan untuk pemilihan iklan. Jika Anda memperbarui setelan Cookie pihak pertama untuk iklan di web di Ad Manager dalam Admin > Setelan global, gunakan API ini untuk menonaktifkan ID tersebut di PAL. Perhatikan bahwa setelan ini tidak berlaku untuk penggunaan cookie dan penyimpanan lokal untuk deteksi traffic tidak valid.
Menangani izin pengguna di aplikasi Anda
Contoh berikut menangani privasi pengguna dan penggunaan data dalam penerapan PAL:
const consentSettings = new goog.pal.ConsentSettings();
consentSettings.allowStorage = true;
// During the PAL Phase 1 release, best practice is to always set the
// `allowStorage` property to a `true` value to allow PAL to automatically
// determine whether limited ads applies based on the TCF data.
// To enable limited ads regardless of the TCF determination, set the
// `forceLimitedAds` property to a `true` value.
const adManagerSettings = new goog.pal.GoogleAdManagerSettings();
// Add this line if the "Programmatic limited ads" toggle is turned off in
// Ad Manager.
adManagerSettings.disableLimitedAdsStorage = true;
// Add this line if the "First party cookies for ads on web" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = true;
const nonceLoader = new goog.pal.NonceLoader(consentSettings, adManagerSettings);