Web sitesinde ürün arama

Ürün arama, web sitenizde yazarken öneriler gösteren bir arama kutusu ve OneTrace.ru tarafından kataloğunuzdaki ürünlerle doldurulan bir sonuç sayfasıdır. Arama yazım hatalarını, kelime biçimlerini ve yanlış klavye düzeninde yazılmış sorguları anlar; ilk sonuçları ise ziyaretçinin ilgi alanlarına, yani neleri görüntüleyip satın aldığına göre sıralar.

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

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

Arama kutusu

Web sitenizdeki arama alanına data-cdp-search özniteliğini ekleyin:

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

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

Sorgu raporu

«Site» bölümünün Arama sekmesi, 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.

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.

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