Shopify araması çalışmıyor mu? Anlık ve normal aramayı kontrol edin

Kısa yanıt

İşe anlık aramayı (predictive search; müşteri yazarken çıkan öneriler) normal aramadan (Enter’dan sonra gösterilen sonuç sayfası) ayırarak başlayın. Yayındaki vitrinde bilinen bir sorguyu test edin, sonra sorguyu ve ürünün uygunluğunu kontrol edin. Sonuçlar hâlâ beklediğiniz gibi değilse Search & Discovery’de sonuç türlerini karşılaştırın ve herhangi bir şeyi düzenlemeden önce arama uygulamalarını, özel kodu ve temayı inceleyin.

  • Shopify’ın yerleşik online mağaza araması, ürünleri, blog yazılarını ve sayfaları döndürebilen varsayılan vitrin aramasıdır.
  • Yerleşik arama anlık aramayı ve normal aramayı içerir; bu yüzden önerilerde sorun olması, sonuç sayfasında da sorun olduğu anlamına gelmez.
  • Anlık arama, müşteri yazarken ve Enter’a basmadan önce sonuç önerir; normal arama ise müşteri bir terim girip Enter’a bastıktan sonra bir sonuç sayfası gösterir.
  • Yerleşik arama tam kelimeleri eşleştirir; yani bir kelimenin bir kısmı, başlığında o kelimenin tamamı geçen bir ürünü bulamayabilir.
  • Stopword’ler arama için dizine eklenmeyen yaygın kelimelerdir; tek başına bir stopword aramak hiç sonuç döndürmez.

Hangi arama davranışının bozuk olduğunu belirleyin

Shopify’ın yerleşik online mağaza araması, ürünleri, blog yazılarını ve sayfaları döndürebilen varsayılan vitrin aramasıdır. Anlık aramayı ve normal aramayı içerir; bu yüzden önerilerde sorun olması, sonuç sayfasında da sorun olduğu anlamına gelmez.

Anlık arama, müşteri yazarken ve Enter’a basmadan önce sonuç önerir; normal arama ise müşteri bir terim girip Enter’a bastıktan sonra bir sonuç sayfası gösterir. İkisini ayrı ayrı kontrol edin: yayındaki vitrinde bilinen bir sorgu girin, önerilerin çıkıp çıkmadığını not edin, sonra aynı sorguyu gönderip sonuç sayfasını inceleyin.

Görünür ve aranabilir bir ürünle eşleşmesi gerektiğini bildiğiniz bir sorguyla başlayın. İki deneyim de başarısızsa tema kodunu değiştirmeden önce sorguyu, ürünün uygunluğunu ya da aramayı neyin çalıştırdığını araştırın. Normal sonuçlar çalışıyor ama öneriler çalışmıyorsa anlık arama ayarlarına ve önerileri gösteren tema davranışına odaklanın.

Kastettiğiniz ekran vitrindeki arama kutusu değil de Shopify Live View ise bunu ayrı bir sorun olarak ele alın ve Live View rehberini kullanın; bu yazı müşterinin gördüğü vitrin aramasını anlatıyor.

Sorguyu ve ürünün aranabilir olup olmadığını kontrol edin

Bir ürün ilgili görünse bile sorgu hiçbir şey döndürmeyebilir; bu yüzden aramanın bozuk olduğunu varsaymadan önce müşterinin ne yazdığına bakın. Yerleşik arama tam kelimeleri eşleştirir; yani bir kelimenin bir kısmı, başlığında o kelimenin tamamı geçen bir ürünü bulamayabilir.

Stopword’ler arama için dizine eklenmeyen yaygın kelimelerdir; tek başına bir stopword aramak hiç sonuç döndürmez. Kısa bir parça ya da yaygın bir bağlaç yerine ürün başlığından ayırt edici, tam bir kelimeyle test edin. Böylece yayındaki vitrini test ederken daha temiz bir karşılaştırma yaparsınız.

Ardından ürünün Unlisted olarak ayarlanmadığını doğrulayın. Unlisted durumundaki ürünler yerleşik online mağaza aramasının dışında tutulur. Ürün uygun olduğu hâlde yine görünmüyorsa, başlığını ya da diğer ürün verilerini değiştirmeden önce mağazanın bir uygulama ya da özel bir arama deneyimi kullanıp kullanmadığına bakın.

