Consent Mode v2

Google Consent Mode v2 ve Google Tag Manager

Veribenim çerez banner'ı ile Google Consent Mode v2'yi GTM ile ya da GTM olmadan kurun ve doğrulayın.

İçindekiler

Not: Bu sayfa, güncel Veribenim banner script'inin ve Veribenim Consent Mode GTM şablonunun gerçekte ne yaptığını anlatır. Google'ın tanımları kullanıldıkları yerde kaynağıyla verilmiştir.

Google Consent Mode, sitenin Google etiketlerine (Google Analytics 4, Google Ads, Floodlight) ziyaretçinin hangi depolama ve veri kullanımına izin verdiğini bildirmesini sağlar. Etiketler davranışlarını bu rıza durumlarına göre ayarlar. Sürüm 2, reklam için iki rıza türü ekler: ad_user_data ve ad_personalization.

Veribenim bu durumları sizin yerinize gönderir. Banner script'i çalıştığı anda varsayılanları ayarlar, sonraki sayfa açılışlarında ziyaretçinin kayıtlı kararını yeniden uygular ve ziyaretçi her kabul, ret, değişiklik veya geri çekmede güncelleme gönderir.

Rıza türüVeribenim kategorisiGoogle'ın tanımı
analytics_storageAnalitikAnalitikle ilgili depolama, ör. ziyaret süresi.
ad_storagePazarlamaReklamla ilgili depolama.
ad_user_dataPazarlamaÇevrim içi reklam için kullanıcı verisinin Google'a gönderilmesine rıza.
ad_personalizationPazarlamaKişiselleştirilmiş reklama rıza.
functionality_storageİşlevselSitenin işlevini destekleyen depolama, ör. dil ayarı.
personalization_storageİşlevselKişiselleştirmeyle ilgili depolama, ör. video önerileri.
security_storageHer zaman izinliGüvenlikle ilgili depolama, ör. kimlik doğrulama ve dolandırıcılık önleme.

Not: Sinyaller yalnızca kategori adından değil, Veribenim çerez envanterinizdeki her çerezin "Rıza Sinyali" alanından türetilir. Envanterde olmayan bir sağlayıcının sinyali, ziyaretçi "Tümünü Kabul Et" dese bile hiçbir zaman granted olmaz. Envanteri eksiksiz tutun.

Script çalıştığında aşağıdaki default komutunu dataLayer'a ekler; kendisinden sonra yüklenen tüm Google etiketlerinden önce. ads_data_redaction her zaman ayarlanır; url_passthrough yalnızca site için açtıysanız ayarlanır (varsayılan kapalı).

js
gtag('consent', 'default', {
  'ad_storage':              'denied',
  'analytics_storage':       'denied',
  'ad_user_data':            'denied',
  'ad_personalization':      'denied',
  'functionality_storage':   'denied',
  'personalization_storage': 'denied',
  'security_storage':        'granted',
  'wait_for_update':         2000
});
gtag('set', 'ads_data_redaction', true);
// yalnızca sitede URL passthrough açıksa:
gtag('set', 'url_passthrough', true);
  • Kayıtlı ve hâlâ geçerli kararı olan ziyaretçi: default'un hemen ardından, aynı senkron akışta gtag('consent', 'update', …) gönderilir ve vbn_consent_source: 'restored' ile vbn_consent_update olayı itilir.
  • Ziyaretçi karar verir ya da kararını değiştirir: gtag('consent', 'update', …) ve vbn_consent_source: 'user' ile vbn_consent_update olayı.
  • Aynı Google yükü, şablonun Default etiketi kaydettiyse window.__vbn_gtm_onConsentChange üzerinden GTM şablonuna da iletilir.
js
{
  event: 'vbn_consent_update',
  vbn_consent: {
    analytics_storage:       'granted',
    ad_storage:              'denied',
    ad_user_data:            'denied',
    ad_personalization:      'denied',
    functionality_storage:   'granted',
    personalization_storage: 'granted'
  },
  vbn_consent_source: 'user'   // kayıtlı karar sayfa açılışında yeniden uygulanınca 'restored'
}

Kurulum

Script adresinizi Veribenim panelinden kopyalayın: sitenizi seçin, ardından "Entegrasyon Kodu" sayfası. Aşağıdaki iki yol da aynı script'i kullanır; ayrıca rıza kodu yazmanız gerekmez.

Script sırası ve async

