Панель AI-поиска

Обзор

Панель AI-поиска — это самостоятельный поисковый виджет для вашего сайта. Посетители пишут своими словами, и подходящие результаты появляются под строкой, как только они делают паузу: товары из вашего потока данных в реальном времени — в виде карточек с изображением и ценой, а страницы из вашей базы знаний — с заголовком, кратким превью и ссылкой. Поскольку поиск идёт по смыслу, а не только по точным ключевым словам, посетитель, который вводит описание, всё равно находит нужный товар.

Она использует ту же базу знаний, что и ваш чат-бот, поэтому ничего дополнительно индексировать или поддерживать не нужно. Два виджета независимы: используйте только строку поиска, только виджет чата или оба вместе на одних и тех же страницах.

Добавление на ваш сайт

Строке поиска с ИИ нужен тариф Standard или выше. На более низком тарифе строка на сайте появляется, но никогда не выдаёт результатов, поэтому если ничего не происходит, сначала проверьте тариф.

Идентификатор виджета показан на странице «Строка поиска с ИИ» в панели управления.

Проще всего: заменить уже имеющееся поле поиска

Если на сайте уже есть поиск - поиск темы Shopify, форма WordPress или собственная - ничего размещать и править в теме не нужно. Добавьте data-replace к тегу script: виджет найдёт существующую форму поиска, скроет её и появится ровно на её месте:

Этот скрипт может стоять где угодно на странице, поэтому подойдёт любой плагин, добавляющий код в шапку или подвал. Enter без выбора результата по-прежнему открывает вашу старую страницу результатов, так что ничего привычного посетителям не ломается. Если на необычной теме автоопределение выберет не тот элемент, укажите CSS-селектор вместо auto, например data-replace=".header-search". Когда ничего не подходит, виджет оставляет страницу без изменений.

Разместить вручную

Если строки поиска ещё нет или вы хотите её в определённом месте, вставьте обе строки туда, где она должна быть - например в шапку рядом с логотипом. Строка занимает всю ширину элемента, в который вы её поместите, а это обычно означает правку шаблона темы.

Если что-то не работает

• Строка вообще не появляется. Проверьте, совпадает ли идентификатор виджета в скрипте с тем, что указан на странице поиска в панели, и действительно ли код стоит на опубликованной странице, а не только в черновике или предпросмотре.
• Строка появляется, но результатов нет. Почти всегда дело в тарифе: поиск работает начиная со Standard. То же самое вы увидите, когда закончится месячный лимит ответов ИИ.
• Приходят страницы, но нет товаров. Товары берутся из Real-Time Data Feed. Подключите его на странице поиска и проверьте, отмечен ли флажок этого источника.
• Ничего не находится ни по одному запросу. Возможно, база знаний ещё пуста. Сначала обойдите сайт или добавьте контент в панели, затем повторите.
• data-replace не нашёл ваше поле поиска. Некоторые темы прячут поиск за кнопкой или всплывающим окном. Вместо auto укажите CSS-селектор нужного элемента и посмотрите страницу в обычном окне браузера, а не в редакторе темы.

Источники поиска

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

Для результатов с товарами нужен подключённый поток данных. Подходят оба варианта: Поток данных в реальном времени на тарифе Standard и выше и Поток данных в реальном времени Max на тарифе Pro. Без потока поиск всё равно работает, просто возвращает только страницы вашего сайта, а страница в панели управления отмечает поток как неподключённый, чтобы вы понимали, почему товары не появляются.

Аналитика поиска

Страница «Панель AI-поиска» в вашей панели управления показывает поиск за последние 30 дней: сколько запросов было, сколько из них ничего не нашли и как часто посетитель открывал результат. Две таблицы показывают самые частые запросы и запросы без результатов. Полезнее вторая таблица: она точно говорит, что посетители ожидают найти и не находят.

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

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

Как выглядят результаты

Две настройки на странице AI Search Bar в панели меняют вид строки и её результатов. Обе сохраняются сразу после выбора, и ни одна не требует правки кода.