Sorgunun arama sözdizimi (search syntax) kullanıp kullanmadığını da kontrol edin. Arama sözdizimi kullanan aramalar yazım hatası toleransı, anlık arama ya da anlamsal kavrama almaz. Müşterinin sorgusunda sözdizimi varsa, farkı bir tema hatası saymadan önce onu sade dille yazılmış bir sürümüyle karşılaştırın.

Anlık aramayı normal sonuç sayfasıyla karşılaştırın

Anlık arama ve normal arama sonuç türlerini ayrı ayrı ister; bu yüzden öneriler ve gönderilen sonuç sayfası farklı türde içerikler gösterebilir. Bir ürünün bir deneyimde görünüp diğerinde görünmemesi, tek başına, ikisinden birinin bozuk olduğunu kanıtlamaz.

Anlık arama ve normal arama için hangi sonuç türlerinin istendiğini Shopify Search & Discovery’de kontrol edin. Bu ayarları müşterinin görmeyi beklediği sonuç türüyle karşılaştırın ve aynı sorguyu iki deneyimde de test edin. Hangi deneyimde beklenen türün eksik olduğunu belirleyene kadar ayarları değiştirmeyin.

İstenen türler doğru görünüyorsa her deneyimin gerçekte ne gösterdiğini kaydedin ve uygulama ile tema kontrollerine geçin. Sorguyu ve beklenen sonucu sabit tutmak, bir yapılandırma farkını bir görüntüleme sorunundan ayırt etmeyi kolaylaştırır.

Temayı değiştirmeden önce uygulamaları ve özel aramayı kontrol edin

Yerleşik aramada hata ayıklamaya başlamadan önce vitrinin onu kullanıp kullanmadığını netleştirin. Üçüncü taraf bir arama uygulaması, online mağaza sonuçlarını Shopify’ın yerleşik arama davranışı yerine kendisi sağlayabilir; temanın arama şablonunu değiştiren bir uygulama da sonuçları etkileyebilir.

Beklenmedik sonuçlarda üçüncü taraf bir arama uygulaması olup olmadığına bakın, ürünün Unlisted olmadığını doğrulayın ve stopword sorgusu ihtimalini eleyin. Aramayı bir uygulama sağlıyorsa yerleşik arama davranışının geçerli olduğunu varsaymak yerine uygulamanın ayarlarını ve dokümantasyonunu inceleyin. Bir uygulama arama şablonunu değiştiriyorsa bu değişikliği de incelemenize dahil edin.

Storefront API ile kurulmuş özel bir arama deneyimi, varsayılan sonuç sayfasından bağımsız çalışır. Bir geliştirici böyle bir deneyim kurduysa sorgusunu işleyen ve yanıtını gösteren kodu izleyin; varsayılan sonuç şablonunu değiştirmek o ayrı deneyimdeki bir sorunu çözmeyebilir.

Bu ayrım sık yapılan bir sapmayı önler: sonuçlar başka bir yerden yönetilirken tema işaretlemesini düzenlemek. Önce arama altyapısını belirleyin, sonra sonuçları gerçekten sağlayan ya da gösteren bileşeni inceleyin.

Temanın arama kodunu güvenle inceleyin

Sorun yalnızca temada görünüyorsa, örneğin gönderilen sonuçlar geliyor ama sayfa ya da anlık arama açılır listesi onları göstermiyorsa, ilgili arama formunu, şablonu ve özel script’leri inceleyin. Yerleşik online mağaza araması herhangi bir kurulum ya da tema değişikliği gerektirmez; bu yüzden işe vitrinin arama davranışını değiştirmiş olabilecek değişiklikleri arayarak başlayın.

Düzenlemeden önce temanın kopyasını oluşturun; böylece bir deneme yeni bir soruna yol açarsa değişiklikleri atıp asıl temaya dönebilirsiniz. Ardından tema kod düzenleyicisinin tüm dosyalarda arama özelliğini kullanarak aramayla ilgili formları, şablonları ve script’leri bulun. Görünen arama kutusundan sorguyu gönderen ya da yanıtı gösteren koda kadar referansları izleyin; hangi yolun bozuk olduğunu bilmeden geniş çaplı düzenleme yapmayın.