Rıza varsayılanı, Veribenim script'inin çalıştığı anda ayarlanır. Ondan önce çalışan Google etiketleri varsayılan olmadan çalışır. Veribenim script'ini <head> içinde, Google etiketinden ya da GTM konteyner kodundan önce ve async olmadan koyun. GTM şablonunun kendi gereksinimi de budur: banner script'i <head> içinde GTM kodundan önce ve async olmadan durmalı, her sayfada ilk o çalışmalı.

Entegrasyon sayfasındaki HTML kodunda async vardır. Google etiketi olmayan bir sayfada bu sorun değildir. Google etiketi olan sayfada async'i kaldırın ve script'i en başa koyun.

Yol A: Google Tag Manager olmadan (gtag.js)

Mevcut Google etiketinizi olduğu gibi bırakın ve Veribenim script'ini üstüne ekleyin. Kendi gtag('consent', …) çağrılarınızı eklemeyin; default ve update'i banner script'i gönderir.

html
<head>
  <!-- 1. Önce Veribenim, async OLMADAN -->
  <script src="https://bundles.veribenim.com/siteniz.js"></script>

  <!-- 2. Google etiketiniz (gtag.js) -->
  <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
  <script>
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());
    gtag('config', 'G-XXXXXXXXXX');
  </script>
</head>

Google Consent Mode v2 köprüsü varsayılan olarak açıktır; Entegrasyon → "Rıza Sinyali Köprüleri" altında görünür. Yalnızca sitenizde aynı rıza komutlarını gönderen başka bir kaynak varsa kapatın.

Yol B: Google Tag Manager ve Veribenim şablonu ile

