Veri Katmanı Ayarları

Bu sayfa panelin Data Layer Configuration (Data Layer Yapılandırması) ve Data Layer Events (Data Layer Event'leri) ekranlarını anlatır: her anahtarın ne yaptığını, varsayılanını, hangi platformun neyi kullandığını ve olayların neden görünmediğini. window.selwiseLayer.push() ile olay gönderme ve zarf alanları için bkz. Veri Katmanı.

Panelde nerede

Sol menüde Settings (Ayarlar) → Integrations (Entegrasyonlar) ekranında Data Layer bölümündeki kart ya da Configure (Yapılandır) bağlantısı. Adres: /dashboard/integrations/data-layer. Olay listesi için ekranın sağ kenarındaki View Events (Event'leri Gör) bağlantısı.

Ekran yalnızca web kanallarında vardır; bir uygulama kanalında veri katmanı bulunmaz. Hesabınızda Integrations modülü yoksa ekran menüde görünmez.

Ne işe yarar

Veri katmanı, sitenizin sayfa, ürün, sepet, ödeme, kullanıcı ve arama olaylarını Selwise'a taşıyan katmandır. Bu ekran onun açık olup olmadığını, hangi modüllerin çalıştığını ve sitenizi nasıl tanıdığını belirler. Veri katmanı yeni bir kanalda kapalıdır: Enable Data Layer açılmadıkça window.selwiseLayer oluşmaz, otomatik sayfa, ürün ve sepet izleme çalışmaz ve harici dataLayer köprüsü devreye girmez.

Alanlar

Sayfada iki ayrı kaydetme düğmesi vardır: Save Changes (üstte) veri katmanı ayarlarını, Save Tracking Settings (en altta, Event Batching bölümü) toplu gönderim ayarlarını kaydeder. Bir değer geçersizse ilgili kutunun altında nedeni yazar ve kaydetme engellenir. Kayıttan sonra yeni ayar, widget bir sonraki sayfa yüklemesinde okuyunca devreye girer.

Bölüm ve alan	Varsayılan	Ne yapar
Enable Data Layer	Kapalı	Veri katmanını açar. Sayfada iki yerde (üstteki kart ve Data Layer Runtime Config) görünür; ikisi aynı ayardır
Variable Name (Değişken Adı)	selwiseLayer	Sayfada oluşturulan global dizinin adı: window.<ad>. En fazla 50 karakter, boş olamaz
E-commerce Platform Preset	Generic	Platformunuza göre dinlenecek adları ve hazır eşlemeleri seçer; aşağıda
Use External Data Layer	Açık	Sitenizin kendi dataLayer dizisini dinleyip olayları Selwise olaylarına çevirmeyi açar
External Data Layer Name	dataLayer	Dinlenecek dizinin adı (en fazla 50 karakter). Platform ön ayarının bilinen adları da dinlenir
Page Detection Mode	Auto	Sayfa görüntülemelerinin nasıl yakalanacağı; aşağıda
Tracking Modules	Page, Product, Basket, Checkout açık; User, Search kapalı	Hangi olay gruplarının işleneceği; aşağıda
Cookie Consent Integration	—	Bu ekranda düzenlenmez; Open Consent (Onay sayfasını aç) sizi onay ekranına götürür, bkz. Onay Yönetimi
Client Event Buffer → Buffer Size	10 olay (1–100)	Widget'ın bellekte bekleteceği olay sayısı
Client Event Buffer → Flush Interval (ms)	1000 (100–10000)	Tamponun ne sıklıkla işleneceği. Bu tampon Event Batching ayarından bağımsızdır; yalnızca widget içindeki bellek kuyruğunu yönetir
Auto Page Tracking	Açık	Sayfa görüntülemelerini kendiliğinden gönderir
Cart Abandonment Timeout	30 dk	Sepette ürün varken bu kadar işlem yapılmazsa cart_abandon üretilir (1–240 dk)
Page Type Patterns	Varsayılan desenler	Yedi sayfa türü için düzenli ifade; boş bırakılan desen yerine varsayılanı kullanılır
Debug Mode	Kapalı	Veri katmanı olaylarını tarayıcı konsoluna yazar
Test Mode	Kapalı	Olaylar kaydedilir ama kanalın hiçbir olayı webhook'lara iletilmez: ne Send Test Event ile gönderdiğiniz, ne de gerçek ziyaretçilerin ve siparişlerin olayları. Entegrasyonunuzu kurarken alıcınızı korumak için açın, bitince kapatın

Platform ön ayarı

Ön ayar seçimi sitenize neyin uygulanacağını belirler. Auto Detect widget'ın sayfayı inceleyip platformu kendisinin bulmasıdır; bulamazsa Generic gibi davranır.

Ön ayar	Dinlenen dataLayer adları	Hazır eşleme
Auto Detect	Bulunan platforma göre	Bulunan platforma göre
Generic, Custom, None	dataLayer	Yok
Akinon	dataLayer	Var: Enhanced Ecommerce olayları (eeEvent, eeCart, eeCheckout, eepurchase)
IdeaSoft	dataLayer, iDataLayer	Var; ayrıca giriş/çıkış ve arama sinyalleri
Shopify	dataLayer, ShopifyAnalytics, shopifyDataLayer	Yok
Ticimax	dataLayer, ticimaxDataLayer	Yok
T-Soft	dataLayer, tSoftDataLayer	Yok
ikas	dataLayer, ikasDataLayer	Yok

Ürün sayfası seçicileri (ürün kodunu DOM'dan bulmak için) her ön ayar için bir kez, paylaşılan sözleşmeden okunur. IdeaSoft seçildiğinde ekranda ayrıca bir IdeaSoft no-code checklist kutusu çıkar.

Öneri widget'larının "sepete ekle" davranışı için ayrı bir platform listesi vardır (öneri sepet platformu): custom, akinon, ticimax, tsoft, ikas, ideasoft, shopify, custom_api. Veri katmanının listesi ise bunlara ek olarak auto, generic ve none içerir; iki liste ayrı ayarlardır ve birbirini değiştirmez. Desteklenen platformların ayrıntısı: Platformlar.

Dış veri katmanı köprüsü

Use External Data Layer açık olsa bile köprü yalnızca elinde bir eşleme (dış olay adı → Selwise olayı) varsa çalışır. Akinon ve IdeaSoft ön ayarlarında hazır eşleme vardır; başka bir ön ayarda eşleme tanımlı değilse widget dış diziyi hiç dinlemez. Bilinen GA4 olay adlarının Selwise karşılıkları Veri Katmanı sayfasındadır.

Sayfa algılama

Mod	Davranış
Auto (Otomatik)	Her sayfa görüntülemesi yakalanır (otomatik sayfa takibi açıksa)
Manual (Manuel)	Otomatik page_view gönderilmez; siz page_view push edersiniz
Patterns (Desenler)	Otomatik page_view yalnızca adresi yedi desenden en az biriyle eşleşen sayfalarda gönderilir

Varsayılan desenler (kısaca): ana sayfa / ve index.html; ürün /product/…, /products/…, /p/…, /item/…; kategori /category/…, /categories/…, /c/…, /collection/…; arama /search, /find; ödeme /checkout, /payment, /order; sepet /cart, /basket; hesap /account, /profile, /my-account. Geçersiz bir düzenli ifade kaydedilemez; widget okuyamadığı deseni atlar.

Takip modülleri

Modül	Açılınca ne olur	Varsayılan
Page Tracking	Otomatik sayfa görüntüleme ve SPA geçişleri	Açık
Product Tracking	Ürün sayfası tespiti, product_view, product_click, product_impression, kalış süresi	Açık
Basket Tracking	add_to_cart, remove_from_cart, update_cart, cart_abandon, cart_restore	Açık
Checkout Tracking	checkout_begin, checkout_progress, checkout_option, purchase	Açık
User Tracking	user_signup, user_login, user_logout, user_update (gizlilik nedeniyle varsayılan kapalı)	Kapalı
Search Tracking	search_* olayları (Selwise arama açıksa sorgular aramanın kendisi tarafından zaten kaydedilir)	Kapalı

Kapalı bir modülün olayları push edilse bile işlenmez. Örneğin Basket Tracking kapalıyken add_to_cart push'u sessizce yok sayılır.

Event Batching

Veri katmanı tamponundan sonra devreye girer ve yalnızca API'ye gönderimi etkiler. Kaydı Save Tracking Settings ile ayrı yapılır.

Alan	Varsayılan	Aralık
Enable Advanced Batching	Kapalı	—
Batch Size	50 olay	10–100
Flush Interval	30 sn	5–300
Offline Persistence	Açık	Çevrimdışıyken olayları localStorage'da saklar
Send Beacon on Unload	Açık	Sekme kapanırken kalan olayları sendBeacon ile yollar
Max Retries	3	0–10
Max Queue	100	50–500
Max Storage	50	10–100

Widget, sayfa kapanırken kuyruğun tamamını tek istekte gönderir; bu yüzden Batch Size bir üst sınır değil gönderim ipucudur.

Send Test Event

Üstteki Test Event (Test Event'i) düğmesi bir olay adı sorar (varsayılan test_event) ve kanalda bir test olayı oluşturur; olay Data Layer Events listesinde görünür. Veri katmanı açıksa ve Test Mode kapalıysa aynı olay seçili webhook'lara da iletilir. Webhook'lar yalnızca kanonik olay adlarını seçebildiğinden, webhook'u denemek için page_view gibi kanonik bir ad yazın.

Integrations ekranındaki sayılar

Integrations ana ekranındaki üst kartlar:

Kart	Ne sayar
Total Events	Veri katmanından gelen ve saklama süresi içinde (varsayılan 90 gün) duran olaylar; kanalın bütün olayları değildir
Events Today	Bugün gelen veri katmanı olayları (gün, sunucunun saatine göre başlar)
Active Webhooks	Etkin webhook sayısı / toplam

Üstteki Install & ingestion health (Kurulum ve ingest sağlığı) paneli iki sinyali bu sayıdan türetir: Script signal (Script sinyali) Total Events sıfırsa No tracking signal yet (Henüz tracking sinyali yok), değilse Tracking signal detected der; Event flow (Event akışı) beşin altındaki sayılarda Warning (Uyarı) gösterir. Panel veri katmanı sayısına dayandığından, veri katmanı kapalıysa betik kurulu olsa bile "sinyal yok" der.

Data Layer Events ekranı

Veri katmanı üzerinden gelen olayların canlı akışı. Adres /dashboard/integrations/data-layer/events; görmek için analitik görüntüleme yetkisi gerekir.

Öğe	Anlamı
Event Name	Kanonik olay adı, kategorisine göre renkli
Entity Type / Entity ID	Olayın konusu: product ve stok kodu, page ve sayfa türü, basket ve sepet kimliği… Yoksa -
Time	Olayın alındığı an
Validation	Valid (Geçerli) ya da Degraded (Eksik veriyle). Degraded: olay alındı ama bir sorun işaretlendi
View Details	Oturum, kaynak, uyarı kodları ve olayın ham verisi
Olay türü seçici	All Events ya da tek bir kanonik ad
Arama kutusu	Yüklü satırlarda olay adı ve varlık kimliğine göre süzer
Üstteki sayı	Listelenen olay sayısı (yaklaşıktır)

Liste son 7 günü kapsar ve en fazla 5000 satır yükler. Yalnızca veri katmanı kaynaklı olaylar görünür: widget gösterimi ve tıklaması gibi yüzey olayları burada çıkmaz.

Degraded olayların yaygın uyarı kodları:

Kod	Anlamı	Çözüm
MISSING_PRODUCT_ITEM_CODE	Ürün olayında stok kodu yok	product.sku gönderin
PRODUCT_SYNC_FAILED	Stok kodu ürün beslemenizde bulunamadı	Beslemedeki item_code ile birebir aynı olsun
PURCHASE_ITEMS_MISSING	purchase olayında ürün listesi yok	order.products ekleyin
PURCHASE_ITEM_CODE_MISMATCH	Ürün kodları satır kalemleriyle çakışmıyor	Aynı kodları kullanın
UNSUPPORTED_EVENT_NAME_FALLBACK	Olay adı tanınmadı, custom_event olarak saklandı	Kanonik bir ad kullanın
MISSING_EVENT_ID_GENERATED	Olay kimliği gelmedi, Selwise üretti	Bilgi amaçlı
LEGACY_EVENT_ALIAS_MAPPED	Eski ad kanonik ada çevrildi (checkout_complete → purchase gibi)	Yeni adı kullanın

Neden boş

Belirti	Neden
Ekran hiç yok	Uygulama kanalı seçili ya da Integrations modülü satın alınmamış
Liste boş, sayfada olay var	Enable Data Layer kapalı; ilgili Tracking Module kapalı; ziyaretçi çerez onayı vermedi; değişken adı sitedeki kodla uyuşmuyor
Yalnızca bazı olaylar var	Kapalı modüller; aynı olay adı ve aynı ürün/sepet kimliği 1 saniye içinde tekrarlandı (kısa süreli throttle)
Dış dataLayer olayları gelmiyor	Köprü için eşleme tanımlı değil (yukarıya bakın) veya External Data Layer Name yanlış
Son 7 günden eski olay yok	Liste yalnızca son 7 günü gösterir
Test olayı webhook'a gitmedi	Veri katmanı kapalı, Test Mode açık ya da webhook o adı seçmemiş

Sorun giderme için İzleme Sorunları.