Sık Sorunlar

Sorun giderme burada başlar. Belirtiden doğru sayfaya yönlendirir; önce aşağıdaki üç kontrolü yapın — sorunların çoğu bunlardan birine iner.

Önce bu üçünü kontrol edin

1. Script yüklü ve çalışıyor mu

Sitenizin herhangi bir sayfasında tarayıcı konsolunu açın:

typeof window.Selwise?.getVisitorId;

"function" dönmüyorsa client.js çalışmıyordur. (typeof window.Selwise tek başına yeterli değildir: kurulum kodundaki kuyruk taslağı da bir nesnedir.) Kaynak kodda client.js etiketini arayın ve etikette data-site-key olduğundan emin olun; yoksa konsolda "No site key — widget not started" yazar.

2. Domain doğrulanmış mı

Ağ (Network) sekmesinde public/sites/KANAL_ANAHTARI/config isteğine bakın:

Yanıt	Anlamı
200	Kanal tanındı ve hesabın teslimatı açık
403	Domain doğrulanmamış, istek kanalın alan adından gelmiyor ya da hesabın teslimatı kapalı
404	Kanal anahtarı yanlış

3. Debug modunu açın

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

Bu mod konsola [Selwise] önekli ayrıntılı günlük yazar: hedefleme kararları, sıklık sınırı sonuçları, hangi kampanyanın neden atlandığı. (Sayfada ayrı bir panel çizmez.) Mesajların anlamı: Gösterim Kuralları.

Belirti tablosu

Belirti	Sayfa
Widget veya kampanya görünmüyor	Widget Görünmüyor
Kampanya neden atlandı, hangi kural	Gösterim Kuralları
Arama açılmıyor veya sonuç dönmüyor	Arama Çalışmıyor
Öneri şeridi görünmüyor	Öneriler Görünmüyor
Panelde veri yok, ciro görünmüyor	Takip Sorunları
Ürünler gelmiyor, fiyatlar yanlış	Besleme Sorunları
Panele giremiyorum, kod istiyor, kilitlendi	Giriş ve Erişim Sorunları
Menüde bir ekran yok ya da gri	Giriş ve Erişim Sorunları
Özel script çalışmıyor	Aşağıda
Geçmiş veri aktarımı hata veriyor	Doğrulama ve Uygulama
Bir terimin anlamını bilmiyorum	Terimler Sözlüğü
Zenginleştirme kuralı ürün sayfasında görünmüyor	Kural Görünmüyor
Mobil uygulamada anahtar, olay ya da sipariş sorunu	SDK Sorun Giderme
Mobil uygulamada içerik görünmüyor	Görünmeyen İçerik

Test modu açık kalmış olabilir

Test modu, test işaretli kampanyaları görmenizi sağlar; canlı kampanyaları gizlemez. Yine de tarayıcınızda test modunun açık olup olmadığına bakın:

localStorage.getItem('selwise_test_mode');

"true" dönüyorsa test modundasınız. Kapatmak için:

localStorage.removeItem('selwise_test_mode');
location.reload();

Bir test bağlantısıyla da açılıp kapanır: ?selwise_test_mode=1 açar, ?selwise_test_mode=0 kapatır.

Özel script çalışmıyor

Sırayla:

1. Kural eklenmiş mi? Script'i kaydetmek çalıştırmaz; Custom Scripts listesinde Active Scripts altında satırı görmelisiniz ve Active olmalı (hem kural hem script).
2. Yol eşleşiyor mu? Kural yalnızca location.pathname'e bakar; sorgu dizesi ve # yok sayılır. Ağ sekmesinde scripts?path=… isteğinin yanıtında script varsa kural eşleşmiştir — bkz. Sayfa Hedefleme.
3. Domain doğrulanmış mı? Doğrulanmamış kanalda config gibi scripts da 403 döner.
4. Söz dizimi hatası var mı? Script bir fonksiyona sarılmaz; üst düzey return ya da import söz dizimi hatasıdır ve script hiç çalışmaz. Konsolda Uncaught SyntaxError arayın.
5. CSP engelliyor mu? Konsolda "Content Security Policy" hatası, sitenizin satır içi scripti yasakladığını gösterir.
6. DOM hazır değil mi? Kod Selwise başladıktan sonra, temanızın DOM'u tamamlanmadan çalışabilir; elemanı bekleyin (MutationObserver).
7. Tek sayfa uygulaması mı? Kod yalnızca tam sayfa yüklemesinde çalışır; rota değişimlerinde yeniden çalışmaz ve eklediği CSS kalkar — bkz. Özel Scriptler.
8. Kaydedemiyorum — kod, CSS ve açıklamanın toplamı API'nin istek gövdesi sınırını (yaklaşık 100 KB) aşıyor olabilir, ya da özel script limitine dayandınız (409).

Yardımcı komutlar

// Sıklık sınırı sayaçlarını sıfırla
localStorage.removeItem('selwise_frequency_caps');

// Debug modunu kapat
localStorage.removeItem('selwise_debug');

Hâlâ çözülmediyse

Destek ile iletişime geçerken şunları hazırlayın:

• Kanal anahtarı (Site Key)
• Sorunun görüldüğü tam URL
• Tarayıcı konsolundaki hata mesajları
• Debug modu açıkken alınmış konsol çıktısı ve config isteğinin yanıt kodu
• Panelde sorunsa: hangi ekran, ne gördüğünüz ve rolünüz (üst çubuk → hesap menüsü)