# Arama Kurulumu

Aramayı açma ve bağlama
Kaynak: https://selwise.com/docs/search/setup

Aramayı açmak, sitenizin arama kutusuna bağlamak ve yayına almadan önce denemek.

## Panelde nerede

**Kişiselleştirme → Arama → Configuration** (Personalization → Search) (Yapılandırma). Sayfanın üstündeki şeritte aramanın açma anahtarı (**Enable Search**, TR: Aramayı Etkinleştir), **Test Mode** (Test Modu) anahtarı, dört sayaç (**Searches**, **Clicks**, **CTR**, **Indexed**) ve **Reindex** (Yeniden İndeksle) ile **Save** (Kaydet) düğmeleri bulunur. Ayarlar beş bölümde toplanır: **Appearance** (Görünüm), **Results** (Sonuçlar), **Behavior** (Davranış), **Suggestions** (Öneriler), **Integration** (Entegrasyon). Yanda, ayarları değiştirdikçe güncellenen bir önizleme çizilir (örnek ürünlerle; kataloğunuzdaki ürünleri göstermez).

Hiçbir değişiklik **Save**'e basana kadar kaydedilmez. Kaydedince sunucudaki arama ayarı önbelleği temizlenir; sitede açık duran bir sayfa yenilenene kadar eski ayarı kullanır.

## Başlamadan önce