Her seferinde tek bir şeyi değiştirin ve aynı bilinen sorguyla hem anlık önerileri hem normal sonuç sayfasını yeniden test edin. Böylece bir değişikliğin gönderimi mi, gösterimi mi, yoksa yalnızca tek bir arama davranışını mı etkilediğini ayırt edersiniz. Sorun bir uygulama ya da tema özelleştirmesinden sonra başladıysa ilgili kodu veya yapılandırmayı o değişiklikten önceki sürümle karşılaştırın.

İncelemenin parçası olarak düzenlenen kod üzerinde Theme Check çalıştırın. Düzenlenen kodda ayrıştırmayı engelleyen script’leri ve eksik şablonları işaretleyebilir; bu bulguları ipucu olarak kullanın, sonra vitrinin gerçek davranışını doğrulayın. Temiz bir kontrol sonucu iki arama deneyimini test etmenin yerini tutmaz.

Alaka düzeyi ve sonuç türleri için beklentiyi doğru kurun

Her sıralama farkı bir hata değildir. Mağaza sahipleri arama alaka düzeyini ürün verileri ve Search & Discovery üzerinden etkileyebilir, ama sonuçların sırasını belirleyemez. Belirli bir ürünü bir sıraya zorlamaya çalışmadan önce ürün bilgilerinin müşterilerin kullandığı terimleri açıkça yansıtıp yansıtmadığını gözden geçirin.

Stoğu tamamen tükenmiş ürünler varsayılan olarak sonuçların sonunda görünür. Beklediğiniz sıralamayı vitrinin gösterdiğiyle karşılaştırırken stok durumunu hesaba katın ve daha aşağıda çıkan bir sonucu hiç çıkmayan bir sonuçtan ayırın.

Yerleşik arama en fazla iki sayfa ya da makale içerir ve bunları yalnızca ilk sonuç sayfasında gösterir. Bir sayfa ya da makale eksikse, arama şablonunun bozulduğuna karar vermeden önce o sonuç türünün istenip istenmediğine ve ilk sayfaya bakıp bakmadığınıza dikkat edin.

Bu ön incelemenin amacı, bozuk olan katmanı bulmaktır: sorgu eşleştirme, ürün uygunluğu, istenen sonuç türleri, bir uygulama ya da özel altyapı veya tema gösterimi. Sorguyu, nerede başarısız olduğunu ve neyi değiştirdiğinizi kaydedin; böylece bir sonraki kontrol odaklı olur ve sorun giderme birbiriyle ilgisiz düzenlemeler dizisine dönüşmez.

Sık sorulan sorular

Adının bir kısmını aradığımda ürün neden çıkmıyor?
Yerleşik arama tam kelimeleri eşleştirir; bu yüzden bir kelimenin bir kısmı, ürün başlığındaki tam kelimeyle eşleşmeyebilir. Tam ve ayırt edici bir kelimeyle test edin ve ürünün Unlisted olmadığını doğrulayın.
Yaygın bir kelimeyi aramak neden hiç sonuç döndürmüyor?
Stopword olarak sınıflandırılan yaygın kelimeler dizine eklenmez ve tek başına bir stopword aramak hiç sonuç döndürmez. Bunun yerine üründen ya da sayfadan ayırt edici bir kelime deneyin.
Anlık arama önerileri neden normal arama sonuç sayfasından farklı?
Anlık arama ve normal arama sonuç türlerini ayrı ayrı ister. Her deneyim için istenen türleri Shopify Search & Discovery’de kontrol edin.
Bir uygulama ya da özel arama, müşterilerin gördüğünü değiştirebilir mi?
Üçüncü taraf bir arama uygulaması sonuçları yerleşik arama yerine kendisi sağlayabilir; Storefront API ile kurulmuş özel bir arama deneyimi de varsayılan sonuç sayfasından bağımsız çalışır. Tema kodunu düzenlemeden önce vitrinin hangi altyapıyı kullandığını belirleyin.

Kaynaklar

  1. Storefront searchShopify, 5 Ekim 2026 tarihinde kontrol edildi
  2. Search behavior in your online storeShopify, 5 Ekim 2026 tarihinde kontrol edildi
  3. Editing theme codeShopify, 5 Ekim 2026 tarihinde kontrol edildi