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

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

Memperbarui penerapan 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. Update aplikasi Anda untuk menggunakan properti forceLimitedAds hanya jika aktivasi iklan terbatas berbasis TCF tidak memenuhi persyaratan aplikasi Anda. Untuk mempelajari lebih lanjut penentuan berbasis TCF, lihat Integrasi penayang dengan TCF IAB Eropa.

Cocokkan setelan global Google Ad Manager

Jika Anda memperbarui setelan Ad Manager Iklan terbatas terprogram atau ID pihak pertama untuk iklan di aplikasi, 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 ID 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 ID pihak pertama untuk iklan di aplikasi di Ad Manager dalam setelan Admin > 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 penerapan 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);