Şeffaflık Raporu

SDK Performans Şeffaflığı

Müşteriler her şeyi bilmeli: SDK boyutu, yükleme süresi, sayfa hızı etkisi, API gecikme süreleri. Gizlenen rakam yok.

Son güncelleme: 31 Mayıs 2026

Sektörel şeffaflık notu: Rakiplerimizin çoğu (yurt içi/dışı consent ve a11y SDK sağlayıcıları) bu metrikleri kamuya açıklamıyor; gizli kalan rakamların ardında genellikle ya şişkin bundle'lar ya da test edilmemiş iddialar oluyor. Biz farklı bir yol seçtik: elimizdeki gerçek rakamları paylaşırız, ölçemediğimizi de açıkça "ölçüm beklemede" olarak işaretleriz.

SDK dosya boyutları

1. SDK Dosya Boyutları

SDK boyutu, ziyaretçilerinizin tarayıcısının indireceği ek baytı ifade eder. Az olması iyidir; ancak "küçük göstermek için sıkıştırılmış brotli rakamı" ile "gerçek minified brüt boyut" farklıdır. Aşağıda her üç ölçümü birden veriyoruz.

SDK	Brüt (min)	Gzip	Brotli
Çerez SDK `consent.js`	Ölçüm beklemede	Ölçüm beklemede	Ölçüm beklemede
Erişilebilirlik SDK `accessibility.js`	Ölçüm beklemede	Ölçüm beklemede	Ölçüm beklemede
Loader `/sdk/loader.js`, senkron, minify yok	15,4 KB	5,3 KB	4,7 KB

Neden "beklemede"? SDK derleme hattı (minify ve boyut bütçesi) çalışıyor; resmi ölçümleri yöntemiyle birlikte hazır olduğunda burada yayınlayacağız. Tahmin paylaşmaktansa boş bırakmayı tercih ediyoruz.

Yükleme stratejisi

2. Yükleme Stratejisi

Bir SDK ne kadar küçük olursa olsun, yanlış yüklenirse sayfa hızını yine de bozar. cerez.io SDK'sı aşağıdaki tekniklerle sayfayı olabildiğince az bekletecek şekilde tasarlandı.

Küçük senkron yükleyici, async SDK

Embed kodumuz, head'in ilk satırındaki küçük bir yükleyicidir (/sdk/loader.js). Rıza öncesi engellemeyi ve Google Consent Mode varsayılanını diğer betiklerden önce kurmak için bilinçli olarak senkron çalışır; banner ve widget kodunu async yükler, onlar indirilirken tarayıcı sayfayı render etmeye devam eder.

Versiyonsuz loader

Sitelere /sdk/loader.js verilir; yükleyici ve SDK, sürüm numarası taşımayan sabit adreslerden 10 dakikalık önbellekle sunulur. Versiyon güncellemesinde site sahibinin kodu değiştirmesine gerek yoktur.

Sunucu tarafı cache

Banner ayarları 5 dakika boyunca Redis'te cache'lenir. Aynı dakikadaki binlerce ziyaretçi tek bir DB sorgusu yapar.

sessionStorage cache

Banner kararı browser'da 1 saat saklanır. Aynı kullanıcı yeni sekme açtığında SDK API'ye hiç gitmez.

Shadow DOM izolasyonu

Banner ve a11y widget Shadow DOM içinde render edilir. Tarayıcının style recompute maliyeti minimumda kalır, host sitenin CSS'i etkilenmez.

Lazy a11y panel

Erişilebilirlik widget'ı 30 ayarın tam yükünü yalnızca tetikleyici düğmeye basıldığında açar. Sayfaya geldiğinde yalnızca düğmenin kendisi DOM'dadır.

Core Web Vitals etkisi

3. Sayfa Hızı Etkisi, Core Web Vitals

Resmi Lighthouse ölçümümüz şu an mevcut değildir. Birçok rakip "<5ms etki" gibi rakamlar paylaşıyor; hangi test ortamında, hangi ağ profili ile, hangi sayfa tipinde ölçüldüğünü söylemiyor. Biz aceleci konuşmak yerine bağımsız bir üçüncü taraf ölçümü yaptırmayı planlıyoruz; raporu HAR + ekran görüntüsü ile birlikte burada yayınlayacağız.

Aşağıdaki metrikler teknik mimariden kaynaklanan temsili beklentilerimizi yansıtır; ölçüm sonucu değildir. Gerçek değerler bağımsız audit sonrasında bu sayfada güncellenecektir.

~4 KB

Senkron yükleyici (gzip); çerez SDK'sı async yüklenir

0

CLS (Layout Shift), Shadow DOM reflow tetiklemez

<10ms

TBT, ana thread serbest, worker-friendly

defer

Bundle stratejisi, DOMContentLoaded sonrası yürütme

