Widget Kurulumu

Detayli kurulum rehberi

Selwise script'ini sitenize CDN ile eklersiniz.

Ön koşul: site oluşturun ve site key alın

Kurulumdan önce Dashboard'da bir site tanımlamanız gerekir.

selwise.com/dashboard adresinde oturum açın.
Siteler > Site Ekle adımından e-ticaret alan adınızı girin (örn. magaza.com) ve para biriminizi seçin (ISO-4217, örn. TRY, EUR, USD).
Oluşturulan sitenin Site Key değerini kopyalayın. Tüm kurulum bu anahtarla çalışır.

API üzerinden oluşturmak isterseniz:

curl -X POST https://api.selwise.com/api/v1/sites \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "magaza.com", "currency": "TRY" }'

Yanıt, kurulumda kullanacağınız siteKey alanını içerir.

Site Key gizli değildir

siteKey tarayıcıda görünür ve gizli bir sır değildir. Güvenlik, gizlilikten değil domain doğrulamasından gelir: Selwise, event ve içerik isteklerini yalnızca doğrulanmış alan adınızın Origin / Referer başlığından kabul eder.

CDN ile kurulum

Aşağıdaki tek satırı sitenizin tüm sayfalarında, </body> etiketinden hemen önce (veya <head> içinde) yerleştirin. SITE_KEY değerini kendi anahtarınızla değiştirin.

<script
  src="https://widget.selwise.com/client.js"
  data-site-key="SITE_KEY"
></script>

Script yüklendiğinde document.currentScript üzerindeki data-* özniteliklerini okuyarak otomatik başlatılır — ayrıca Selwise.init() çağırmanıza gerek yoktur.

Script öznitelikleri

Öznitelik	Zorunlu	Açıklama
`data-site-key`	Evet	Sitenizin Selwise anahtarı. Bu olmadan başlatma yapılmaz.
`data-api-url`	Hayır	API taban adresini geçersiz kılar. Varsayılan: `https://api.selwise.com`. Değer otomatik olarak `/api/v1` ile normalize edilir.
`data-env`	Hayır	`development` verilirse geliştirme modu açılır (ek hata ayıklama araçları).

Tek bir kez ekleyin

Script'i sayfa başına yalnızca bir kez ekleyin. SPA (tek sayfa uygulaması) yönlendirmelerinde script'i yeniden eklemeyin — Selwise sayfa geçişlerini kendisi algılar (MutationObserver + history API) ve içeriği yeniden değerlendirir.

Dağıtılan dosyalar

CDN'de aşağıdaki dosyalar yayınlanır. Yalnızca client.js'i eklersiniz; geri kalanı Selwise gerektiğinde otomatik yükler.

Dosya	Ne zaman yüklenir
`client.js`	Her zaman — ana giriş dosyası (gzip 15 KB altında hedeflenir).
`selwise-search.[hash].js`	Arama modülü kullanıldığında (tembel).
`selwise-reco.[hash].js`	Öneri modülü kullanıldığında (tembel).
`selwise-renderers.[hash].js`	Widget şablonları gerektiğinde (tembel).
`selwise-datalayer.[hash].js`	Veri katmanı devreye girdiğinde (tembel).
`selwise-vendor.[hash].js`	Paylaşılan üçüncü taraf bağımlılıklar (tembel).

Başlatma akışı

init() çağrıldığında Selwise şu adımları sırayla yürütür:

/api/v1/public/sites/:siteKey/tracking-config — takip/batch yapılandırmasını yükler.
Deney (experiment) varyant atamalarını başlatır.
Segment hedeflemesini yükler.
Kampanyaları ve widget'ları çeker (/config toplu endpoint'i veya ayrı çağrılar).
Özel script'leri çeker.
Journey (yolculuk) takibini başlatır.
Kampanya ve widget'ları render eder.
Arama ve öneri modüllerini gerektiğinde tembel yükler.

Kurulumu doğrulayın

Kurulumdan sonra:

Domain doğrulaması yapın. Doğrulanmamış domain'lerde widget render edilmez ve event'ler reddedilir. Bkz. Domain Doğrulama.
Tarayıcı konsolunda debug modunu açın:

localStorage.setItem('selwise_debug', 'true');
location.reload();

Ağ (Network) sekmesinde tracking-config ve events/batch isteklerinin oluştuğunu doğrulayın.

Sorun yaşarsanız Widget Görünmüyor ve Takip Sorunları sayfalarına bakın.

Son güncelleme: 3 Temmuz 2026

Bu makale yardimci oldu mu?