Arama Kurulumu

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. 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. Uygulama kanalında arama kutusunu uygulamanız çizer — bkz. Arama API'si.
• Hesabınızda Search & Merchandising modülü açık olmalı; açık değilse ekran menüde görünmez (Genel Bakış).

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.

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 sayfasına bakın.

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).

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:

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)

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 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 ve Alaka ve Eşleşme 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)
Save reddediliyor: sayı sınırı	Min/Max/Debounce gibi kutuların aralığı: Yapılandırma
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

Daha fazlası için: Arama Çalışmıyor.

Sırada ne var

• Yapılandırma — davranış, sonuç görünümü, hedefleme.
• Görünüm — renk, metin, konuma özel ayarlar.
• Varyantlar — hazır deneyimler.