Setelan iklan terbatas dan ID pihak pertama

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 23.0.0 memperkenalkan properti forceLimitedAds dan menghapus properti allowStorage. Properti ini berada di ConsentSettings class.

Mulai versi 23.0.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 masih 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.

Mengupdate implementasi PAL untuk penentuan berbasis TCF

PAL Android memerlukan tindakan saat mengupdate ke versi 23.0.0, yang memungkinkan PAL membaca data TCF dari perangkat untuk menentukan izin pengguna untuk penyimpanan lokal. Versi ini juga menambahkan properti forceLimitedAds dan menghapus properti allowStorage. Hanya update aplikasi Anda untuk menggunakan properti forceLimitedAds jika aktivasi iklan terbatas berbasis TCF tidak memenuhi persyaratan aplikasi Anda. Untuk mempelajari penentuan berbasis TCF lebih lanjut tentang, lihat Integrasi penayang dengan TCF IAB Eropa.

Mencocokkan setelan global Google Ad Manager

Jika Anda mengupdate setelan Ad Manager Iklan terbatas terprogram atau ID pihak pertama untuk iklan di aplikasi, 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 ID khusus deteksi traffic tidak valid dan penggunaan penyimpanan lokal untuk iklan terbatas. Jika Anda mengupdate 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 mengupdate setelan ID pihak pertama untuk iklan di aplikasi di Ad Manager dalam Admin > Setelan global, gunakan API ini untuk menonaktifkan ID tersebut di PAL. Perhatikan bahwa setelan ini tidak berlaku untuk penggunaan ID dan penyimpanan lokal untuk deteksi traffic tidak valid.

Contoh berikut menangani privasi pengguna dan penggunaan data dalam implementasi PAL:

ConsentSettings consentSettings = ConsentSettings.builder()
            .directedForChildOrUnknownAge(false)
            .build();
// PAL Android version 23.0.0 introduces
// `ConsentSettings.forceLimitedAds` and removes `ConsentSettings.allowStorage`.
// Best practice is to not set `forceLimitedAds` 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.

GoogleAdManagerSettings adManagerSettings = GoogleAdManagerSettings.builder()
            // Add this line if the "Programmatic limited ads" toggle is turned
            // off in Ad Manager.
            .disableLimitedAdsStorage(true)
            // Add this line if the
            // "First party identifiers for ads on app" toggle is turned
            // off in Ad Manager.
            .disableFirstPartyIdentifiers(true)
            .build();

nonceLoader = new NonceLoader(this, consentSettings, adManagerSettings);