SDK Genel Bakış
Pintelly SDK dokümantasyonuna hoş geldiniz! Pintelly; gelişmiş Analitik, kullanıcı Geri Bildirimi ve sıkı Onay (Consent) yönetimini tek bir pakette birleştiren bütünleşik bir SDK'dır.
Kurulum
Pintelly SDK'yı entegre etmek son derece basittir. Tüm modüller (Analytics, Feedback, Consent) tek, hafif bir bundle içinde paketlenmiştir.
Sitenizin <head> etiketine sadece şu <script> satırını eklemeniz yeterli:
<script type="module" src="https://api.pintelly.com/cdn/feedback-module.es.js" data-backend="https://api.pintelly.com"></script>
Mimari
SDK, birbirinden bağımsız ama birbiriyle yoğun şekilde etkileşen üç ana modülden oluşur:
- Analytics Core: Sayfa görüntülemelerini, benzersiz ziyaretçileri, oturumları ve cihaz metriklerini otomatik olarak izler. Özel buton tıklamalarını otomatik yakalayabilir.
- Feedback Widget: Kullanıcıların belirli öğeleri işaretlemesine, ekran üzerine çizim yapmasına, hassas ekran görüntüleri almasına ve yazılı geri bildirim göndermesine olanak tanıyan güçlü, site içi bir widget.
- Consent Management: Gelişmiş analitik işlemleri tetiklemeden önce kullanıcının açık (veya örtülü) onayını yöneten, gizlilik öncelikli sağlam bir modül.
Nasıl Çalışır
Script sayfaya enjekte edildikten sonra:
- Pintelly backend'inden kendi Domain Yapılandırmanızı otomatik olarak okur.
- Dashboard ayarlarınıza göre (ör. Scroll Tracking açık mı, Consent gerekli mi, Feedback butonunun konumu ne) SDK alt modüllerini buna göre yönetir.
- Gelişmiş Analytics API'ini kullanmak istemediğiniz sürece kendiniz hiç JavaScript yazmanıza gerek yoktur.
Sıradaki Adımlar
- Özel event takibi için Analytics sayfasına göz atın.
- Feedback Widget hakkında bilgi edinin.
- GDPR/KVKK uyumluluğu için Consent Management ayarlarını yapılandırın.
- Scroll ve cursor verisi için Gelişmiş Takip sayfasına derinlemesine bakın.