# Aramaya Genel Bakış

Arama modülü nasıl çalışır
Kaynak: https://selwise.com/docs/search/overview

Selwise arama modülü, mağazanızın ürün aramasının yerine geçer: ziyaretçi yazarken ürün gösterir, yazım farklarını ve çekim eklerini tolere eder, sizin yazdığınız kurallarla yönetilir ve aramanın ciroya katkısını ölçer. Aynı arama motoru hem web sitesi hem mobil uygulama kanalında çalışır.

## Panelde nerede

Sol menüde **Kişiselleştirme → Arama** (Personalization → Search). Modül tek bir ekran gibi davranır ve üç sekmesi vardır:

| Sekme | Ne var |
|---|---|
| **Overview** (Genel Bakış) | Arama hacmi, aramadan satın almaya huni, aramadan gelen siparişler, en çok aranan sorgular, en çok tıklanan ürünler. Bkz. [Arama Analitiği](/docs/search/analytics) |
| **Configuration** (Yapılandırma) | Aramayı açma, konum, görünüm, davranış, öneriler ve sepet bağlantısı. Bkz. [Kurulum](/docs/search/setup) ve [Yapılandırma](/docs/search/configuration) |
| **Content** (İçerik) | Aramanın kuralları: **Zero Results**, **Search Synonyms**, **Search Redirects**, **Search ranking rules** |