Детализация результата товара

Под названием каждого товара строка может показать одну строку описания из вашего фида данных. Полезно ли это, целиком зависит от содержимого фида. Туристический фид, где указаны длительность поездки и оставшиеся места, показывать стоит. А фид со списком характеристик читается как выгрузка из базы данных.

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

Размер строки

Строка бывает трёх высот: компактная 38 пикселей для узкой шапки, стандартная 44 пикселя и большая 52 пикселя для страницы, построенной вокруг поиска. Размер текста меняется вместе с ней.

Ширину мы никогда не задаём. Строка всегда заполняет элемент, в который вы её помещаете, поэтому шириной управляет ваша вёрстка. Панель результатов подстраивается под строку автоматически.

После изменения размера скопируйте код вставки заново. Новый код содержит размер, поэтому строка правильная уже при загрузке страницы. Если не копировать заново, строка всё равно изменит размер, но только после первого поиска.

Когда поиск ничего не находит

Если ваш виджет чата стоит на той же странице, панель поиска предлагает передать вопрос вашему ассистенту каждый раз, когда поиск не даёт результатов. Посетитель сохраняет свой вопрос и попадает в чат с уже введённым текстом, поэтому тупик превращается в разговор. Этот вариант появляется, только если виджет чата есть на странице.

Параметры

Панель автоматически использует язык браузера посетителя для текста-подсказки, заголовков результатов и текста загрузки. Задавайте эти значения, только если хотите использовать свои формулировки.

Оба заголовка можно переименовать и на странице поиска в панели управления, без правки кода. Так проще, если в фиде статьи или объявления, а не товары. Атрибут на теге script по-прежнему важнее настройки в панели.

Все атрибуты необязательны и добавляются в тег script:

• data-placeholder="Search products..." - текст, отображаемый в пустой строке поиска
• data-accent="#0a7d4f" - цвет фокуса и подсветки — под ваш бренд
• data-max-results="8" - сколько результатов показывать, от 1 до 20
• data-new-tab="true" - открывать результаты в новой вкладке браузера
• data-size="sm" - высота строки: sm, md или lg. Имеет приоритет над размером, заданным в панели
• data-label-products="Products" - заголовок над результатами из потока, на вашем языке — например, Статьи, если ваш поток содержит статьи
• data-label-pages="Pages" - заголовок над результатами со страницами, на вашем языке
• data-label-empty="No results found" - сообщение, когда ничего не найдено
• data-label-searching="Searching..." - текст, отображаемый во время загрузки результатов
• data-label-ask-ai="Ask our assistant" - формулировка опции, которая передаёт безрезультатный запрос вашему чат-боту
• data-target=".my-container" - отрисовать строку внутри этого элемента вместо контейнера по умолчанию
• data-replace="auto" - заменить строку поиска, которая уже есть в вашей теме, как описано выше

Использование и оплата

Каждый поиск посетителя расходует 1 ответ ИИ из месячного лимита вашего тарифа — того же лимита, что и ответы чат-бота. Поиск срабатывает, когда посетитель делает паузу в наборе, а не на каждую букву. Поиски, которые вы выполняете на странице «Панель AI-поиска» в панели управления, не учитываются. Когда месячный лимит исчерпан, строка поиска просто не показывает результаты до сброса лимита.

Полезно знать

• Посетители могут искать на любом языке, даже если ваш контент написан на другом.
• Опечатки и недописанные слова всё равно приводят к нужному результату: запрос «кутрка» находит ваши куртки.
• Цены товаров показываются с символом вашей валюты, взятым из валюты в вашем потоке данных.
• Одна и та же страница на нескольких языках появляется один раз — выигрывает версия на языке поиска.
• Результаты открывают настоящие страницы вашего сайта, поэтому строка поиска работает и как навигация.
• Виджет — это один небольшой скрипт без зависимостей, он не замедляет вашу страницу.
• Управление с клавиатуры работает сразу: стрелки — для перемещения, Enter — открыть, Escape — закрыть.