Web sitesinde ürün arama

Ürün arama, web sitenizde yazarken öneriler gösteren bir arama kutusu ve OneTrace.pro tarafından kataloğunuzdaki ürünlerle doldurulan bir sonuç sayfasıdır. Arama yazım hatalarını, kelime biçimlerini, yanlış klavye düzeninde yazılmış sorguları, sorgu metnindeki fiyatı ve markayı ve tanımlayıcı sorguların anlamını anlar; ilk sonuçları ise ziyaretçinin ilgi alanlarına ve diğer müşterilerin neleri seçtiğine göre sıralar. Hazır arama widget’ı önerileri ve sonuç sayfasını kendisi çizer — web sitesinde kod gerekmez.

Çalışması için kurulu bir izleyici (Web sitesini bağlama) ve bir ürün kataloğu (Öneriler ve ürün kataloğu) gerekir. Arama her tarifeye dahil değildir: tarifenizde yoksa menüde Ürün arama öğesi olmaz, kurulum sekmesinde kod bloğu gösterilmez ve arama istekleri “özellik kullanılamıyor” hatası alır.

Ürünler nasıl aranır

• Sorgu kelimeleri ürünün adında, markasında, kategorilerinde ve özelliklerinde aranır; stok kodu ise tam eşleşmeyle aranır.
• Projenin dillerindeki kelime biçimleri dikkate alınır: “куртки” sorgusu “Куртка зимняя” ürününü bulur. Diller proje ayarlarında belirlenir, bkz. Proje ayarları, tarife ve denetim.
• Yazım hataları düzeltilir: “крутка” sorgusu “куртку” sonucunu, “dres” ise “dress” sonucunu bulur.
• Yanlış klavye düzeninde yazılan sorgu da çalışır: “ghbdtn”, “привет” olarak aranır.
• Tüm kelimelerle hiçbir şey bulunamazsa arama, bunlardan en az birini içeren ürünleri gösterir.
• Popüler ve stokta olan ürünler daha üstte yer alır. Popülerlik önerilerden alınır ve günde bir kez güncellenir.
• İlk sonuçlar ziyaretçinin ilgi alanlarına göre yeniden sıralanır: ziyaretçinin görüntülediği ve satın aldığı kategorilerin ve markaların ürünleri yukarı çıkar.
• Sorgudaki ölçüler ve parametreler (“205/55 r16”, “5x112”, “kış”), mağaza sektöründe tanımlıysa filtreye dönüşür.
• Metindeki fiyat, marka ve özellik değerleri filtreye dönüşür, bkz. Sorguyu anlama.
• Tanımlayıcı bir sorgu ürünleri anlamına göre de bulur, bkz. Anlama göre arama.
• Bu sorguda daha sık seçilen ve satın alınan ürünler daha üstte yer alır, bkz. Davranıştan öğrenme.

Katalogdaki yeni ve değiştirilmiş ürünler, feed yüklendikten veya bir API isteğinden sonra bir dakika içinde aramaya eklenir.

Yazım hatası düzeltme

Sorgu hiçbir şey bulmazsa veya ürünler yalnızca kelimelerin bir kısmıyla bulunursa arama, kelimeleri kataloğunuzun sözlüğüne göre — katalogdaki tüm dillerde ürün adları, markalar, kategoriler ve web sitesindeki popüler aramalar — düzeltir ve yeniden arar. Düzeltilmiş sorgunun sonuçları “«…» için sonuçlar gösteriliyor.” notuyla ve tam olarak yazılanı bulmak için “Bunun yerine «…» ara” bağlantısıyla gösterilir. Ürünler kelimelerin yalnızca bir kısmıyla bulunduysa düzeltme “Bunu mu demek istediniz: «…»?” önerisiyle sunulur. Tüm kelimelerle veya anlamına göre bulunan sonuçlarda bu öneri gösterilmez: katalogda olmayan bir kelime her zaman yazım hatası değildir.

Sözlük, katalog değiştikten sonra kendiliğinden güncellenir. Yazılan sorguyla hiç ürün yoksa yazarken açılan önerilerde de düzeltilmiş sorgu bir satır olarak gösterilir.

Sorguyu anlama

Arama, ziyaretçinin genellikle filtrelerle seçtiği şeyleri sorgu metninde tanır ve hemen uygular:

