Widget Kurulumu

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.

1. selwise.com/dashboard adresinde oturum açın.
2. 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).
3. 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.

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.

<link rel="preconnect" href="https://widget.selwise.com" crossorigin>
<link rel="preconnect" href="https://api.selwise.com" crossorigin>
<script>window.Selwise=window.Selwise||{};window.Selwise.q=window.Selwise.q||[];['track','trackOrder','identify','setTraits','pushDataLayer','grantConsent','revokeConsent','showConsentPreferences','withdrawConsent','endJourney'].forEach(function(m){if(!window.Selwise[m])window.Selwise[m]=function(){window.Selwise.q.push([m,arguments])}});</script>
<script async src="https://widget.selwise.com/client.js" data-site-key="SITE_KEY"></script>

Script yüklendiğinde data-* özniteliklerini okuyarak otomatik başlatılır — ayrıca Selwise.init() çağırmanıza gerek yoktur. Etiket bir etiket yöneticisi tarafından enjekte edildiğinde tarayıcı document.currentScript vermez; widget bu durumda data-site-key taşıyan script etiketini kendisi bulur.

Üstteki üç satır birlikte çalışır ve hiçbiri isteğe bağlı değildir:

Satır	Ne yapar
preconnect	İki hosta DNS + TLS el sıkışmasını erken başlatır. 100–300 ms kazanç.
Komut kuyruğu	async yüklemede window.Selwise henüz yokken yapılan trackOrder / identify çağrılarını tamponlar ve widget hazır olunca oynatır. Bu satır olmadan async sipariş kaybettirir.
async script	HTML ayrıştırmasını durdurmaz. Senkron hâli canlı bir vitrinde 210 ms ölçüldü.

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ı).

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 50 KB altında tutulur).
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:

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

Kurulumu doğrulayın

Kurulumdan sonra:

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

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

3. 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.