Setelan iklan terbatas dan ID pihak pertama

Iklan terbatas memungkinkan aplikasi menayangkan iklan saat pengguna Anda tidak memberikan izin untuk membagikan data pribadi. Mode iklan terbatas menghentikan pengumpulan, pembagian, dan penggunaan data pribadi untuk pemilihan iklan. Jika pengguna Anda 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 memperbarui cara menangani setelan untuk meningkatkan kontrol atas privasi dan penggunaan data pengguna. PAL versi 1.90.0 memperkenalkan properti forceLimitedAds dan menghentikan penggunaan properti allowStorage yang ada. Properti ini ada di class ConsentSettings.

Mulai versi 1.90.0, PAL membaca data Transparency and Consent Framework (TCF) dari perangkat untuk menentukan izin pengguna untuk penyimpanan lokal. Perubahan pada pembacaan data TCF ini membuat properti allowStorage yang ada menjadi tidak diperlukan. 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 mengirimkan ID pengguna dalam nonce yang dikirim ke server. Menyetel 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 menyetel 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 sebelumnya. Properti allowStorage yang ada secara default ditetapkan ke nilai false, yang mengaktifkan iklan terbatas. Properti forceLimitedAds secara default memiliki nilai false, yang tidak mengaktifkan iklan terbatas.

Pembaruan untuk Fase 1 penentuan TCF

Rilis PAL HTML5 Fase 1 mempersiapkan Anda untuk bertransisi dari properti ConsentSettings.allowStorage ke penentuan iklan terbatas otomatis berbasis TCF.

Selama fase transisi ini, PAL mempertimbangkan data TCF pengguna Anda, properti allowStorage yang ada, dan properti forceLimitedAds terbaru. Selama fase ini, Anda harus selalu menetapkan properti allowStorage ke nilai true agar PAL dapat menentukan apakah iklan terbatas berlaku berdasarkan data TCF. Jika Anda ingin mengaktifkan iklan terbatas terlepas dari penentuan TCF, tetapkan properti forceLimitedAds ke nilai true.

Selama Fase 1, PAL mengaktifkan iklan terbatas dalam salah satu keadaan berikut:

  • Properti allowStorage adalah nilai false atau tidak ditetapkan. Sebaiknya jangan gunakan setelan ini untuk properti allowStorage, karena hanya untuk mendukung aplikasi yang belum diupdate.
  • Properti forceLimitedAds adalah nilai true.
  • PAL mendeteksi bahwa izin Tujuan 1 TCF IAB (Interactive Advertising Bureau) tidak diberikan.

Tabel berikut menunjukkan semua kemungkinan status dan apakah iklan terbatas diaktifkan:

Izin tujuan 1 TCF Properti allowStorage Properti forceLimitedAds Iklan terbatas diaktifkan
Diberikan Benar Benar Benar
Tidak Diberikan Benar Benar Benar
Diberikan Benar False (default) Salah
Tidak Diberikan Benar False (default) Benar
Diberikan Salah (default) Benar Benar
Tidak Diberikan Salah (default) Benar Benar
Diberikan Salah (default) False (default) Benar
Tidak Diberikan False (default) False (default) Benar

Bersiap untuk penentuan TCF Fase 2

Rilis Fase 2 menghapus fungsi dari properti allowStorage. Kami merencanakan rilis Fase 2 90 hari setelah rilis Fase 1, diperkirakan pada 10 Maret 2026. Sebelum tanggal ini, Anda harus mengupdate penerapan untuk menggunakan parameter ConsentSettings.forceLimitedAds.

Untuk rilis Fase 2, PAL mengaktifkan iklan terbatas hanya berdasarkan tidak adanya izin Tujuan 1 TCF dan properti ConsentSettings.forceLimitedAds opsional:

Izin Tujuan 1 TCF Properti forceLimitedAds Iklan terbatas diaktifkan
Diberikan Benar Benar
Tidak Diberikan Benar Benar
Diberikan Salah (default) Salah
Tidak Diberikan Salah (default) Benar

Cocokkan 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 agar sesuai dengan setelan di Ad Manager. Jika Anda tidak menggunakan API, PAL dapat menyertakan ID dalam nonce yang digunakan dalam permintaan iklan ke server. Namun, Ad Manager dapat menghilangkan 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.

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);