Aramaya Genel Bakış

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
Configuration (Yapılandırma)	Aramayı açma, konum, görünüm, davranış, öneriler ve sepet bağlantısı. Bkz. Kurulum ve Yapılandırma
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 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.

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
Search Redirects	Bir terimi doğrudan bir sayfaya gönderir	Yönlendirmeler
Search ranking rules	Ürünleri yükseltir, aşağı iter veya sabitler	Boost Kuralları
Zero Results	Sonuç bulamayan aramaları listeler, çözmenizi sağlar	Sonuçsuz Aramalar

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, Mobil: Öneri ve Arama

İki kanal aynı ürün beslemesini paylaşıyorsa (Paylaşılan Katalog) 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.
• 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.

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.

Sırada ne var

• Kurulum — aramayı açın ve sitenize bağlayın.
• Yapılandırma — davranış ve görünüm ayarları.
• Alaka ve Eşleşme — neyin bulunacağı.
• Sorun yaşıyorsanız: Arama Çalışmıyor.