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

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

Memperbarui implementasi PAL untuk penentuan berbasis TCF

PAL tvOS memerlukan tindakan saat mengupdate ke versi 3.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 memperbarui 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 menyertakan ID dalam nonce yang digunakan dalam permintaan iklan ke server. Namun, Ad Manager mungkin 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 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 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:

Objective-C

PALSettings *settings = [[PALSettings alloc] init];
// PAL tvOS version 3.0.0 introduces
// `PALSettings.forceLimitedAds` and removes `PALSettings.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.

settings.directedForChildOrUnknownAge = NO;

PALGoogleAdManagerSettings *adManagerSettings = [[PALGoogleAdManagerSettings alloc] init];
// Add this line if the "Programmatic limited ads" toggle is turned off in
// Ad Manager.
adManagerSettings.disableLimitedAdsStorage = YES;
// Add this line if the "First party identifiers for ads on app" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = YES;

self.nonceLoader = [[PALNonceLoader alloc] initWithSettings:settings
                                    googleAdManagerSettings:adManagerSettings];

Swift

let settings = PALSettings()
// PAL tvOS version 3.0.0 introduces
// `PALSettings.forceLimitedAds` and removes `PALSettings.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.

settings.directedForChildOrUnknownAge = false

let adManagerSettings = PALGoogleAdManagerSettings()
// 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 identifiers for ads on app" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = true

self.nonceLoader = PALNonceLoader(
    settings: settings,
    googleAdManagerSettings: adManagerSettings
)