# Yapılandırma

Davranış ve görünüm ayarları
Kaynak: https://selwise.com/docs/search/configuration

Aramanın davranışını, sonuç içeriğini ve sepet bağlantısını belirleyen ayarlar. Konum, renk ve metinler [Görünüm](/docs/search/appearance), yazarken çıkan öneriler [Öneriler](/docs/search/suggestions) sayfasında.

## Panelde nerede

**Kişiselleştirme → Arama → Configuration** (Personalization → Search); ilgili bölümler **Behavior**, **Results** ve **Integration**. Sayfanın üstündeki şeritte **Enable Search**, **Test Mode** ve dört sayaç bulunur. Hiçbir ayar **Save**'e basana kadar kaydedilmez.

> **Şeritteki sayaçlar dönem seçmez**
>
> **Searches**, **Clicks** ve **CTR** bu kanalın kuruluşundan beri biriken toplamlardır: sunucunun yanıtladığı arama isteği sayısı ve kaydedilen sonuç tıklaması. **Overview** sekmesindeki dönemli rakamlarla aynı olmaları beklenmez — bkz. [Arama Analitiği](/docs/search/analytics). **Indexed** kanalın aradığı kataloğun ürün sayısıdır; kanal kataloğunu başka bir kanaldan okuyorsa o kanalınkidir.

## Hazır ayar paketleri

**Behavior** bölümünün en üstündeki **Tuning Presets** (Tuning Presetleri), tek tıkla bir grup ayarı birlikte değiştirir. Paket yalnızca formu doldurur; **Save** edene kadar bir şey değişmez, sonrasında alanları tek tek ince ayarlayabilirsiniz.

| Paket | Değiştirdikleri |
|---|---|
| **Balanced** (Dengeli) | Min 2 karakter, en fazla 12 sonuç, 250 ms bekleme, odakta arama açık, açıklama kapalı |
| **Conversion Focused** (Dönüşüm Odaklı) | Min 1 karakter, en fazla 8 sonuç, 120 ms, stokta olmayanlar hariç, stok durumu açık, popüler ürünler (dinamik, 6) açık |
| **Discovery Focused** (Keşif Odaklı) | Min 2 karakter, en fazla 20 sonuç, 180 ms, açıklama açık, kategori etiketleri, popüler aramalar (her ikisi) ve popüler kategoriler (dinamik, 8) açık |

**Overview** sekmesindeki **Low-Result Action Center**'daki "Apply discovery tuning preset" bağlantısı bu paketi doğrudan uygular.

## Davranış (Behavior)

| Ayar | Yeni kanalın varsayılanı | Aralık | Açıklama |
|---|---|---|---|
| **Min Characters** | 2 | 1 – 10 | Kaç karakterden sonra arama çalışsın. Daha azında arama çalışmaz; kutu boşsa öneriler gösterilir. |
| **Max Results** | 10 | 1 – 50 | Gösterilecek en fazla ürün. **Min Characters** değerinden küçük olamaz. |
| **Debounce (ms)** | 300 | 0 – 2000 | Yazma durduktan sonra aramanın başlayacağı bekleme. |
| **Hotkey** | boş | en fazla 20 karakter | `Ctrl+` ile tek tuş (`Ctrl+K`). Mac'te ⌘ da çalışır. Başka biçim çalışmaz. |
| **Search on Focus** | Kapalı | | Kutuya tıklandığında içinde zaten yeterince karakter varsa aramayı hemen çalıştırır. Öneriler bu anahtardan bağımsız olarak, kutu boşken odakta görünür. |
| **Keep Open** | Kapalı | | Kutunun dışına tıklayınca sonuç paneli kapanmasın. |
| **Mobile Fullscreen** | Açık | | Küçük ekranlarda arama tam ekran açılsın. |

> **Debounce neden var**
>
> Her tuş vuruşunda sunucuya istek gitmesi hem yavaş hem gereksizdir; bekleme, ziyaretçi yazmayı bıraktığında tek bir istek atılmasını sağlar. Çok düşürmeyin: 0 her tuş vuruşunda bir arama demektir; 100 ms'nin altına inmeyin. Bekleme süresi arama sayısını da etkiler: widget her duraklamadaki sorguyu ayrı bir arama sayar ([Arama Analitiği](/docs/search/analytics)).

Sayı kutuları, sınırın dışına çıkarsa kutunun altında nedenini yazar ve **Save** kapanır; sunucu aynı sınırları `400` ile uygular.

## Sonuç görünümü (Results)

**Result Display** kartı:

