# Sık Sorunlar

Önce buraya bakın
Kaynak: https://selwise.com/docs/troubleshooting/common-issues

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:

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

```js
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ı](/docs/troubleshooting/delivery-rules#konsol-mesajları).

## Belirti tablosu

| Belirti | Sayfa |
|---|---|
| Widget veya kampanya görünmüyor | [Widget Görünmüyor](/docs/troubleshooting/widget-not-showing) |
| Kampanya neden atlandı, hangi kural | [Gösterim Kuralları](/docs/troubleshooting/delivery-rules) |
| Arama açılmıyor veya sonuç dönmüyor | [Arama Çalışmıyor](/docs/troubleshooting/search-not-working) |
| Öneri şeridi görünmüyor | [Öneriler Görünmüyor](/docs/troubleshooting/recommendations-not-showing) |
| Panelde veri yok, ciro görünmüyor | [Takip Sorunları](/docs/troubleshooting/tracking-issues) |
| Ürünler gelmiyor, fiyatlar yanlış | [Besleme Sorunları](/docs/product-feeds/troubleshooting) |
| Panele giremiyorum, kod istiyor, kilitlendi | [Giriş ve Erişim Sorunları](/docs/troubleshooting/access-issues) |
| Menüde bir ekran yok ya da gri | [Giriş ve Erişim Sorunları](/docs/troubleshooting/access-issues#menüde-bir-ekran-yok-ya-da-gri) |
| Özel script çalışmıyor | Aşağıda |
| Geçmiş veri aktarımı hata veriyor | [Doğrulama ve Uygulama](/docs/data-import/validate-and-apply#hataları-okuma) |
| Bir terimin anlamını bilmiyorum | [Terimler Sözlüğü](/docs/getting-started/glossary) |
| Zenginleştirme kuralı ürün sayfasında görünmüyor | [Kural Görünmüyor](/docs/product-enrichment/not-showing) |
| Mobil uygulamada anahtar, olay ya da sipariş sorunu | [SDK Sorun Giderme](/docs/mobile/troubleshooting) |
| Mobil uygulamada içerik görünmüyor | [Görünmeyen İçerik](/docs/mobile/troubleshooting-display) |

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

```js
localStorage.getItem('selwise_test_mode');
```

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

```js
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](/docs/custom-scripts/targeting).
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](/docs/custom-scripts/overview#çalışma-modeli).
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

```js
// 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ü)