Onay Yönetimi (Consent)

Selwise, KVKK/GDPR uyumluluğu için çerez onayı denetimini destekler. Onay etkinleştirildiğinde, ziyaretçi izin verene kadar ilgili kategorideki olaylar bekletilir ve izin gelince gönderilir.

Onay denetimi varsayılan olarak kapalıdır. Kişisel veri veya izleme çerezi kullanıyorsanız açmanız önerilir.

Her şey tek sayfada

Çerez onayının tamamı — banner'ın görünürlüğü, metni, tasarımı, konumu ve onay politikası — panelde Onay sayfasından yönetilir. Başka hiçbir ekran bu ayarları yazmaz.

Onay kategorileri

Kategori	Açıklama
necessary	Zorunlu — işlevsellik için gereklidir, her zaman verilmiş sayılır.
analytics	Analitik ve performans. Selwise olaylarının çoğu bu kategoridedir.
marketing	Pazarlama: kampanya ve banner gösterimleri.
preferences	Kullanıcı tercihleri.

necessary kategorisindeki olaylar (page_view, click, form_submit, button_click) her zaman gönderilir. Hiçbir kategoriye düşmeyen bir olay da zorunlu sayılır.

Politika alanları

Onay → Politika sekmesinde:

Alan	Varsayılan	Açıklama
Takipten önce onay iste	kapalı	Onay denetimini açar.
Kategori bazlı onay	kapalı	Ziyaretçi kategori kategori cevap verir.
Her zaman açık kategoriler	necessary	Ziyaretçinin kapatamayacağı kategoriler. Ön işaretli değil, kapatılamaz demektir.
Cevaba kadar olayları beklet	kapalı	Açıkken olaylar atılmaz, kuyruğa alınır.
Cevap gelmezse onay verilmiş say	kapalı	Süre dolunca cevapsız banner'ı onay sayar.
Bekleme süresi	5000 ms	0 süresiz bekler.

Kendi onay çözümünüzle entegrasyon

Otomatik algılanan iki standart

Ayar gerekmez:

• IAB TCF v2 (window.__tcfapi) — amaç 1 depolama izni, 7-10 analitik, 2-4 pazarlama olarak eşlenir.
• Google Consent Mode v2 — gtag('consent', …) çağrıları paylaşılan dataLayer'da okunur.

Programatik API

// Mevcut kararı oku — henüz cevap yoksa null
const state = window.Selwise.getConsentState();
// -> { necessary: true, analytics: false, marketing: false, preferences: false } | null

// Onay ver (tümü veya seçili kategoriler)
window.Selwise.grantConsent();
window.Selwise.grantConsent({ analytics: true, marketing: false });

// Onayı geri çek
window.Selwise.revokeConsent();
window.Selwise.revokeConsent(['marketing']);

// Banner'ı yeniden aç (ziyaretçi fikrini değiştirsin diye)
window.Selwise.showConsentPreferences();

// Kararı tamamen unut ve yeniden sor
window.Selwise.withdrawConsent();

Kendi banner'ınızla entegre etmek için:

<script>
  document.querySelector('#cookie-accept')?.addEventListener('click', function () {
    window.Selwise?.grantConsent({ analytics: true, marketing: true });
  });

  document.querySelector('#cookie-reject')?.addEventListener('click', function () {
    window.Selwise?.revokeConsent();
  });
</script>

Bu üç metot veri katmanından bağımsız çalışır: veri katmanı kapalı olsa da karar yazılır ve bekletilen olaylar serbest bırakılır.

Window değişkeni

Ne TCF ne Consent Mode yayımlayan bir çözüm için Onay → Politika → Kendi onay çözümünüz altında bir window değişkeni adı belirtebilirsiniz (varsayılan __wcmp_consent). Şu değerleri anlar: true/false, 1/0, 'granted'/'denied' ve { analytics, marketing, preferences } ya da { all: true } biçiminde bir nesne.

Karar nerede saklanır

localStorage'da, selwise_consent_<siteKey> anahtarında. Anahtarı Onay → Politika → Saklama anahtarı ile değiştirebilirsiniz; Selwise eski anahtarı da okumaya devam eder, böylece mevcut ziyaretçilere ikinci kez sorulmaz.

Onayın geri çekilmesi

Geri çekmek, vermek kadar kolay olmalıdır (GDPR Madde 7(3)). Banner'ı yeniden açmanın iki yolu vardır:

1. Onay → Banner → Kalıcı tercih butonunu göster
2. Kendi sayfanızdaki bir bağlantıya öznitelik ekleyin:

<a href="#" data-selwise-consent>Çerez tercihleri</a>

Sunucuya onay kaydı

Banner cevabı otomatik olarak kaydedilir. Kendi çözümünüzü kullanıyorsanız doğrudan da çağırabilirsiniz.

Onay kaydet

curl -X POST https://api.selwise.com/api/v1/public/sites/SITE_KEY/consent \
  -H "Content-Type: application/json" \
  -H "Origin: https://magaza.com" \
  -d '{
    "categories": { "necessary": true, "analytics": true, "marketing": false, "preferences": true },
    "visitorId": "VISITOR_ID",
    "sessionId": "SESSION_ID",
    "action": "accepted"
  }'

action alanı panelde Onay → Analitik → Onay yöntemi dağılımını belirler: accepted / declined banner, customized ayar ekranı, timeout varsayılan, diğer her şey programatik sayılır.

Onayı geri çek (silme talebi)

curl -X DELETE https://api.selwise.com/api/v1/public/sites/SITE_KEY/consent \
  -H "Content-Type: application/json" \
  -H "Origin: https://magaza.com" \
  -d '{ "visitorId": "VISITOR_ID" }'

Yanıt, istemcide yapılması gereken temizliği de bildirir (clientAction); storageKey sizin yapılandırdığınız anahtardır.