| Ayar | Varsayılan | Açıklama |
|---|---|---|
| **Layout** | List | List, Grid, Compact, Large |
| **Image Size** | Medium | Small, Medium, Large |
| **Product Card Template** | Default (Standard) | Sonuçların hangi ürün kartıyla çizileceği. Hiç seçmezseniz, kanalda varsayılan olarak işaretlenmiş bir kart varsa o kullanılır. Kartı seçerseniz aşağıdaki yerleşim ayarlarını geçersiz kılar — bkz. [Ürün Kartları](/docs/product-cards/overview) |

**Show Elements** onay kutuları: **Images** (açık), **Description** (kapalı), **Prices** (açık), **Old Price** (açık), **Discount Badge** (açık), **Stock Status** (kapalı), **Category** (kapalı), **Highlight Match** (açık). **Highlight Match** arama teriminin sonuç metninde vurgulanmasını sağlar; vurgunun rengi **Badges and Highlights** stil bölümündedir.

**Exclude Out of Stock** açıksa stokta olmayan ürünler sonuçlarda hiç görünmez; kapalıysa görünür ve **Stock Status** ile işaretlenebilir. Doğrusu mağazanıza bağlıdır: tükenen ürünü göstermek ziyaretçiyi hayal kırıklığına uğratır, tamamen gizlemek ise "bu üründe yok mu" sorusunu doğurur. Ayrıntı: [Alaka ve Eşleşme](/docs/search/relevance).

**Categories** kartı: **Display Mode** (None, Filter Chips, Sidebar, Dropdown; varsayılan None) ve **Max Visible** (3 – 50, varsayılan 10). Kategori listesi eşleşen ürünlerin en kalabalık 20 kategorisinden gelir.

## Segment hedefleme

**Behavior** bölümünün sonundaki **Audience Targeting** (Kitle Hedefleme) kartında **Targeting Mode** üç seçenek sunar: **All Users** (varsayılan), **Specific Segments** (aramayı yalnızca seçili segmentlere göster) ve **Exclude Segments** (seçili segmentlerden gizle). Segment seçmeden **Specific Segments** ya da **Exclude Segments** ile kayıt reddedilir. Nadiren gerekir; ayrıntı: [Segment Hedefleme](/docs/segments/targeting).

## Sepete ekleme (Integration)

**Integration** bölümü arama sonucunda **Add to Cart** düğmesinin nasıl çalışacağını belirler.

- **Enable Add to Cart**: yeni kanalda **açık**.
- **Cart Platform**: **Shopify**, **Akinon**, **IdeaSoft**, **ikas**, **Ticimax**, **T-Soft**, **Custom Script** ve **Custom API**. Varsayılan **Custom Script**'tir.
- **Custom Script** seçiliyse kendi JavaScript'inizi yazarsınız. Kodda `productItemCode`, `productId`, `itemCode`, `productName`, `productPrice` ve `quantity` değişkenleri, ayrıca `${productItemCode}` ve `${quantity}` şablon işaretleri kullanılabilir. Editördeki örnek kod yalnızca örnektir ve **kaydedilmez**.

> **Yeni kanalda Save neden reddedilir**
>
> **Enable Add to Cart** açıkken ve platform **Custom Script**'ken betik boşsa **Save** reddedilir ("Custom cart script is required for custom cart platform"); bu iki değer yeni bir kanalda varsayılandır. Geçerli bir JavaScript yazın, bir platform seçin ya da **Enable Add to Cart**'ı kapatın. Sözdizimi hatalı bir betik de kaydedilmez.

Platform ayrıntıları ve ürünün hangi kodla sepete gireceği: [Sepete Ekleme](/docs/recommendations/add-to-cart), [Özel Platform](/docs/integration/custom-platform).

## Sınırlar özeti

| Alan | Sınır |
|---|---|
| **Min Characters** | 1 – 10 |
| **Max Results** | 1 – 50 (public API'de `limit` en çok 100) |
| **Debounce (ms)** | 0 – 2000 |
| **Max Visible** (kategori) | 3 – 50 |
| Öneri sayıları (son, popüler arama, kategori, ürün) | 1 – 20 |
| Elle yazılan popüler arama ve ürün listeleri | en fazla 100 öğe |
| **Hotkey** | en fazla 20 karakter |
| **CSS Selector** ve **Use Custom Trigger** | en fazla 255 karakter |

## Neden kaydedilmiyor

Kayıt reddedilirse sayfanın üstünde nedeni ve ilgili bölüm yazılır; form o bölüme geçer. En sık sebepler: **Inline** konumunda boş **CSS Selector**, sınırın dışında bir sayı, manuel kaynakta (**manual** ya da **both**) boş liste, Specific Segments ya da Exclude Segments'te seçilmemiş segment, ve yukarıdaki özel sepet betiği.