Genel Bakis

Bu rehber, Selwise'i bir e-ticaret sitesine uçtan uca entegre etmek için gereken her şeyi anlatır: tek satırlık script kurulumundan, tüm event'lerin takibine, sipariş/gelir ölçümüne ve önerilerden aramaya kadar tüm modüllerin devreye alınmasına kadar.

Bir geliştirici bu bölümü baştan sona takip ederek Selwise'i sorunsuz şekilde canlıya alabilir.

Selwise nedir

Selwise; kampanya ve widget yönetimi, ürün önerileri, site içi arama, segmentasyon, A/B test ve davranışsal analitiği tek bir platformda birleştiren, yapay zeka destekli bir e-ticaret kişiselleştirme platformudur.

Sitenize eklediğiniz tek bir hafif script (client.js) üç işi birden yapar:

1. Görsel içerikleri render eder — kampanyalar, widget'lar ve öneri alanları.
2. Davranışı takip eder — sayfa görüntüleme, ürün görüntüleme, sepet, satın alma gibi tüm event'ler.
3. Kişiselleştirir — segment ve deney atamalarına göre içerik ve önerileri kullanıcıya özelleştirir.

Mimari

Entegrasyon üç bileşenden oluşur:

Bileşen	Ne işe yarar	Nerede çalışır
Client script (client.js)	İçerik render + event takibi	Ziyaretçinin tarayıcısında
Public API (/api/v1/public/...)	Kampanya/widget/öneri servis eder, event ve sipariş toplar	Selwise sunucularında
Dashboard	Kampanya, widget, segment, öneri tanımlarsınız; analitiği görürsünüz	selwise.com/dashboard

Akış şu şekildedir:

 Ziyaretçi Tarayıcısı                         Selwise Sunucusu
┌──────────────────────────┐                ┌───────────────────────────┐
│  Siteniz + client.js      │                │  Public API (/api/v1)     │
│                           │  1. config     │                           │
│  Selwise.init()  ─────────┼───────────────▶│  GET .../tracking-config  │
│                           │◀───────────────┤  GET .../config           │
│  Kampanya/Widget render   │  2. içerik     │                           │
│                           │                │                           │
│  Event'ler (batch)  ──────┼───────────────▶│  POST .../events/batch    │
│  Sipariş  ────────────────┼───────────────▶│  POST .../orders          │
└──────────────────────────┘                └───────────────────────────┘

Neyi nerede kullanmalısınız

Entegrasyonda üç farklı "seviye" vardır. İhtiyacınıza göre birini veya hepsini kullanabilirsiniz:

1. Otomatik (kod yazmadan)

Script'i eklediğinizde Veri Katmanı (Data Layer) devreye girer. Sayfa görüntüleme, ürün görüntüleme ve (birçok platformda) sepet event'leri otomatik yakalanır. Ayrıca sitenizde zaten bir window.dataLayer (GA4/GTM) varsa, Selwise bunu dinleyip event'leri kendi kanonik formatına çevirir.

Detaylar: Veri Katmanı.

2. Manuel (JavaScript API)

Otomatik yakalanamayan durumlar için window.Selwise API'sini kullanırsınız: kullanıcı tanımlama (identify), sipariş bildirimi (trackOrder), özel event (track) ve daha fazlası.

Detaylar: JavaScript API ve Event Referansı.

3. Headless (doğrudan HTTP)

Mobil uygulama veya sunucu tarafı entegrasyonlar için public HTTP endpoint'lerini doğrudan çağırabilirsiniz.

Detaylar: Public API.

Entegrasyon yol haritası

Aşağıdaki sırayı takip etmeniz önerilir:

1. Site oluşturun ve siteKey alın — Dashboard'da bir site ekleyin. Bkz. Widget Kurulumu.
2. Script'i ekleyin — client.js'i tüm sayfalara yerleştirin.
3. Domain'i doğrulayın — Doğrulanmadan widget'lar render edilmez ve event'ler reddedilir. Bkz. Domain Doğrulama.
4. Otomatik takibi doğrulayın — Debug modunu açıp sayfa/ürün event'lerinin aktığını görün.
5. Sipariş takibini bağlayın — Teşekkür (order confirmation) sayfasına trackOrder ekleyin. Bkz. Sipariş Takibi.
6. Onay yönetimini yapılandırın — KVKK/GDPR gerekiyorsa çerez onayını bağlayın. Bkz. Onay Yönetimi.
7. Modülleri açın — Öneriler, arama ve kampanyaları devreye alın.