Tek satır kod – gerisi ihtiyacınıza göre
İzleme kodu sıkıştırılmış hâlde yaklaşık 5 KB boyutundadır ve her web sitesinde çalışır. Olaylar, giriş, e-ticaret ve sunucu taraflı veriler için sade bir JavaScript API'si ve bir sunucu API'si bulunur.
<script defer src="https://visualclicks.de/t/fwa.js" data-site="vc_…"></script>Olaylar, özellikler ve giriş
Aramalar, indirmeler veya tıklamalar gibi kendi olaylarınızı fwa.track() ile, ek bilgileri ise fwa.set() ile gönderin – olay, sayfa, oturum için ya da kullanıcı için kalıcı olarak. Giriş yapıldıktan sonra fwa.identify() oturumu müşteri numaranızla ilişkilendirir.
Her yeni özellik otomatik olarak özellik kayıt defterinde görünür ve ardından filtrelerde, kartlarda ve segmentlerde kullanılabilir.
// özellikler içeren olay
fwa.track('search', { query: 'çadır', results: 12 });
// tüm oturum için özellik
fwa.set('customer_type', 'vip', { scope: 'session' });
// girişi ilişkilendir, çıkış yap
fwa.identify('cust_4711');
fwa.reset();
// çerez banner'ınızdan gelen onay
fwa.consent.grant(['analytics', 'recording']);Olaylar olarak satın alma süreci
E-ticaret API'si Google Analytics 4'ün yapısını izler: ürün görüntüleme, sepet, ödeme adımı, kargo, ödeme, satın alma ve iade; her biri ürünler, marka, kategoriler, fiyat ve adet bilgisiyle.
Mağazanızda zaten bir GA4 veri modeli varsa geçiş çok az çaba gerektirir.
fwa.ecommerce.viewItem({ item_id: 'ZT-100', item_name: 'Trekking çadırı',
item_brand: 'NordCamp', item_category: 'Çadırlar', price: 249 });
fwa.ecommerce.addToCart({ item_id: 'ZT-100', price: 249, quantity: 1 });
fwa.ecommerce.beginCheckout(items, { value: 249 });
fwa.ecommerce.purchase(items, { transaction_id: 'A-1001',
value: 249, tax: 39.76, shipping: 0, currency: 'EUR' });Siparişler ve yapay zekâ botları doğrudan sunucunuzdan
Ayarlardan alacağınız bir sunucu anahtarıyla arka ucunuz olayları doğrudan VisualClicks'e gönderir – tarayıcıdan, reklam engelleyiciden ve onaydan bağımsız olarak. Siparişler, sipariş numarası aracılığıyla tarayıcı verileriyle birleştirilir.
Yapay zekâ botu isteklerini de aynı şekilde bildirirsiniz ya da “combined” formatında bir erişim logu yüklersiniz.
- Web sitesi başına birden fazla anahtar, tek tek iptal edilebilir
- Bir anahtar yalnızca bir kez gösterilir ve yalnızca hash olarak saklanır
- Dahili trafik için IP hariç tutmaları
curl -X POST https://visualclicks.de/api/s/v1/events \
-H "Authorization: Bearer vcsk_…" \
-H "Content-Type: application/json" \
-d '{"source":"server","e":[{"t":"ecommerce","n":"purchase",
"u":"https://shop.example/thank-you",
"x":{"transaction_id":"A-1001","value":249}}]}'Eşzamansız
defer ile yüklenir, sayfayı asla engellemez
Tek sayfalı uygulamalar
History API üzerinden sayfa değişiklikleri otomatik olarak
Kod gerekmez
data-fwa-event ile tıklamaları izleyin
Birden fazla web sitesi
Web sitesi başına ayrı kod ve ayarlar
Sıkça sorulan sorular
İzleme kodunu nereye eklerim?
Her sayfanın <head> bölümüne – çoğu CMS ve mağaza sisteminde tema üzerinden veya özel betikler için ayrılmış bir alan aracılığıyla. Kod eşzamansız yüklenir ve sayfayı engellemez.
Tek sayfalı uygulamalarla (React, Vue, Next.js) çalışır mı?
Evet. History API üzerinden yapılan sayfa değişiklikleri otomatik olarak sayfa görüntüleme olarak yakalanır.
Buton tıklamalarını kod yazmadan nasıl izlerim?
Öğe üzerindeki data-fwa-event özniteliğiyle, örneğin data-fwa-event="newsletter_click". Ek özellikleri data-fwa-prop-… ile eklersiniz.
Sunucu anahtarı ne işe yarar?
Sunucunuzun olayları doğrudan göndermesini sağlar: siparişler, iadeler veya yapay zekâ botu istekleri. Sunucu anahtarları asla web sitenizin kaynak koduna konmamalıdır ve tek tek iptal edilebilir.
İlk kod satırına hazır mısınız?
Erişiminizi talep edin. Sonrasında tek satır izleme kodu yeterli – ilk ziyaretler gerçek zamanlı olarak görünür.