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.
Consent Mode v2 nedir
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.
Banner kategorileri ve rıza türleri
| Rıza türü | Veribenim kategorisi | Google'ın tanımı |
|---|---|---|
analytics_storage | Analitik | Analitikle ilgili depolama, ör. ziyaret süresi. |
ad_storage | Pazarlama | Reklamla ilgili depolama. |
ad_user_data | Pazarlama | Çevrim içi reklam için kullanıcı verisinin Google'a gönderilmesine rıza. |
ad_personalization | Pazarlama | Kişiselleştirilmiş reklama rıza. |
functionality_storage | İşlevsel | Sitenin işlevini destekleyen depolama, ör. dil ayarı. |
personalization_storage | İşlevsel | Kişiselleştirmeyle ilgili depolama, ör. video önerileri. |
security_storage | Her zaman izinli | Gü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.
Banner script'i ne gönderir
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ı).
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.
{
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.
<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
<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ı
| Alan | Anlamı |
|---|---|
Consent command | Default: varsayılanları ayarla ve banner'ı dinle. Update: dataLayer'daki vbn_consent'i uygula. |
Default consent settings | Her 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 update | Her satırın wait_for_update değeri (ms). Varsayılan 500. |
Redact ads data | ads_data_redaction'ı ayarlar. Varsayılan açık; banner script'i de her zaman açar. |
Pass ad click information through URLs | url_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.
| Mod | Rıza öncesi ne olur |
|---|---|
advanced | Yeni 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. |
basic | Banner 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çeriyorsa | Beklediğ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/js | Analitik veya Pazarlama (kimlik adresten anlaşılamıyor) |
google-analytics.com | Analitik |
googleadservices.com | Pazarlama |
doubleclick.net | Pazarlama |
- 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ı.
// 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.
| Parametre | Google'ın belgelediği |
|---|---|
gcs | ad_storage ve analytics_storage durumlarını taşır. |
gcd | Consent 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.
Eski olay adı veribenim_consent_update
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.
| Platform | Veribenim'in gönderdiği | Dayandığı rıza |
|---|---|---|
Microsoft UET | Google 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 Pixel | fbq('consent', 'grant') ya da fbq('consent', 'revoke'). | Pazarlama |
TikTok Pixel | ttq.enableCookie() ya da ttq.disableCookie(). | Pazarlama |
Microsoft Clarity | clarity('consentv2', { ad_Storage, analytics_Storage }). Analitik reddedilince önce çerezleri silen ve oturumu bitiren clarity('consent', false) gönderilir. | Analitik ve Pazarlama |
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
- GTM şablonu ve README: https://github.com/Pariette-Inc/veribenim.gtm-template
- Google consent mode genel bakış: https://developers.google.com/tag-platform/security/concepts/consent-mode
- GTM şablonlarında consent mode: https://developers.google.com/tag-platform/tag-manager/templates/consent-apis
- Microsoft Clarity Consent API v2: https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-consent-api-v2