Sol menüde bu dört kural ekranının ayrı bir satırı yoktur; hepsine **Content** sekmesinden (ya da Overview'daki dört kısayol kartından) ulaşırsınız.

## Ne işe yarar

Arama kutusu en yüksek niyetli ziyaretçinin kullandığı yerdir; orada boş ekran görmek en pahalı kayıptır. Modülün iki işi var: ziyaretçiyi ürüne ulaştırmak, ve ulaştıramadığında bunu size söylemek. İkincisi için [Sonuçsuz Aramalar](/docs/search/zero-results) ekranı, çözümü de oradan bir tıkla (eş anlamlı, yönlendirme) yazdırır.

## Bir arama nasıl yanıtlanır

Ziyaretçinin yazdığı terim sunucuda şu sırayla işlenir:

```
Arama kapalı mı?            → kapalıysa boş yanıt, kod hiç yüklenmez
  → Yönlendirme kuralı var mı?   → varsa ziyaretçi o sayfaya gider, arama çalışmaz
  → Terim temizlenir             → baştaki eksi işareti atılır
  → Eş anlamlılar uygulanır      → terimdeki kelimenin yerine karşılığı konur
  → Türkçe çekim ekleri eklenir  → ruj / rujlar gibi
  → Ürün adı, marka, kodlar, kategori taranır (tam metin)
  → Hiç sonuç yoksa              → yazım hatası toleransı (ürün adına bakar)
  → Sıralama kuralları           → yükseltme, aşağı itme, sabitleme
  → Sonuç döner; hâlâ sıfırsa    → terim Sonuçsuz Aramalar listesine yazılır
```

Ne neyi bulur, hangi alanlar taranır ve neden bir ürün çıkmaz: [Alaka ve Eşleşme](/docs/search/relevance).

Arama ayrı bir arama sunucusu gerektirmez; ürün kataloğunuz (PostgreSQL üzerinde `products.search_vector`) üzerinde çalışır. Besleme senkronize olduğu anda ürün aranabilir, ayrıca bir indeksleme beklenmez.

## Yönetim araçları

| Araç | Ne yapar | Sayfa |
|---|---|---|
| **Search Synonyms** | Farklı yazımları ve isimlendirmeleri eşleştirir | [Eş Anlamlılar](/docs/search/synonyms) |
| **Search Redirects** | Bir terimi doğrudan bir sayfaya gönderir | [Yönlendirmeler](/docs/search/redirects) |
| **Search ranking rules** | Ürünleri yükseltir, aşağı iter veya sabitler | [Boost Kuralları](/docs/search/boost-rules) |
| **Zero Results** | Sonuç bulamayan aramaları listeler, çözmenizi sağlar | [Sonuçsuz Aramalar](/docs/search/zero-results) |

Bunlar kanala özeldir: bir kanalda yazdığınız eş anlamlı, yönlendirme veya sıralama kuralı diğer kanalları etkilemez.

## Web sitesi ve uygulama kanalı

| | Web sitesi | Uygulama |
|---|---|---|
| Arama kutusunu kim çizer | Selwise widget'ı | Uygulamanız kendi bileşenleriyle |
| **Configuration** sekmesi (konum, stil, tetikleyici, öneri) | Widget'a uygulanır | Uygulamanın çizimini etkilemez; konum ve stil ayarları web widget'ına aittir |
| Eş anlamlı, yönlendirme, sıralama kuralı, sonuçsuz arama | Çalışır | Aynı kurallar, aynı motor |
| Nasıl bağlanır | Widget kodu | `useSelwiseSearch` ve public API: [Arama API'si](/docs/api-reference/search-api), [Mobil: Öneri ve Arama](/docs/mobile/recommendations) |

İki kanal aynı ürün beslemesini paylaşıyorsa ([Paylaşılan Katalog](/docs/channels/shared-catalog)) arama o beslemedeki ürünleri arar; ama eş anlamlılar, yönlendirmeler, sıralama kuralları, sonuçsuz arama listesi ve sayaçlar her kanalda ayrıdır.

## Gereken

- **Search & Merchandising** modülü hesabınıza tanımlı olmalı. Tanımlı değilse **Search** ekranı menüde hiç görünmez; aramanın public uçları ve yönetim API'si `402` döner (`MODULE_NOT_ENTITLED`). Modülü hesap yöneticiniz açar.
- Ürün kataloğu: besleme kurulu ve senkronize olmalı — bkz. [Ürün Beslemeleri](/docs/product-feeds/overview).
- Aramanın açık olması: **Enabled** anahtarı varsayılan olarak **kapalıdır**.
- Bir kanal seçili olmalı; kanal seçilmemişse tüm ekranlar "Site Seçilmedi" (No Site Selected) durumunda bekler.

## Kim ne yapabilir

| Yetki | Admin | Marketing |
|---|---|---|
| Ekranları ve sayıları görmek (`search:view`) | Evet | Evet |
| Yapılandırmayı kaydetmek, Reindex (`search:update`) | Evet | Hayır |
| Eş anlamlıları yönetmek (`search:manage_synonyms`) | Evet | Evet |
| Yönlendirmeleri yönetmek (`search:manage_redirects`) | Evet | Evet |
| Sıralama kurallarını yönetmek (`search:manage_boosts`) | Evet | Hayır |
| Sonuçsuz aramaları görmek (`search:view_zero_results`) | Evet | Hayır |
| Sonuçsuz aramayı çözümlemek (`search:resolve_zero_results`) | Evet | Hayır |

Eksik yetki `403` döner ve ilgili ekran veri yükleyemez; eksik modül ise `402` döner ve ekranın kendisi kaldırılır. İkisinin sebebi farklıdır: yetkiyi hesabınızdaki yönetici verir, modülü hesap yöneticiniz. Rollerin tamamı için: [Kullanıcılar ve Roller](/docs/settings/users-and-roles).

## Sınırlar

Eş anlamlı, yönlendirme ve sıralama kuralı sayısı sözleşmenizdeki sınırla ölçülür ve **hesabın tüm kanallarında toplam** sayılır. Sınıra ulaşınca bir sonrakini eklemek engellenir (`409`, `LIMIT_REACHED`); ekranlar "x / sınır" göstergesini ve bir uyarı bandını çizer. Var olanlar silinene ya da sınır yükseltilene kadar yeni kural eklenemez. Arama istekleri sayısı ise yalnızca izlenir ve hiçbir zaman aramayı durdurmaz.

## Ölçüm

Modül kendi metriklerini toplar: arama sayısı, sonuç tıklaması, sonuçsuz aramalar, aramadan satın alan kişiler ve aramanın sahip olduğu siparişler. Her sayının neyi saydığı ve neyi saymadığı: [Arama Analitiği](/docs/search/analytics).

## Sırada ne var

- [Kurulum](/docs/search/setup) — aramayı açın ve sitenize bağlayın.
- [Yapılandırma](/docs/search/configuration) — davranış ve görünüm ayarları.
- [Alaka ve Eşleşme](/docs/search/relevance) — neyin bulunacağı.
- Sorun yaşıyorsanız: [Arama Çalışmıyor](/docs/troubleshooting/search-not-working).