Script’i Sitenize Ekleyin

Selwise sitenize tek bir script etiketiyle kurulur. Bu sayfa en kısa yolu anlatır; her script özniteliği, etiket yöneticisi (GTM) kurulumu, tek sayfa uygulamaları, CSP, önbellek ve geri alma için Widget Kurulumu (detaylı) sayfasına bakın.

Ön koşul

Panelde bir web kanalı tanımlı olmalı ve Channel Key (Kanal Anahtarı) elinizde olmalı: Kanallar → Kanal Özeti (Channels → Channel Overview) ekranındaki kartta durur. Kanal yoksa Kanal Ekleme. Bir mobil uygulama için bu sayfa değil Mobil SDK geçerlidir.

Script etiketi

Aşağıdaki satırları sitenizin tüm sayfalarına, <head> içine (ya da </body> etiketinden hemen önce) ekleyin:

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

SITE_KEY yerine panelden aldığınız değeri yazın. Başka bir ayar ya da init() çağrısı gerekmez: script kendiliğinden başlar.

Üç satırın görevi

Satır	Ne yapar
preconnect	İki hosta bağlantıyı erken başlatır; 100-300 ms kazanç
Komut kuyruğu	Script yüklenmeden önce yapılan trackOrder, identify gibi çağrıları tamponlar ve hazır olunca oynatır. Bu satır olmadan async sipariş kaybettirir
async script	Sayfanın çizimini beklemez

Script sıkıştırılmış 50 KB'nin altındadır; arama, öneri ve çizici kodları yalnızca o özellik açıksa ayrıca indirilir.

Platforma göre nereye eklenir

Platform	Yer
Akinon Project Zero	base.html şablonu, body kapanışından önce
Akinon Omnife Next	_document.tsx veya ortak layout
Shopify	theme.liquid
Ticimax, T-Soft, ikas, IdeaSoft	Panel içindeki özel kod / footer script alanı
Google Tag Manager	Custom HTML etiketi: Widget Kurulumu

Ayrıntılı kurulum sırası için Platformlar bölümüne bakın.

Kurulumu doğrulama

1. Kanalın alan adını doğrulayın: doğrulanmamış kanalda içerik çizilmez ve olaylar kaydedilmez (Alan Adı Doğrulama).
2. Sitenizi açın, tarayıcı konsolunu açın ve çalıştırın:

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

3. DevTools Network sekmesinde şu isteği görmelisiniz:

GET https://api.selwise.com/api/v1/public/sites/SITE_KEY/config?p=4

Bu istek 200 dönüyorsa script çalışıyor ve kanal doğrulanmış demektir. 403 dönüyorsa alan adı henüz doğrulanmamıştır ya da Origin kanalın alan adlarından biri değildir. Ardından events/batch isteklerinin 200 ve "success": true ile döndüğünü kontrol edin. Sorun varsa Takip Sorunları sayfasındaki teşhis akışını izleyin.

Sırada ne var

• Alan Adı Doğrulama
• İlk Kampanya
• Entegrasyon Genel Bakış: sipariş, kimlik, onay, sunucu taraflı render