Ölçü birimli bir sayı (“3 yaşa kadar”, “5 kg’a kadar”) fiyat sayılmaz. Tanınanlar sonuçlarda seçili filtreler olarak gösterilir: ziyaretçi sonuçların neden filtrelendiğini görür ve filtreyi kaldırabilir — bu durumda metindeki o işaret artık tanınmaz. Tanınan filtrelerle hiçbir şey bulunamazsa arama düz metinle tekrarlanır.

Anlama göre arama

Tanımlayıcı bir sorgu (“dağda koşu için ayakkabı”, “anneme ne hediye alsam”, “yağmura karşı”) ürün adlarındaki hiçbir kelimeyi içermeyebilir. Bu tür sorgular için arama ayrıca anlamca yakın ürünleri de arar: OneTrace.pro her ürün için katalogdaki tüm dillerde ürün ve kategori adlarından, markadan ve özelliklerden oluşan bir anlam tanımı saklar.

• Anlam, üç ve daha fazla kelimeden oluşan sorgulara ve kelimeleriyle hiçbir şey bulunamayan ya da yalnızca kısmen bulunan sorgulara eklenir. Kelimeleriyle bulunan kısa sorgular eskisi gibi aranır.
• Hem kelimelerle hem anlamla bulunan ürünler daha üstte yer alır.
• Katalogda ad çevirileri varsa başka bir dildeki sorgu ürünleri anlamına göre bulur.
• Mağazanın ürünleriyle ilgisi olmayan bir sorgu (bir giyim mağazasında “araç sigortası”) genellikle anlama göre hiçbir şey bulmaz.
• Anlam, alaka düzeyine göre sıralamada çalışır.

Anlam tanımları yalnızca değişen ürünler için, genellikle katalog yüklendikten sonra bir dakika içinde yeniden hesaplanır.

Davranıştan öğrenme

Arama günde bir kez web sitesinin son 90 günlük olaylarından öğrenir: en az 5 farklı ziyaretçinin aradığı her sorgu için sonuçlarda en az iki kişinin tıkladığı ürünleri bulur; tıklamadan sonra ürünün satın alınması üç tıklama değerindedir. Bu ürünler o sorgunun sonuçlarında başa çıkar — yalnızca bulunanlar arasında ve yalnızca alaka düzeyine göre sıralamada.

Web sitesi → Ürün arama sayfasının raporundaki Öğrenilen aramalar göstergesi, kaç sorguda sıralamanın davranışı zaten dikkate aldığını söyler; tabloda bu sorgular “öğrenildi” etiketiyle işaretlenir.

Arama widget’ı

Arama widget’ı, izleyicinin çizdiği hazır öneriler ve sonuç sayfasıdır. Web sitesi → Ürün arama sayfasındaki Arama widget’ı bloğunda açılır: Arama katmanını sitede göster seçeneğini işaretleyin ve kaydedin.

Arama katmanı. Arama alanına tıklandığında altında bir katman açılır: ziyaretçinin son aramaları, şu an popüler olanlar ve ziyaretçiye özel ürünler. Yazarken — arama önerileri, kategoriler, markalar, bilgi tabanındaki site sayfaları ve görseli ile fiyatıyla birlikte ürünler. Telefonda katman tam ekran açılır. Katman, data-cdp-search özniteliğine sahip alanlara ve Sitenin diğer arama alanları (CSS seçici) ayarındaki alanlara bağlanır — örneğin temanızın arama alanına, kodunu değiştirmeden.

Önizleme bloğu, kataloğunuzdaki ürünlerle gerçek katmanı ve sonuçları gösterir.

Sonuç sayfası. Web sitesinin arama sayfasına bir kapsayıcı yerleştirin — izleyici sonuçları filtreler, sıralama ve kaydırdıkça yükleme ile çizer:

<div data-cdp-search-results data-query-param="q"></div>

Sorgu ve filtreler sayfa adresinde saklanır: sonuçların bağlantısı paylaşılabilir, “Geri” önceki seçime döndürür. data-query-param — adresteki sorgu parametresi (varsayılan olarak q), data-per-page — sayfa başına ürün sayısı (en fazla 48), data-cart-url — ayarlardakinden farklıysa sepet adresi. Web sitesinde ne sonuç sayfası ne de arama formu varsa sonuçlar sayfanın üzerinde bir pencerede açılır.

