Event Referansi

Selwise'ın tüm analitiği (huniler, yolculuklar, kohortlar, ilişkilendirme) tek bir kanonik event sözlüğü üzerine kuruludur. Bu sayfa, sistemdeki her event'i, kategorisini, nasıl üretildiğini ve tipik alanlarını eksiksiz listeler.

Event nasıl üretilir

Bir event üç yoldan biriyle oluşur:

1. Otomatik — Client script, widget gösterimi/tıklaması, arama ve öneri etkileşimleri gibi olayları kendiliğinden yakalar.
2. Veri katmanı — Ticari ve sayfa olayları window.selwiseLayer.push() ile gönderilir. Bkz. Veri Katmanı.
3. Manuel — Herhangi bir event'i doğrudan window.Selwise.track() ile gönderebilirsiniz:

window.Selwise.track('add_to_cart', {
  entityType: 'basket',
  productItemCode: 'SKU-123',
  metadata: { quantity: 2, price: 149.90, currency: 'TRY' },
});

track(name, args) imzası:

Parametre	Tip	Açıklama
name	string	Kanonik event adı (aşağıdaki tablolar).
args.entityType	string	Olayın konusu: page, product, basket, checkout, user, widget, campaign, recommendation, search, script, custom.
args.entityId	string	Widget/kampanya için UUID; ürün için stok kodu (productItemCode).
args.metadata	object	Olaya özel ek veriler (event başına 2 KB sınırı).

Sayfa olayları (page)

Event	Nasıl üretilir	Açıklama
page_view	Otomatik / veri katmanı	Klasik sayfa görüntüleme.
virtual_page_view	Otomatik (SPA) / veri katmanı	SPA yönlendirmelerinde sanal sayfa görüntüleme.

Tipik metadata: type (home, product, category, checkout, search...), title, path, referrer.

Ticari olaylar (commerce)

E-ticaret hunisinin belkemiği. Çoğu veri katmanından veya otomatik gelir.

Event	Nasıl üretilir	Açıklama
category_view	Veri katmanı	Kategori/liste sayfası görüntüleme.
product_view	Veri katmanı / otomatik	Ürün detay görüntüleme.
product_impression	Veri katmanı / otomatik	Ürünün listede görünmesi.
product_dwell_time	Otomatik	Ürün sayfasında geçirilen süre.
add_to_cart	Veri katmanı	Sepete ekleme.
remove_from_cart	Veri katmanı	Sepetten çıkarma.
cart_view	Veri katmanı	Sepet sayfası görüntüleme.
update_cart	Veri katmanı	Sepet adet/içerik güncelleme.
cart_abandon	Otomatik	Zaman aşımıyla sepet terk (varsayılan 30 dk).
cart_restore	Otomatik / veri katmanı	Terk edilen sepetin geri gelmesi.
checkout_begin	Veri katmanı	Ödeme sürecinin başlaması.
checkout_progress	Veri katmanı	Ödeme adımının ilerlemesi.
checkout_option	Veri katmanı	Ödeme/kargo seçeneği seçimi.
purchase	Veri katmanı / trackOrder	Satın alma tamamlanması.
wishlist	Manuel / davranış takibi	Favorilere ekleme.

Ürün olaylarında entityId alanına ürünün stok kodunu (productItemCode / sku) verin. Satın alma için güvenilir gelir ilişkilendirmesi adına trackOrder önerilir — bkz. Sipariş Takibi.

Arama olayları (search)

Site içi arama ve keşif etkileşimleri. Arama modülü etkinse çoğu otomatik gelir.

