Shortmox Tools · entegrasyon rehberi

Analytics — script entegrasyonu

Çerez yazmayan hafif first-party ölçüm yükleyicisi. Gönderilen alanlar path, URL, referrer, başlık, ekran çözünürlüğü ve saat dilimi gibi sınırlı teknik metadatalarla sınırlıdır — kişisel veri minimizasyonu hedeflenir, sıfır veri işleme garantisi verilmez.

Bu rehber hukuki veya denetim danışmanlığı değildir. Üretim anahtarlarınızı depolamayın; örneklerde YOUR_* yer tutucuları kullanın. Admin panoları ve çoğu yazma API’si oturum gerektirir — ayrıntılar erişim politikası.

Analytics ürün sayfası Pro / Agency iletişim

Kurulum

Script dosyası geçerli site anahtarı için üretilir; geçersiz anahtarda konsola uyarı veren minimal içerik dönebilir. Aynı sayfada birden fazla kez yüklemeyin.

<!-- YOUR_SITE_KEY panodan — örnek yer tutucu -->
<script src="https://YOUR_DOMAIN/api/tools/analytics/script/YOUR_SITE_KEY" defer></script>

<!-- Script, dağıtım origin'inize göre collect URL'sini üretir; cross-site kurulumda YOUR_DOMAIN doğru kök olmalıdır -->

Collect uç noktası

Tarayıcı, script içinden POST /api/tools/analytics/collect çağrısı yapar (çoğunlukla sendBeacon veya fetch keepalive). İstemci bu yolu doğrudan yazmak zorunda değildir — yükleyici üretir.

Limitler ve güvenlik notu

Oran sınırı aşıldığında istekler sessizce reddedilebilir veya 429 alınabilir.
Şüpheli bot user-agent’ları filtrelenmeye çalışılır; tam bot ayrımı garanti edilmez.
Panoda site ve anahtar yönetimi admin oturumu ister — dashboard.

Sık sorulanlar

YOUR_SITE_KEY nedir?

Sitenize atanmış public anahtardır; script URL’sinin parçasıdır. Gizli sunucu sırrı değildir; yine de gereksiz paylaşımdan kaçının.

Çerez kullanır mı?

Yükleyici script çerez yazmaz; sayfa görüntüleme olayı sunucuya minimal alanlarla iletilir. Üçüncü taraf reklam profili oluşturmaz.

DNT veya GPC işaretliyse ne olur?

Sunucu tarafında bu başlıklar algılandığında toplama yapılmayabilir — ayrıntılar uygulama sürümüne bağlıdır.

Ölçüm doğruluğu garanti midir?

Hayır — bot filtreleri, engelleyiciler veya ağ kesintileri veriyi eksik bırakabilir; raporlama SLA’sı bu vitrin metninde taahhüt edilmez.