“Sepete ekle” düğmesi. Düğme, web sitenizin sepet adresine quantity miktarıyla POST gönderir ve JSON yanıtı bekler: {"ok": true} — ürün eklendi, düğme “Eklendi” gösterir; {"ok": false, "redirect": "…"} — ürün için bir varyant seçilmesi gerekir, belirtilen sayfa açılır. Ekleme sonrasında izleyici web sitesine cdp:add-to-cart olayıyla bildirir — tema bu olayla mini sepeti günceller. Sepet adresi web sitesinin alan adında olmalıdır: başka bir sitenin sepeti müşteriyi görmez.

Mağaza eklentileri. WooCommerce ve Magento 2 eklentilerinde ve 1C-Bitrix modülünde arama widget’ı ayarını açın — mağazanın arama sayfası widget’ın sonuçlarını gösterir, “Sepete ekle” düğmesi de ürünleri mağazanın sepetine ekler. Widget burada kapalı olduğu sürece mağaza kendi arama sayfasını gösterir.

Arama kutusu

Widget olmadan da öneriler, web sitenizdeki arama alanına data-cdp-search özniteliğiyle bağlanabilir:

<form action="/search">
  <input name="q" data-cdp-search data-category-url="/catalog/{id}">
</form>

Yazarken alanın altında öneriler açılır: web sitesindeki popüler aramalar, uygun kategoriler ve görseli ile fiyatıyla birlikte ürünler. Öneriler arasında ok tuşlarıyla gezinebilirsiniz; Enter seçili satırı açar, Esc önerileri kapatır. Seçili satır yokken Enter, web sitesinin formunu her zamanki gibi gönderir.

Öneriler web sitesinin yazı tipini kullanır ve arayüz metni içermez; bu nedenle her dildeki web sitesine uyar.

Sonuç sayfası

E-ticaret siteleri için hazır eklentiler sonuçları mağazanın arama sayfasına kendileri yerleştirir. Kendi web sitenizde ürünleri izleyiciden alın:

window.addEventListener('load', async () => {
  const q = new URLSearchParams(location.search).get('q');
  const result = await cdp.search(q, { perPage: 24 });
  // result.items — ürünler, result.total — kaç ürün bulunduğu, result.facets — filtreler için kategoriler, markalar, fiyatlar ve özellikler
});

Parametreler: category, brand, priceMin, priceMax, sort (relevance, popular, price_asc, price_desc), page, perPage, attributes. Bir ürüne tıklandığında cdp.searchResultClicked(ürün) çağrısını yapın.

Özellik filtreleri. result.facets.attributes, mağaza sektörünün özelliklerini ziyaretçinin dilindeki etiketlerle ve her değerdeki ürün sayısıyla içerir, örneğin “Jant çapı, inç”: 16, 17, 18. Seçilen değerleri attributes içinde gönderin: cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } }). Aynı özelliğin birden fazla değeri “veya” ile, farklı özellikler “ve” ile birleştirilir. result.filters, sorgu metninde tanınan ölçüleri ve parametreleri içerir: sonuçların neden filtrelendiği anlaşılsın diye bunları ziyaretçiye gösterin. İzleyici 1.15.0 gerekir.

Sorgu için bir yönlendirme kuralı varsa (bkz. Sorgu kuralları), result.redirect sayfa adresini içerir: sonuçlar yerine bu sayfayı açın.

Yanıtta ayrıca: result.corrected — sonuçlar düzeltilmiş sorguyla gösterildi, result.suggestion — “Bunu mu demek istediniz”, result.filters — metinde tanınan fiyat (price_min, price_max) ve marka da, result.learned — sıralama ziyaretçi davranışını dikkate alıyor, result.semantic — anlama göre bulunan ürünler var. Seçenekler: correct: false — tam olarak yazılanı ara, ignore: ['price'] — metinde fiyatı, markayı (brand) veya bir özelliği tanıma.

Sunucular aynı istekleri yazma anahtarıyla yapabilir: https://cdp.onetrace.pro/api/v1/search ve https://cdp.onetrace.pro/api/v1/search/suggest. Parametrelerin tam listesi API başvurusundadır: https://cdp.onetrace.pro/api/v1/openapi.json.

Sorgu raporu

Web sitesi → Ürün arama sayfası, ziyaretçilerin web sitenizde son 7, 30 veya 90 günde ne aradığını gösterir:

