Dokümanlar
Kurulumdan denetime, adım adım rehber
veÇerez'i sitenize kurmak, Consent Mode'u doğru sırayla yerleştirmek ve Meta/TikTok CAPI entegrasyonlarını yapılandırmak için ihtiyacınız olan her şey.
Üç adımda yayına alın
Hesabınızı oluşturduktan sonra ilk sitenizi ekleyip loader betiğini yerleştirmeniz yeterli. Kurulum ortalama 5 dakika sürer.
Site ekleyin
Panel > Siteler ekranından alan adınızı bağlayın. Her site için benzersiz bir data-site-id üretilir.
Betiği yerleştirin
Size verilen loader betiğini sitenizin <head> bölümüne, diğer ölçüm etiketlerinden önce ekleyin.
Taramayı çalıştırın
İlk çerez taramasını başlatın; veÇerez sitenizdeki çerezleri otomatik tespit edip kategorilendirir ve politikanızı üretir.
Loader betiğini ekleme
Aşağıdaki tek satırlık betiği panelden kopyalayıp sitenizin <head> bölümüne yapıştırın. SITE_ID değeri panelde size özel üretilir.
<script
src="https://vecerez.com/loader.js"
data-site-id="SITE_ID"
data-api-base="https://vecerez.com"
async
></script>Platform notları
- ikas: Uygulamayı kurduğunuzda loader otomatik yerleştirilir; manuel ekleme gerekmez.
- WordPress: Betiği tema ayarlarındaki "head" alanına veya bir header-script eklentisiyle ekleyin.
- Özel altyapı: Betiği doğrudan HTML şablonunuzun
<head>bölümüne yerleştirin.
Doğru yükleme sırası
Google Consent Mode v2 kullanıyorsanız, varsayılan rıza durumunun reddedildi (denied) olarak — herhangi bir Google etiketinden önce — tanımlanması gerekir. veÇerez, ziyaretçi rıza verdiğinde consent update sinyalini otomatik gönderir. Sıralama şöyle olmalıdır:
<!-- 1) Consent Mode varsayılanları: TÜM analitik/pixel etiketlerinden ÖNCE -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){ dataLayer.push(arguments); }
gtag('consent', 'default', {
ad_storage: 'denied',
ad_user_data: 'denied',
ad_personalization: 'denied',
analytics_storage: 'denied',
wait_for_update: 500
});
</script>
<!-- 2) veÇerez loader: rıza alınınca 'update' sinyalini o gönderir -->
<script src="https://vecerez.com/loader.js" data-site-id="SITE_ID" data-api-base="https://vecerez.com" async></script>
<!-- 3) Google Analytics / Ads / diğer etiketler: bunların ARDINDAN gelir -->Varsayılanlar
Tüm sinyaller 'denied' — Google etiketlerinden önce.
veÇerez loader
Rıza alınınca 'update' sinyalini gönderir.
Ölçüm etiketleri
GA4, Google Ads ve diğerleri bunun ardından.
GTM ile kurulum
Etiketlerinizi Google Tag Manager üzerinden yönetiyorsanız, Consent Mode varsayılanlarını ve veÇerez loader'ını GTM konteyner kodundan önce <head> içine ekleyin. Böylece GTM ile tetiklenen tüm etiketler doğru rıza durumunu görür.
<!-- GTM konteyner kodunuzun HEMEN ÜSTÜNE, <head> içine -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){ dataLayer.push(arguments); }
gtag('consent', 'default', {
ad_storage: 'denied',
ad_user_data: 'denied',
ad_personalization: 'denied',
analytics_storage: 'denied',
wait_for_update: 500
});
</script>
<script src="https://vecerez.com/loader.js" data-site-id="SITE_ID" data-api-base="https://vecerez.com" async></script>GTM içinde etiketlerinizde "Ek rıza kontrolü" (Additional consent checks) seçeneğini etkinleştirerek, ilgili çerez kategorisine rıza verilmeden etiketin çalışmamasını da sağlayabilirsiniz.
Meta & TikTok CAPI bağlama
Sunucu taraflı Conversions API (CAPI), olayları tarayıcı yerine sunucudan göndererek reklam engelleyicilerin ve tarayıcı kısıtlamalarının yol açtığı ölçüm kaybını azaltır. veÇerez olayları yalnızca ilgili kategoriye rıza verildiğinde iletir.
Meta CAPI
- 1. Meta Events Manager'da veri kaynağınızı açın.
- 2. Pixel ID ve Conversions API erişim tokenını alın.
- 3. Panel > Entegrasyonlar > Meta ekranına yapıştırın.
- 4. Test olayı gönderip doğrulayın.
TikTok Events API
- 1. TikTok Events Manager'da pikselinizi açın.
- 2. Pixel Code ve Access Token değerlerini alın.
- 3. Panel > Entegrasyonlar > TikTok ekranına yapıştırın.
- 4. Test Event Code ile doğrulayın.
event_id değerini kullanır; veÇerez bunu otomatik yönetir.Kurulumu doğrulama
Betiği yerleştirdikten sonra Panel > Siteler ekranındaki "Kurulumu doğrula" düğmesine basın. veÇerez sitenizi ziyaret edip loader'ın gömülü olup olmadığını kontrol eder ve sonucu anında gösterir.
- Banner ilk ziyarette görünüyor mu?
- Rıza öncesinde analitik/pixel çerezleri oluşmuyor mu?
- Rıza sonrası Consent Mode 'update' sinyali gidiyor mu?
- CAPI test olayları Events Manager'da görünüyor mu?
Sık sorulan sorular
Betiği tam olarak nereye eklemeliyim?
Loader betiği, sayfanın <head> bölümüne — Google Analytics, Meta Pixel, TikTok Pixel gibi tüm ölçüm etiketlerinden ÖNCE — eklenmelidir. Ön-blokajın (prior blocking) ve Consent Mode varsayılanlarının doğru çalışması için sıralama kritiktir.
Rıza alınmadan çerezler gerçekten engelleniyor mu?
Evet. veÇerez, ziyaretçi açık rıza verene kadar analitik ve reklam betiklerinin çalışmasını engeller (ön-blokaj). Bu, KVKK ve ePrivacy'nin aradığı 'önceden açık rıza' ilkesinin teknik garantisidir; yalnızca görsel bir banner değildir.
Consent Mode v2 olmadan da kullanabilir miyim?
Evet. Consent Mode entegrasyonu opsiyoneldir. Yalnızca banner + ön-blokaj ile de KVKK uyumlu çalışırsınız. Ancak Google Ads/Analytics kullanıyorsanız Consent Mode v2, rızasız durumda bile toplulaştırılmış (cookieless) ölçüm sağladığı için önerilir.
CAPI (sunucu taraflı olaylar) neden gerekli?
Tarayıcı tabanlı pixel'ler reklam engelleyiciler ve tarayıcı kısıtlamaları nedeniyle olay kaybeder. Meta ve TikTok CAPI, olayları sunucudan göndererek ölçüm doğruluğunu artırır. veÇerez, olayları yalnızca ilgili kategoriye rıza verildiğinde iletir — böylece ölçüm uyumlu kalır.
Banner'ı kendi markama göre değiştirebilir miyim?
Evet. Panel > Banner ekranından konum (alt bar, üst bar, kutu, modal), renkler, köşe yumuşaklığı, logo ve tüm metinleri kod yazmadan özelleştirebilir, canlı önizleme ile görebilirsiniz.
Birden fazla sitem var; hepsini yönetebilir miyim?
Evet. Her siteyi Panel > Siteler ekranından ekleyip her biri için ayrı bir loader betiği alırsınız. Rıza kayıtları, tarama sonuçları ve analitikler site bazında ayrılır.
Aradığınızı bulamadınız mı?
Destek ekibimiz kurulumun her adımında yanınızda.