Sınırlı reklamlar, kullanıcılarınız kişisel verilerini paylaşmayı kabul etmediğinde uygulamaların reklam yayınlamasına olanak tanır. Sınırlı reklamlar modu, reklam seçimi için kişisel verilerin toplanmasını, paylaşılmasını ve kullanılmasını durdurur. Kullanıcılarınız kişisel verilerini paylaşmamayı seçerse bu özellik, reklamların yayınlanmaya devam etmesini sağlar.
Bu kılavuzda, uygulamanızda sınırlı reklam ayarlarını kullanma ve uygulama davranışını Google Ad Manager ağınızın genel ayarlarıyla eşleştirme konuları ele alınmaktadır.
İstemci sınırlı reklam ayarlarını yapılandırma
PAL, kullanıcı gizliliği ve veri kullanımı üzerinde daha fazla kontrol sağlamak için ayarları işleme şeklini güncelliyor. PAL 1.90.0 sürümünde forceLimitedAds özelliği kullanıma sunuluyor ve mevcut allowStorage özelliği kullanımdan kaldırılıyor. Bu özellikler ConsentSettings sınıfındadır.
PAL, 1.90.0 sürümünden itibaren yerel depolama için kullanıcı rızasını belirlemek üzere cihazdan Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) verilerini okur. TCF verilerini okumayla ilgili bu değişiklik, mevcut allowStorage özelliğini gereksiz hale getiriyor. Uygulamanızın, reklam etiketi URL'sindeki gdpr= ve gdpr_consent= parametrelerini yine de iletmesi gerekir.
TCF'ye dayalı otomatik belirleme yeterli değilse forceLimitedAds özelliğini doğrudan uygulamanızda ayarlayın. Ayrıntılı bilgi için IAB Europe TCF ile yayıncı entegrasyonu başlıklı makaleyi inceleyin.
forceLimitedAds özelliğinin true değerine ayarlanması, PAL'ın sunucuya gönderilen nonce'ta kullanıcı tanımlayıcılarını depolamasını veya göndermesini engeller.
forceLimitedAds özelliğini true değerine ayarlamak, IMA (Interactive Media Ads) SDK'larındaki reklam isteği URL'sine ltd=1 parametresini eklemekle aynıdır. Sınırlı reklamlar hakkında ayrıntılı bilgi için ltd (Sınırlı reklamlar) başlıklı makaleyi inceleyin.
forceLimitedAds özelliğini true değerine ayarladığınızda PAL, nonce'a ltd=1 parametresini dahil eder.
Daha önce allowStorage özelliğini ayarlamamış olsanız bile, mevcut davranışını aynı tutmak için uygulamanızı güncellemeniz gerekebilir.
Mevcut allowStorage özelliği, sınırlı reklamları false etkinleştiren bir değere ayarlanır. forceLimitedAds özelliği varsayılan olarak false değerine ayarlanır. Bu değer, sınırlı reklamları etkinleştirmez.
TCF belirleme sürecinin 1. aşamasıyla ilgili güncelleme
PAL HTML5 1. aşama sürümü, ConsentSettings.allowStorage özelliğinden sınırlı reklamların otomatik TCF tabanlı olarak belirlenmesine geçiş yapmanızı sağlar.
Bu geçiş aşamasında PAL, kullanıcınızın TCF verilerini, mevcut allowStorage mülkünü ve en son forceLimitedAds mülkünü dikkate alır.
Bu aşamada, PAL'nin TCF verilerine göre sınırlı reklamların geçerli olup olmadığını belirlemesine olanak tanımak için allowStorage özelliğini her zaman bir true değerine ayarlamanız gerekir. TCF belirlemesinden bağımsız olarak sınırlı reklamları etkinleştirmek istiyorsanız forceLimitedAds özelliğini true değerine ayarlayın.
1. aşamada PAL, aşağıdaki durumlardan herhangi birinde sınırlı reklamları etkinleştirir:
allowStorageözelliği birfalsedeğeri veya ayarlanmamış. Bu ayar yalnızca güncellenmemiş uygulamaları desteklemek için kullanıldığındanallowStoragemülkünde bu ayarı kullanmanızı önermiyoruz.forceLimitedAdsözelliği birtruedeğeridir.- PAL, IAB (Interactive Advertising Bureau) TCF 1. Amaç izninin verilmediğini algılar.
Aşağıdaki tabloda, olası tüm durumlar ve sınırlı reklamların etkin olup olmadığı gösterilmektedir:
| TCF 1. amaç izni | allowStorage mülkü |
forceLimitedAds mülkü |
Sınırlı reklamlar etkinleştirildi |
|---|---|---|---|
| İzin verildi | Doğru | Doğru | Doğru |
| İzin Verilmedi | Doğru | Doğru | Doğru |
| İzin verildi | Doğru | Yanlış (varsayılan) | Yanlış |
| İzin Verilmedi | Doğru | Yanlış (varsayılan) | Doğru |
| İzin verildi | Yanlış (varsayılan) | Doğru | Doğru |
| İzin Verilmedi | Yanlış (varsayılan) | Doğru | Doğru |
| İzin verildi | Yanlış (varsayılan) | Yanlış (varsayılan) | Doğru |
| İzin Verilmedi | Yanlış (varsayılan) | Yanlış (varsayılan) | Doğru |
TCF'nin 2. aşama belirleme sürecine hazırlanın
2. aşama sürümünde allowStorage özelliğindeki işlevler kaldırılıyor. 2. aşamanın, 1. aşama yayınlarından 90 gün sonra (tahmini olarak 10 Mart 2026) yayınlanması planlanmaktadır. Bu tarihten önce uygulamanızı ConsentSettings.forceLimitedAds parametresini kullanacak şekilde güncellemeniz gerekir.
2. aşama sürümünde PAL, yalnızca TCF 1. Amaç izninin olmaması ve isteğe bağlı ConsentSettings.forceLimitedAds mülküne dayalı olarak sınırlı reklamları etkinleştirir:
| TCF ile İlgili 1. Amaç İçin Kullanıcı Rızası | forceLimitedAds mülkü |
Sınırlı reklamlar etkin |
|---|---|---|
| İzin verildi | Doğru | Doğru |
| İzin Verilmedi | Doğru | Doğru |
| İzin verildi | Yanlış (varsayılan) | Yanlış |
| İzin Verilmedi | Yanlış (varsayılan) | Doğru |
Google Ad Manager genel ayarlarını eşleştirme
Ad Manager ayarlarını Programatik sınırlı reklamlar veya Web'deki reklamlar için birinci taraf çerezleri olarak güncellerseniz Ad Manager'daki ayarlarla eşleşmek için bu yeni API'leri kullanın. API'leri kullanmıyorsanız PAL, sunucuya yapılan reklam isteğinde kullanılan nonce'a tanımlayıcıları ekleyebilir. Ancak Ad Manager, Ad Manager'daki ayarlara göre sinyalleri bırakabilir.
API'ler şunlardır:
disableLimitedAdsStorage- Yalnızca geçersiz trafik algılama çerezlerini devre dışı bırakır ve sınırlı reklamlar için yerel depolama alanının kullanımını engeller. Ad Manager'da Yönetici > Global ayarlar bölümündeki Programatik sınırlı reklamlar ayarını güncellediyseniz PAL'de sınırlı reklamlar için yerel depolama alanının kullanımını devre dışı bırakmak üzere bu API'yi kullanın. Bu ayarın sınırlı olmayan reklamlar için geçerli olmadığını unutmayın.disableFirstPartyIdentifiers- Reklam seçimi için kullanılan birinci taraf tanımlayıcıları devre dışı bırakır. Ad Manager'da Yönetici > Genel ayarları bölümünde Web'deki reklamlarda birinci taraf çerezleri ayarını güncellediyseniz PAL'de bu tür tanımlayıcıları devre dışı bırakmak için bu API'yi kullanın. Bu ayarın, geçersiz trafik algılama için çerezlerin ve yerel depolama alanının kullanımı için geçerli olmadığını unutmayın.
Uygulamanızda kullanıcı iznini işleme
Aşağıdaki örnekte, PAL uygulamasında kullanıcı gizliliği ve veri kullanımı ele alınmaktadır:
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);