Temsili / örnek metrikler. Ölçüm beklemede. Rakiplerin "0ms etki" iddialarından farklı olarak orta segment mobil + 4G ağ baseline'ında konuşuyoruz.

Yerli hosting · güvenli altyapı

4. Hosting & CDN

SDK dosyalarının fiziksel olarak nereden servis edildiği, kamu kurumları ve KVKK uyumu odaklı müşteriler için kritiktir.

Türkiye yerli hosting Tüm uygulama sunucuları, banner config DB'si, consent log DB'si ve API endpoint'leri Türkiye sınırları içindeki veri merkezlerinde tutulur. KVKK Madde 9 (yurt dışı aktarım kısıtı) açısından temizdir.
Static asset cache headers SDK dosyalarına Cache-Control: public, max-age=300 + ETag + Last-Modified header'ları verilir. Tarayıcı, yeniden ziyaretlerde 304 Not Modified alır ve sıfır bayt indirir.
CDN entegrasyonu değerlendiriliyor Cloudflare entegrasyonu planlanmaktadır. Yerel edge node'lar (İstanbul, Ankara, İzmir) tek haneli ms gecikme sağlayacak. Şu an statik dosyalar doğrudan sunucudan servis edilmektedir.
HTTP/2 + TLS 1.3 + brotli Tüm SDK trafiği TLS 1.3, HTTP/2 ve brotli sıkıştırmayla servis edilir.

API SLA hedefleri

5. API Performans, Hedef SLA

SDK çalışırken üç tip arka uç çağrısı yapar: banner config alma, consent kaydetme, heartbeat. Aşağıdaki rakamlar hedeflediğimiz SLA değerleridir; production'da sürekli izleniyor, ihlal durumunda alarm tetikleniyor.

Endpoint	P50 (medyan)	P95	Rate Limit
`GET /banner/{api_key}` Banner config (5 dk cache)	< 100ms	< 300ms	500/dk
`POST /consent/log` Consent kayıt (async write)	< 80ms	< 200ms	500/dk
`POST /heartbeat` Pageview sayacı	< 50ms	< 150ms	500/dk

Sistem durumu sayfası yayında. SDK dağıtımı, API, panel ve tarama için 5 dakikada bir ölçülen durum ve olay geçmişi: Sistem Durumu

Taahhüt

6. Süreç Şeffaflığı

Performans, tek seferlik bir ölçüm değil, sürekli bir taahhüttür.

Versiyon log

SDK sürüm notları için herkese açık değişiklik günlüğü yakında açılıyor.

Breaking change duyurusu

SDK API'sinde geriye uyumsuz değişiklik en az 90 gün önceden e-posta + admin panel banner + changelog ile duyurulur.

Deprecation policy

Bir API endpoint veya SDK parametresi kaldırılmadan önce minimum 6 ay deprecation süresi tanınır. Bu süre boyunca eski sürüm çalışmaya devam eder.

Quarterly performans raporu

Çeyreklik olarak agregat performans raporu yayınlamayı planlıyoruz: ortalama LCP etkisi, P99 gecikme, uptime yüzdesi, düzeltilen hata sayısı.

Sık sorulanlar

7. Açık Sorular

Gerçek Lighthouse ölçümleri ne zaman gelecek?

Tarih henüz belli değil. Bağımsız bir üçüncü taraf audit firmasıyla çalışmayı planlıyoruz; HAR dosyaları + ekran görüntüsü + ham veri ile birlikte rapor yayınlanacak. Tahmin paylaşmak yerine ölçülmüş gerçek değeri bekleyen bir yaklaşımı tercih ediyoruz.

SDK boyutum benim için kritik, kesin rakam alabilir miyim?

Production build sonrası kesin rakamı bu sayfada yayınlayacağız. O zamana kadar kurumsal müşteriler için iletişim sayfasından talep ederseniz, mevcut build'ten alınan güncel ölçümü size özel paylaşırız.

Verilerim Türkiye dışına çıkıyor mu?

Hayır. SDK trafiği, banner config, consent log ve API endpoint'leri Türkiye sınırları içindeki sunucularda işlenir ve saklanır. CDN entegrasyonu sonrasında yalnızca statik SDK JS dosyası edge node'lardan servis edilebilir; bu dosyalar kişisel veri içermez.

Rakipler "0ms etki" diyor, sizinkiler neden farklı?

Async yüklenen her üçüncü taraf script'in sıfır olmayan bir maliyeti vardır; bu fizik kuralıdır. "0ms" diyenler ya ölçüm metodolojisini paylaşmıyor ya da güçlü bir makinede ideal koşulda ölçüyor. Biz orta segment mobil cihaz ve 4G ağ baseline'ında konuşuyoruz ve bu konuda şeffafız.

Status sayfası canlı mı?

Evet. Sistem Durumu sayfası SDK dağıtımı, API, panel ve tarama için 5 dakikada bir yapılan ölçümleri ve olay geçmişini gösterir.