• Aramalar ve ziyaretçiler — kaç kez arandığı ve kaç farklı kişinin aradığı.
• Sonuçsuz — hiçbir şey bulamayan aramaların payı.
• CTR — kendi sorgusunun sonuçlarında bir ürüne tıklayan ziyaretçilerin payı.
• Satın almalar ve gelir — sonuçlarda tıklanan ve aynı müşteri tarafından 7 gün içinde satın alınan ürün. Gelir, katalogdaki ürün fiyatıyla hesaplanır. Öneri ayarlarında bir satın alma olayı tanımlıysa gösterilir, bkz. Öneriler ve ürün kataloğu.
• Öğrenilen aramalar — kaç sorguda sonuç sıralamasının tıklamaları ve satın almaları dikkate aldığı, bkz. Davranıştan öğrenme.

Grafiğin altındaki tablolar:

Sorgular büyük/küçük harf ve fazla boşluklar dikkate alınmadan karşılaştırılır. Tablo satırından sorgu için hemen bir eş anlamlı veya kural ekleyebilirsiniz.

Eş anlamlılar

Eş anlamlılar birlikte aranan kelimeler ve ifadelerdir: gruptaki herhangi bir kelimeyle yapılan sorgu diğerleriyle de ürün bulur. Örneğin «spor ayakkabı, sneaker, koşu ayakkabısı» grubuyla «beyaz sneaker» sorgusu beyaz spor ayakkabıları da bulur.

• Çift yönlü grup — her kelime diğerleri gibi aranır.
• Tek yönlü grup — yalnızca ilk kelime diğerleri gibi aranır: «cep telefonu → akıllı telefon», «cep telefonu» aramasında akıllı telefonları bulur, ancak «akıllı telefon» «cep telefonu» olarak aranmaz.

Grubun bir kelimesi veya ifadesi sorguda yalnızca tam olarak geçtiğinde değiştirilir. Eş anlamlılar kaydedildikten hemen sonra sonuçlarda ve önerilerde geçerli olur. Bir projede en fazla 500 grup, bir grupta en fazla 20 kelime olabilir.

Sorgu kuralları

Kural, ziyaretçi tam olarak bu sorguyu aradığında (büyük/küçük harf, fazla boşluk ve kenarlardaki noktalama dikkate alınmadan) uygulanır ve bir veya iki işlem yapar:

• Sabitlenmiş ürünler — belirlediğiniz sırayla en fazla 24 ürün, arama onları bulmasa bile sonuçların başında yer alır. Diğer sonuçlar tekrar olmadan ardından gelir. Sabitleme alaka düzeyine göre sıralamada ve filtre olmadan geçerlidir; stokta olmayan ürünler gösterilmez.
• Yönlendirme — sonuçlar yerine web sitenizin bir sayfası açılır, örneğin «teslimat» → teslimat koşulları sayfası.

Yönlendirmeleri izleyicinin arama kutusu (kuralı olan bir sorguda Enter), kendi sonuç sayfanızdaki cdp.search() (redirect alanı) ve WooCommerce ile Magento 2 eklentileri uygular. Bir projede en fazla 1000 kural olabilir.

Sorgu sınırı

Arama istekleri — hem sonuç sayfaları hem de yazarken açılan öneriler — tarifenin aylık sınırına sayılır. Sınır, tarifedeki profil hacmiyle birlikte artar: “Büyüme” — ayda hacimdeki profil başına 20 istek, “Kurumsal” — 40; deneme süresinde — 50.000 istek. Kullanım “Tarife ve ödeme” sayfasında görünür, bkz. Tarife ve ödeme.

Proje sahibine sınırın %90’ına ve %100’üne ulaşıldığında e-posta gelir. Sınırın %10 fazlasına kadar arama çalışmaya devam eder, ardından bir sonraki ayın başına kadar kullanılamaz: widget web sitesinin arama alanını devralmayı bırakır ve sonuçlarda aramanın kullanılamadığını yazar, mağaza eklentileri ise hemen mağazanın yerleşik aramasını gösterir. Kendi sonuç sayfanız cdp.search() içinde unavailable işaretini alır — web sitenizin kendi aramasını gösterin.

İstatistikler

İzleyici iki olay kaydeder:

Önerilerdeki popüler aramalar, son 30 günün search olaylarından oluşturulur. Olaylar müşterinin profil kartında görünür ve segmentlerde kullanılabilir, örneğin “aradı ama satın almadı”, bkz. Segmentler.