# Arama Önerileri

Yazarken çıkan öneriler
Kaynak: https://selwise.com/docs/search/suggestions

Ziyaretçi arama kutusuna tıkladığında, henüz yeterince karakter yazmadan gösterilen öneriler. Boş bir arama kutusunu keşif alanına çevirir.

## Panelde nerede

**Kişiselleştirme → Arama → Configuration → Suggestions** (Personalization → Search). Dört kart vardır — **Recent Searches**, **Popular Searches**, **Popular Categories**, **Popular Products** — ve altında önerilerin görünümünü ayarlayan **Suggestion Styles** kartı.

## Ne zaman görünür

Kutu **Min Characters** değerinden kısa olduğunda (boşken) kutuya odaklanıldığı anda öneriler çizilir. Bu, **Search on Focus** ayarından bağımsızdır: o ayar, kutuda zaten yeterince karakter varken odaklanılınca aramayı çalıştırır. En az bir öneri tipi açık ve içinde gösterecek bir şey olmalıdır; hiçbiri yoksa kutu boş kalır.

Ziyaretçi **Min Characters** kadar karakter yazınca öneriler yerini arama sonuçlarına bırakır.

## Dört öneri tipi

### Son aramalar (Recent Searches)

Ziyaretçinin kendi geçmiş aramaları. Varsayılan **açık**, **Max History Count** 5 (1 – 20); arama kutusu bu kadar terimi saklar ve gösterir.

Liste ziyaretçinin tarayıcısında tutulur (`localStorage`); sunucuya gönderilmez ve başka ziyaretçilere görünmez. Yalnızca **sonuç bulan** aramalar eklenir: ziyaretçinin kendi yazım hatasını ona kısayol olarak geri sunmak anlamsızdır. Ziyaretçi listeyi ya da tek tek terimleri silebilir.

### Popüler aramalar (Popular Searches)

Varsayılan kapalı, **Max Count** 5. Açtığınızda **Data Source** seçersiniz:

| Kaynak | Anlamı |
|---|---|
| **Manual Only** | Yalnızca **Manual Search Terms** alanına elle eklediğiniz terimler |
| **Dynamic Only** | Son 30 günde bu kanalda en çok aranan terimler (en az iki karakter) |
| **Both** | Önce elle yazdıklarınız, ardından dinamik olanlar; tekrarlar atılır ve **Max Count**'ta kesilir |

Elle yazılan liste en fazla 100 terim olabilir. **Manual Only** ya da **Both** seçiliyken liste boşsa **Save** reddedilir.

### Popüler kategoriler (Popular Categories)

Varsayılan kapalı, **Max Count** 6. Kaynaklar aynıdır; farkı: **dinamik** kaynak aramalardan değil **kataloğunuzdan** gelir. Katalogdaki en kalabalık ilk seviye kategorileri (kategori yolunun `>` işaretinden önceki bölümü) ürün sayısına göre sıralar ve ilk ürünün görselini kullanır; yani yeni kurulan bir kanalda da hemen dolar. Sayım kataloğun ilk 1.000 ürününe dayanır. Elle tanımlarken kataloğunuzdaki kategoriler arasından **Category Name** seçer, isteğe bağlı **Image URL** verirsiniz.

### Popüler ürünler (Popular Products)

Varsayılan kapalı, **Max Count** 4. **Dinamik** kaynak, son 30 günde arama sonuçlarından en çok tıklanan ürünlerdir. Elle tanımlarken **Select Products** ile ürünleri seçersiniz; ürün **SKU**'su ya da ürün kodu ile eşleşir ve beslemenizde bulunmayan bir ürün sessizce atlanır. En fazla 100 ürün seçilebilir.

## Manuel mi dinamik mi

| Durum | Öneri |
|---|---|
| Yeni kurulum, arama verisi yok | Popüler aramalar ve ürünler için **Manual Only**; kategoriler için **Dynamic Only** zaten dolu gelir |
| Yeterli arama hacmi var | **Dynamic Only** |
| Kampanya dönemi | **Both**: kampanya terimlerini elle ekleyin, gerisi dinamik gelsin |

> **Dinamik aramalar ve ürünler arama kaydı ister**
>
> Dinamik popüler aramalar ve ürünler, arama kutusunun gönderdiği sorgu ve tıklama kayıtlarından hesaplanır; yeni kurulan bir kanalda liste ilk günlerde boştur. İlk haftalar **Manual Only** ile başlayın. Dinamik popüler aramalar, kutunun her duraklamada gönderdiği sorguları da sayar; eksik yazılmış terimler listede görünebilir.

## Suggestion Styles

Öneri alanlarının görünümü beş sekmeye ayrılır: **General** (başlık, bölüm aralığı, yerleşim ve çip stili), **Recent Searches**, **Popular Searches**, **Popular Categories**, **Popular Products**. **General** içindeki **Panel Layout**, `mega` (terimler tek çip satırında, kategori rayı ürün ızgarasının yanında, son aramalar en altta) ya da `stacked` seçer; `mega`, dar yüzeylerde kendiliğinden `stacked`'e düşer. Renkler varsayılan olarak [marka temasını](/docs/brand/theme) izler. Seçili sekmenin önizlemesi önizleme panelinde çizilir.

## Neden görünmüyor

| Belirti | Sebep |
|---|---|
| Hiçbir öneri çıkmıyor | Dört kartın hepsi kapalı; ya da açık olanların içi boş (dinamik kaynak, henüz kayıt yok) |
| Kutuya tıklayınca öneri yerine sonuç geliyor | Kutu zaten **Min Characters** kadar karakter içeriyor (terim sayfa tarafından kutuya yazılmış olabilir); öneriler yalnızca daha kısa içerikte çizilir |
| Son aramalar boş | Ziyaretçi bu tarayıcıda henüz sonuç bulan bir arama yapmadı ya da tarayıcı depolamayı kapattı |
| Popüler ürün listesi eksik | Seçilen ürünler beslemenizde yok; ürün **SKU**'su beslemeyle eşleşmiyor |
| **Save** reddediliyor | **Manual Only** ya da **Both** seçili ama liste boş: bir terim/ürün/kategori ekleyin ya da kaynağı **Dynamic Only** yapın |

Önerileri veren uç nokta: [Arama API'si](/docs/api-reference/search-api).