- Kanalınızda ürün beslemesi kurulu ve senkronize olmalı — bkz. [Ürün Beslemeleri](/docs/product-feeds/overview). Besleme boşsa arama açılır ama hiçbir şey bulmaz.
- Web sitesi kanalı için widget kodu sitede kurulu olmalı — bkz. [Widget Kurulumu](/docs/integration/widget-installation). Uygulama kanalında arama kutusunu uygulamanız çizer — bkz. [Arama API'si](/docs/api-reference/search-api).
- Hesabınızda **Search & Merchandising** modülü açık olmalı; açık değilse ekran menüde görünmez ([Genel Bakış](/docs/search/overview)).

## 1. Aramayı açın

**Enable Search** anahtarını açın. Varsayılan olarak **kapalıdır**: kapalıyken widget arama kodunu hiç indirmez ve arama uçları boş yanıt döner.

> **Kapalıyken maliyet yok**
>
> Arama kapalıysa arama kodu sitenize hiç yüklenmez. Bu bilinçli bir tasarımdır: kullanmadığınız modül sayfa ağırlığınıza eklenmez.

## 2. Konum seçin

**Appearance** bölümünde, **Search Position** kartında altı konumdan birini seçin:

| Konum (panel etiketi) | Davranış | Ne istenir |
|---|---|---|
| **Inline** (Satır İçi) | Sayfanın içine, bir elementin içine gömülü arama kutusu | **CSS Selector** zorunlu |
| **Modal Popup** (Modal Açılır Pencere) | Ekranın ortasında açılan pencere | Açan bir tetikleyici |
| **Mega Panel** | Site başlığının altına yerleşen, tam genişlikte panel (mağaza mega menüsü gibi) | Açan bir tetikleyici |
| **Floating Button** (Yüzen Buton) | Köşede duran arama düğmesi; tıklayınca modal pencere açılır | Köşe seçimi |
| **Sidebar Panel** (Yan Panel) | Yandan kayarak açılan tam yükseklikte panel | Açan bir tetikleyici |
| **Fullscreen** (Tam Ekran) | Tam sayfa arama katmanı | Açan bir tetikleyici |

Her konumun kendine özgü ayarları (genişlik, gölge, kenar boşlukları vb.) aynı kartın altında, yalnızca o konumun kullandığı alanlarla görünür. Tüm renk, tipografi ve metin ayarları için [Görünüm](/docs/search/appearance) sayfasına bakın.

> **Ürün kataloğu için Mega Panel**
>
> **Mega Panel**, sonuçları kart ızgarası olarak, kategori filtrelerini yanında gösterir. **Modal Popup** ise dar bir sütundur: 600 piksel genişlikte bir pencereye tek bir ürün kartı sığar. Görsel ağırlıklı bir katalogda **Mega Panel** seçin.
>
> Mega Panel'in yerleşimi **Styling** kartında değil, konum kartının altındaki **Mega Panel Settings** bölümünde ayarlanır: **Dock Under Element (CSS selector)** panelin hangi elementin altına yerleşeceğini, ayrıca en fazla genişliği, iç boşlukları ve gölgeyi belirler. Yükseklik ölçülerek bulunur; sabit bir değer girmezsiniz, çünkü duyuru şeridi olan bir başlığın yüksekliği sayfadan sayfaya değişir.

## 3. Aramanın nasıl açılacağını bağlayın

Inline dışındaki her konumda arama bir tıklamayla açılır; bunun için üç yol vardır:

| Yol | Ne yapar |
|---|---|
| **Use Custom Trigger (Optional)** | Sitenizdeki mevcut arama kutusunun ya da düğmesinin CSS seçicisini yazın (`.my-search-btn`). Ziyaretçi o elemente tıkladığında Selwise araması açılır; Selwise'ın kendi düğmesi çizilmez. |
| Seçici boş bırakılırsa | Widget köşede kendi yüzen düğmesini çizer — **Modal Popup**, **Mega Panel**, **Sidebar Panel** ve **Fullscreen** konumlarında da. Köşeyi **Floating Button Position** seçer (varsayılan **Bottom Right**). |
| **Hotkey** | **Behavior** bölümünde bir klavye kısayolu: `Ctrl+K` gibi, `Ctrl+` ile tek bir tuş. Mac'te ⌘ da çalışır. Başka biçim (örneğin `cmd+k` ya da `Shift+S`) kaydedilir ama hiçbir zaman çalışmaz. |

**Floating Button** konumuyla bir tetikleyici seçici de yazarsanız Selwise kendi düğmesini çizmez ve davranış **Modal Popup** ile birebir aynı olur; panel bunu yazarak uyarır.

Yüzen düğmeyi sitenizin bir elementinin içine yerleştirmek için **Embed Button in Element** alanını kullanın: **Target Selector** düğmenin gireceği elementi, **Injection Position** nereye gireceğini belirler (**Append**, **Prepend**, **Before**, **After**, **Replace Target**).

> **İki arama birden açılıyorsa**
>
> Tetikleyici olarak seçtiğiniz element temanızın kendi aramasına da bağlıysa tek tıklamada iki panel birden açılır. Selwise'ın dinleyicisi temanınkinin yanına eklenir; sonradan eklenen bir dinleyici öncekini iptal edemez.
>
> Bu durumda **Trigger Setting** kutusunda, özel tetikleyici seçiciyi yazdığınızda beliren **Trigger Replaces Existing Handler** seçeneğini açın: Selwise tıklamayı yakalama aşamasında alır ve temanın dinleyicisine hiç ulaşmaz. Tetikleyiciniz aynı zamanda bir menü açıyorsa bu seçeneği kapalı bırakın; o dinleyicinin de çalışması gerekir.

**Mega Panel** konumunda özel tetikleyici verirseniz panel, varsayılan olarak o elementin en yakın başlığının (`header`) altına yerleşir; açık bir yerleşim için **Dock Under Element** alanını doldurun.

**Inline** konumunda **CSS Selector (where to place search box)** alanına aramanın yerleşeceği elementi yazarsınız; kutu o elementin içine eklenir. Bu alan boşsa **Save** reddedilir.

## 4. Kaydedin ve test edin

Yayına almadan önce **Test Mode** anahtarını açıp kaydedin. Test modunda arama yalnızca, tarayıcısında şu işareti koymuş kişilere görünür; ziyaretçileriniz hiçbir şey görmez:

```js
localStorage.setItem('selwise_test_mode', 'true');
location.reload();
```

Her şey doğruysa **Test Mode**'u kapatıp yeniden kaydedin. Deneme listesi:

1. Arama kutusu ya da düğme görünüyor ve açılıyor mu (tetikleyici seçici doğru mu)?
2. Birkaç gerçek ürün adı yazın; sonuç geliyor mu?
3. Bir sonucu tıklayın; ürün sayfasına gidiyor mu?
4. **Overview** sekmesinde, birkaç dakika sonra arama ve tıklama sayısı artıyor mu? ([Arama Analitiği](/docs/search/analytics))

## 5. Sitenizin kendi aramasını devre dışı bırakın

Selwise araması çalışır hale geldiğinde sitenizin kendi arama sonuç sayfası hâlâ erişilebilir kalır. İki arama deneyimi bir arada olursa ziyaretçi ve analitik kafa karışır; özel tetikleyiciyi doğru bağladığınızdan emin olun. Mağazanın kendi aramasının olayları veri katmanı üzerinden de gönderiliyorsa [Arama Analitiği](/docs/search/analytics) sayfasındaki arama sayısı o aramayı da içerebilir.

## Reindex düğmesi

Arama, ürünleri doğrudan kataloğunuzdan okur; ayrı bir arama dizini yoktur ve bir ürün besleme senkronundan geçtiği anda aranabilir. **Reindex** düğmesi bir arka plan işi başlatır ve ilerleme bandı çizer; bu motorda yeniden kurulacak bir dizin olmadığı için iş yalnızca kanalın bir beslemesi ve ürünü olduğunu denetler. Aranan ürün çıkmıyorsa çözüm **Reindex** değil, [beslemenin senkronu](/docs/product-feeds/runs) ve [Alaka ve Eşleşme](/docs/search/relevance) sayfasındaki kontrol listesidir. **Indexed** sayacı kanalın aradığı kataloğun ürün sayısını gösterir (paylaşılan katalogda kaynak kanalınkini); ölçülemezse çizgi (—) görünür.

Bir kanalda besleme ve ürün yoksa **Reindex** `Product feed not found` ya da `No products found to index` ile reddedilir.

## Neden görünmüyor, neden kaydedilmiyor

| Belirti | Sebep |
|---|---|
| Sitede arama hiç görünmüyor | **Enable Search** kapalı; ya da **Test Mode** açık ve tarayıcıda `selwise_test_mode` işareti yok; ya da kanal için bir segment hedeflemesi seçili ve ziyaretçi o segmentte değil |
| Açılıyor ama kutu yok / yanlış yerde | **Inline** konumunda seçici sayfada bulunamıyor (konsolda `document.querySelector('SEÇİCİNİZ')` `null` dönüyorsa seçici yanlıştır) |
| Tetikleyiciye tıklayınca hiçbir şey olmuyor | Seçici sayfadaki gerçek elemente uymuyor |
| **Save** reddediliyor: özel sepet betiği zorunlu | **Integration** bölümünde **Enable Add to Cart** açık ve platform **Custom Script**; ya bir betik yazın, ya platformu seçin, ya da sepete eklemeyi kapatın. Yeni bir kanalda bu iki değer varsayılan olarak böyledir ([Yapılandırma](/docs/search/configuration)) |
| **Save** reddediliyor: sayı sınırı | Min/Max/Debounce gibi kutuların aralığı: [Yapılandırma](/docs/search/configuration) |
| Menüde **Search** yok | Modül hesabınızda tanımlı değil (`402`) |
| Bazı ziyaretçilerde arama çizilmiyor | Arama ayarına bağlı bir A/B testinde kol, aramayı başka bir modülle değiştiriyorsa o kolun ziyaretçisinde Selwise araması çizilmez — bkz. [A/B Testleri](/docs/experiments/overview) |

Daha fazlası için: [Arama Çalışmıyor](/docs/troubleshooting/search-not-working).

## Sırada ne var

- [Yapılandırma](/docs/search/configuration) — davranış, sonuç görünümü, hedefleme.
- [Görünüm](/docs/search/appearance) — renk, metin, konuma özel ayarlar.
- [Varyantlar](/docs/search/variants) — hazır deneyimler.