html
<head>
  <!-- 1. Önce Veribenim, async OLMADAN -->
  <script src="https://bundles.veribenim.com/siteniz.js"></script>

  <!-- 2. Google Tag Manager konteyner kodu (değiştirmeden) -->
  <script>(function(w,d,s,l,i){ /* ... GTM-XXXXXXX ... */ })(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
</head>
  • 1. Şablonu içe aktarın. GitHub'daki veribenim.gtm-template deposundan template.tpl dosyasını indirin. GTM'de Şablonlar → Etiket Şablonları → Yeni'yi açın, ⋮ menüsünden İçe aktar'ı seçin, template.tpl'yi seçip kaydedin.
  • 2. Default etiketi (zorunlu). Etiketler → Yeni → etiket türü "Veribenim Consent Mode", Consent command = Default. Tetikleyici: Consent Initialization - All Pages.
  • 3. Update etiketi (önerilir). Etiketler → Yeni → "Veribenim Consent Mode", Consent command = Update. Tetikleyici: olay adı vbn_consent_update olan Özel Etkinlik tetikleyicisi.
  • 4. Konteyneri yayınlayın ve doğrulayın (bkz. Doğrulama).

Not: Şablon ileride GTM Community Template Gallery'de yayınlanırsa oradan da eklenebilecek; etiketler ve tetikleyiciler aynı kalır.

Şablon alanları

AlanAnlamı
Consent commandDefault: varsayılanları ayarla ve banner'ı dinle. Update: dataLayer'daki vbn_consent'i uygula.
Default consent settingsHer bölge için bir satır. Region: ISO 3166-2 kodları, virgülle (ör. TR, DE, US-CA); boş = kendi satırı olmayan tüm bölgeler; en özgül bölge kazanır. Granted / Denied: virgülle ayrılmış rıza türleri. Yazılmayan tür ayarlanmaz; iki sütunda da geçen tür reddedilir. Varsayılan satır altı türün hepsini reddeder.
Wait for updateHer satırın wait_for_update değeri (ms). Varsayılan 500.
Redact ads dataads_data_redaction'ı ayarlar. Varsayılan açık; banner script'i de her zaman açar.
Pass ad click information through URLsurl_passthrough'u ayarlar. Varsayılan kapalı; sitenizdeki URL passthrough ayarıyla aynı tutun.
  • Yalnızca banner'ın gönderdiği rıza türleri güncellenir; eksik anahtar tamamlanmaz.
  • granted / denied dışındaki değerler ve bilinmeyen rıza türleri yok sayılır ve loglanır.
  • security_storage her zaman granted'tır, hiç reddedilmez.
  • Banner script'i sayfada yoksa Default etiketi varsayılanları yine ayarlar, ardından Preview'da Failed gösterir; sorun gizlenmez.
  • Şablon kuruluyken tek kaynak kalsın diye banner'ın kendi Google Consent Mode köprüsünü kapatabilirsiniz. Köprü kapalıyken de banner şablonu çağırır ve vbn_consent_update olayını iter.
  • Şablon kullanmıyor musunuz? Kendi GTM etiketleriniz vbn_consent_update olayını dinleyip dataLayer'dan vbn_consent'i okuyabilir.

Basic ve Advanced mod

Modu Veribenim panelinde seçin: siteniz → Entegrasyon Kodu → "Google Consent Mode" kartı. URL passthrough anahtarı da aynı karttadır. Değişiklik banner dosyanız yeniden üretildikten sonra geçerli olur; panel kaydederken bunu belirtir. Hangi modun sitenize uygun olduğu hukuki bir değerlendirmedir; Google iki modu da destekler.

ModRıza öncesi ne olur
advancedYeni ve mevcut siteler için varsayılan. Google etiketleri sayfa açılınca yüklenir. Rıza denied iken çerez kullanmaz, rıza durumuyla birlikte çerezsiz ping gönderir.
basicBanner script'i Google etiket script'lerini ilgili rıza gelene kadar engeller. Ziyaretçi reddederse Google'a hiçbir veri gitmez.

Basic modun engellediği adresler

Script adresi şunu içeriyorsaBeklediği rıza
googletagmanager.com/gtag/js?id=G-Analitik
googletagmanager.com/gtag/js?id=UA-Analitik
googletagmanager.com/gtag/js?id=AW-Pazarlama
googletagmanager.com/gtag/js?id=DC-Pazarlama
googletagmanager.com/gtag/jsAnalitik veya Pazarlama (kimlik adresten anlaşılamıyor)
google-analytics.comAnalitik
googleadservices.comPazarlama
doubleclick.netPazarlama
  • GTM konteynerinin kendisi (gtm.js) engellenmez; konteynerdeki Google dışı etiketler çalışmaya devam eder. Konteyner içindeki Google etiketleri gtag.js ve yukarıdaki adresleri yüklediği için rızayı bekler.
  • AdSense engellenmez.
  • Tarayıcının Veribenim script'inden önce işlediği etiketler engellenemez. Script'i en başa koymanın bir nedeni de budur.
  • İki modda da rıza varsayılanı ve güncellemeleri aynı şekilde gönderilir. GTM şablonu mod için ayrı bir ayar gerektirmez.

Doğrulama

GTM Önizleme (Tag Assistant hata ayıklama modu)

  • 1. Önizleme'ye basın, sitenizi açın, banner'da henüz seçim yapmayın.
  • 2. Consent Initialization olayını seçin. Veribenim Default etiketi Succeeded göstermeli. Failed ise banner script'i yok ya da GTM'den sonra yükleniyor (sırayı ve async'i kontrol edin).
  • 3. Aynı olayın Consent sekmesini açın. On-page Default varsayılanlarınızı gösterir, ör. ad_storage: Denied, security_storage: Granted.
  • 4. Banner'da kabul edin ya da reddedin. vbn_consent_update olayı gelir. Consent sekmesinde On-page Update seçiminizi, Data Layer sekmesinde vbn_consent ve vbn_consent_source: "user" görünür. Update etiketi bu olayda çalışmıştır.
  • 5. Sayfayı yenileyin. vbn_consent_update bu kez vbn_consent_source: "restored" ile gelir. Güncellemenin, sayfa görüntüleme etiketlerinizi tetikleyen olaydan önce göründüğünü kontrol edin.
  • 6. Tarayıcı konsolunda (yalnızca Önizleme'de) şablonun mesajları "Veribenim Consent Mode:" ile başlar.

Canlı sitede Tag Assistant

  • Her Google etiketinin Consent sekmesi varsayılan ve güncellenmiş durumları listeler.
  • Seçim öncesi ad_storage, analytics_storage, ad_user_data ve ad_personalization Denied; kabul sonrası Granted olmalı.

Tarayıcı konsolu: dataLayer

Sitenizde geliştirici araçlarının konsolunu açıp aşağıdaki satırları çalıştırın. İlki her vbn_consent_update olayını vbn_consent ve vbn_consent_source ile döndürür. İkincisi rıza komutlarını listeler; ilk sırada default olmalı.

js
// Veribenim rıza olayları
dataLayer.filter(e => e && e.event === 'vbn_consent_update')

// Sıraya girdikleri düzende rıza komutları (default / update)
dataLayer.filter(e => e && e[0] === 'consent')

Ağ istekleri: gcs ve gcd

Ağ (Network) sekmesinde Google'a giden istekleri süzün (ör. google-analytics.com veya googleadservices.com) ve sorgu parametrelerine bakın. Google'ın consent mode belgesi (https://developers.google.com/tag-platform/security/concepts/consent-mode) consent mode parametrelerinin dma, gcd ve gcs gibi HTTP istek parametrelerine çevrildiğini belirtir.

ParametreGoogle'ın belgelediği
gcsad_storage ve analytics_storage durumlarını taşır.
gcdConsent mode etkin olsun ya da olmasın Google hizmetlerine her zaman gönderilir. Kullanıcının rıza seçimini rıza türleri üzerinden ayrıntılı olarak kodlar.

Kontrol edilecek şey: kabul ya da ret sonrasında giden isteklerdeki gcs ve gcd değerleri, seçim öncesindekilerden farklıdır. Google o belgede bu değerler için karakter karakter bir anahtar yayımlamadığından bu sayfa onları çözmez; kesin durumları Tag Assistant'ın Consent sekmesinden okuyun.

Sık yapılan hatalar

Default etiketi yanlış tetikleyicide

Belirti: bazı Google etiketleri hiçbir rıza durumu yokken çalışır. Neden: Default etiketi All Pages ya da Initialization tetikleyicisinde; bunlar daha geç çalışır ve diğer etiketlerle yarışır. Çözüm: Default etiketi için Consent Initialization - All Pages kullanın.

Script GTM'den sonra ya da async ile yükleniyor

Belirti: Default etiketi Önizleme'de Failed gösterir ve konsolda "Veribenim banner script not found. Load it before the GTM container snippet, without async." yazar. GTM olmadan: Google istekleri rıza varsayılanından önce sayfadan çıkar. Çözüm: Veribenim script'ini Google etiketinin ya da GTM kodunun üstüne taşıyın ve async'i kaldırın.

Belirti: Update etiketi hiç çalışmaz. Neden: şablonun önceki sürümleri veribenim_consent_update adlı Özel Etkinlik tetikleyicisi kullanıyordu; banner bu olayı itmez. Çözüm: güncel template.tpl'yi yeniden içe aktarın ve tetikleyicinin olay adını vbn_consent_update yapın.

Tümünü Kabul Et sonrası rıza denied kalıyor

Neden: sağlayıcının çerezleri envanterinizde yok ya da rıza sinyali atanmamış; sinyali bu yüzden hiç granted olmaz. Çözüm: sağlayıcıyı envantere ekleyin (çerez tarayıcı yardımcı olur) ve "Rıza Sinyali" alanını kontrol edin.

İki kaynak rıza gönderiyor

Belirti: rıza durumları komutlar arasında beklenmedik biçimde değişir. Neden: başka bir script ya da kendi GTM etiketleriniz de gtag('consent', …) gönderiyor. Çözüm: tek kaynak bırakın. Consent mode'u GTM'den yönetiyorsanız banner'ın Google Consent Mode köprüsünü kapatın; şablon ve vbn_consent_update olayı çalışmaya devam eder.

Ayar değişti ama site değişmedi

Mod, URL passthrough ve köprü anahtarları banner dosyanıza gömülüdür. Dosya yeniden üretildikten sonra geçerli olur; panel kaydederken bunu belirtir.

Diğer rıza sinyalleri

Aynı ziyaretçi kararı diğer platformların rıza API'lerine de çevrilir. Microsoft UET sayfa açılışında ve her kararda çalışır. Meta, TikTok ve Clarity'ye ziyaretçi karar verdiğinde sinyal gider; sonraki sayfa açılışlarında Veribenim'in yönettiği script'ler yalnızca rıza varsa yüklenir.

PlatformVeribenim'in gönderdiğiDayandığı rıza
Microsoft UETGoogle default'unun yanında uetq consent default (ad_storage: denied), ardından ad_storage ile consent update. UET'te analytics_storage karşılığı yoktur. Rıza Sinyali Köprüleri altında kapatılabilir.Pazarlama
Meta Pixelfbq('consent', 'grant') ya da fbq('consent', 'revoke').Pazarlama
TikTok Pixelttq.enableCookie() ya da ttq.disableCookie().Pazarlama
Microsoft Clarityclarity('consentv2', { ad_Storage, analytics_Storage }). Analitik reddedilince önce çerezleri silen ve oturumu bitiren clarity('consent', false) gönderilir.Analitik ve Pazarlama
js
window.uetq = window.uetq || [];
window.uetq.push('consent', 'default', { 'ad_storage': 'denied' });
// sayfa açılışında (kayıtlı karar) ve her kararda:
window.uetq.push('consent', 'update', { 'ad_storage': 'granted' }); // or 'denied'

LinkedIn Insight ve Hotjar da geri çekmede ele alınır. GTM şablonu yalnızca Google Consent Mode'u kapsar; diğer sinyaller banner script'inden gelir.

Bağlantılar