Event	Nasıl üretilir	Açıklama
search_instant_open	Otomatik	Anlık arama kutusunun açılması.
search_query	Otomatik / veri katmanı	Arama sorgusu çalıştırma.
search_filter	Otomatik	Filtre (facet) uygulama.
search_sort	Otomatik	Sıralama değiştirme.
search_page	Otomatik	Sonuç sayfası değiştirme.
search_results	Otomatik	Sonuçların dönmesi (sonuç sayısıyla).
search_zero_results	Otomatik	Sonuçsuz arama (iyileştirme için izlenir).
search_close	Otomatik	Arama arayüzünün kapanması.
product_click	Otomatik	Arama sonucundan ürüne tıklama.
category_filter	Otomatik	Kategori filtreleme.
recent_search_click	Otomatik	Son aramalardan tıklama.
popular_search_click	Otomatik	Popüler aramalardan tıklama.
popular_category_click	Otomatik	Popüler kategoriden tıklama.
popular_product_click	Otomatik	Popüler üründen tıklama.

Etkileşim olayları (engagement)

Kampanya ve widget etkileşimleri. Client script tarafından otomatik bağlanır.

Event	Nasıl üretilir	Açıklama
impression	Otomatik	Kampanya/widget gösterimi.
click	Otomatik	Kampanya/widget tıklaması.
close	Otomatik	Kampanya/widget kapatma.
widget_view	Otomatik	Widget görünür oldu.
view	Otomatik	Genel görünürlük olayı.
hover	Otomatik	Üzerine gelme.
scroll	Otomatik	Kaydırma.
custom_event	Manuel	Tanımladığınız özel olay.

Bu olaylarda entityType genelde widget veya campaign, entityId ise ilgili varlığın UUID'sidir.

Öneri olayları (recommendation)

Öneri widget'larıyla etkileşim. Öneri modülü tarafından otomatik gönderilir.

Event	Nasıl üretilir	Açıklama
widget_impression	Otomatik	Öneri widget'ının gösterimi.
slider_navigate	Otomatik	Slider'da gezinme (ok/nokta).
slider_swipe	Otomatik	Dokunmatik kaydırma.

Öneri kaynaklı ürün tıklama/sepete ekleme/satın alma olayları ayrıca öneri takip endpoint'lerine bildirilir — bkz. Public API.

Kullanıcı olayları (user)

Varsayılan olarak kapalıdır; kullanıcı takibini açıkça etkinleştirmeniz gerekir. Kişisel veri göndermekten kaçının.

Event	Nasıl üretilir	Açıklama
identify	Selwise.identify()	Ziyaretçiyi bilinen kullanıcıyla eşleştirme.
user_signup	Veri katmanı	Kayıt.
user_login	Veri katmanı	Giriş.
user_logout	Veri katmanı	Çıkış.
user_update	Veri katmanı	Profil güncelleme.

identify için bkz. JavaScript API.

Sistem olayları (system)

Özel script yürütmesinin telemetrisi; otomatik üretilir.

Event	Açıklama
script_injected	Özel script başarıyla enjekte edildi.
script_error	Özel script çalışırken hata oluştu.

Event'ler analitiği nasıl besler

• Huniler (funnels) — 2 ila 8 kanonik event'ten oluşan sıralı adımlar tanımlarsınız (örn. product_view → add_to_cart → checkout_begin → purchase). Bkz. Dönüşüm Hunileri.
• Yolculuklar (journeys) — Oturumlar arası event zinciri; journeyId ile ilişkilendirilir ve dönüşüm olayları otomatik işaretlenir.
• İlişkilendirme (attribution) — purchase ve gelir, önceki temas olaylarına (kampanya/öneri/arama) atfedilir.
• Kohortlar — Kullanıcılar ilk event'lerine göre gruplanır.

Batch ve gönderim davranışı

Event'ler tek tek değil, verimli olması için toplu (batch) gönderilir. Batch parametreleri (batchSize, flushInterval, çevrimdışı kalıcılık, sendBeacon ile sayfadan çıkışta gönderim, yeniden deneme sayısı) Dashboard'dan yapılandırılır ve tracking-config ile istemciye iletilir. Ağ katmanı ayrıntıları için bkz. Public API — events/batch.