Поиск по товарам на сайте

Поиск по товарам — строка поиска сайта с подсказками при вводе и страница результатов, которую OneTrace.ru наполняет товарами вашего каталога. Поиск понимает опечатки, словоформы и запрос, набранный не в той раскладке, а первые результаты ставит по интересам посетителя: что он смотрел и покупал.

Для работы нужны установленный трекер (Подключение сайта) и товарный каталог (Рекомендации и каталог товаров). Поиск входит не во все тарифы: если его нет в вашем, блок с кодом на вкладке установки не показывается, а запросы поиска получают ошибку «функция недоступна».

Как ищутся товары

• Слова запроса ищутся в названии, бренде, категориях и характеристиках товара; артикул — точным совпадением.
• Учитываются словоформы на языках проекта: «куртки» найдут «Куртка зимняя». Языки задаются в настройках проекта, см. Настройки проекта.
• Опечатки исправляются: «крутка» найдёт «куртку», «dres» — «dress».
• Запрос в неверной раскладке тоже работает: «ghbdtn» ищется как «привет».
• Если по всем словам ничего не нашлось, поиск показывает товары хотя бы с одним из них.
• Выше стоят популярные товары и товары в наличии. Популярность берётся из рекомендаций и обновляется раз в сутки.
• Первые результаты переупорядочиваются по интересам посетителя: товары категорий и брендов, которые он смотрел и покупал, поднимаются выше.
• Размеры и параметры в запросе — «205/55 r16», «5x112», «зимние» — становятся фильтрами, если они есть у отрасли магазина.

Новые и изменённые товары каталога попадают в поиск в течение минуты после загрузки фида или запроса API.

Строка поиска

Добавьте полю поиска вашего сайта атрибут data-cdp-search:

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

При вводе под полем появляется подсказка: популярные запросы сайта, подходящие категории и товары с картинкой и ценой. Её можно листать стрелками, Enter открывает выбранную строку, Esc закрывает подсказку. Enter без выбранной строки отправляет форму сайта как обычно.

Подсказка берёт шрифт сайта и не содержит текстов интерфейса, поэтому подходит сайту на любом языке.

Страница результатов

Готовые плагины интернет-магазинов подставляют результаты в страницу поиска магазина сами. На своём сайте получите товары в трекере:

window.addEventListener('load', async () => {
  const q = new URLSearchParams(location.search).get('q');
  const result = await cdp.search(q, { perPage: 24 });
  // result.items — товары, result.total — сколько найдено, result.facets — категории, бренды, цены и характеристики для фильтров
});

Параметры: category, brand, priceMin, priceMax, sort (relevance, popular, price_asc, price_desc), page, perPage, attributes. При клике по товару вызовите cdp.searchResultClicked(товар).

Фильтры характеристик. В result.facets.attributes — характеристики отрасли магазина с подписями на языке посетителя и числом товаров у каждого значения, например «Диаметр, дюймы»: 16, 17, 18. Выбранные значения передайте в attributes: cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } }) — несколько значений одной характеристики объединяются через «или», разные характеристики — через «и». В result.filters — размеры и параметры, распознанные в тексте запроса: покажите их посетителю, чтобы было видно, почему результаты отфильтрованы. Нужен трекер 1.15.0.

Если для запроса настроена переадресация (см. Правила для запросов), в result.redirect — адрес страницы: откройте её вместо результатов.

Серверам доступны те же запросы с ключом записи: https://cdp.onetrace.ru/api/v1/search и https://cdp.onetrace.ru/api/v1/search/suggest. Полный перечень параметров — в справочнике API: https://cdp.onetrace.ru/api/v1/openapi.json.

Отчёт по запросам

Вкладка Поиск раздела «Сайт» показывает, что посетители ищут на сайте, за 7, 30 или 90 дней:

• Поиски и посетители — сколько раз искали и сколько разных людей.
• Без результатов — доля поисков, которые ничего не нашли.
• CTR — доля посетителей, которые кликнули по товару в результатах своего запроса.
• Покупки и выручка — товар, по которому кликнули в результатах, тот же покупатель купил в течение 7 дней. Выручка считается по цене товара в каталоге. Показываются, если в настройках рекомендаций задано событие покупки, см. Рекомендации и каталог товаров.

Таблицы под графиком:

Запросы сравниваются без учёта регистра и лишних пробелов. Из строки таблицы можно сразу добавить синоним или правило для запроса.

Синонимы

Синонимы — слова и фразы, которые ищутся вместе: запрос с любым словом группы находит товары и по остальным. Например, группа «кроссовки, кеды, sneakers»: по запросу «белые кеды» найдутся и белые кроссовки.

• Двусторонняя группа — каждое слово ищется как остальные.
• Односторонняя группа — только первое слово ищется как остальные: «айфон → iphone» находит iPhone по запросу «айфон», но «iphone» не ищется как «айфон».

Слово или фраза группы заменяется в запросе, только если встречается целиком. Синонимы действуют сразу после сохранения, в результатах и подсказках. В проекте — до 500 групп, в группе — до 20 слов.

Правила для запросов

Правило срабатывает, когда посетитель ищет ровно этот запрос (без учёта регистра, лишних пробелов и знаков по краям), и делает одно или оба действия:

• Закреплённые товары — до 24 товаров в заданном порядке стоят в начале результатов, даже если сам поиск их не находит. Остальные результаты идут за ними без повторов. Закрепление действует при сортировке по релевантности и без фильтров; товары не в наличии не показываются.
• Переадресация — вместо результатов открывается страница сайта, например «доставка» → страница условий доставки.

Переадресацию выполняют строка поиска трекера (Enter по запросу с правилом), cdp.search() на своей странице результатов (поле redirect) и плагины WooCommerce и Magento 2. В проекте — до 1000 правил.

Статистика

Трекер записывает два события:

Из событий search за 30 дней складываются популярные запросы в подсказке. События видны в карточке покупателя и доступны в сегментах, например «искал, но не купил», см. Сегменты.