Панель AI-пошуку
Рядок пошуку для вашого сайту, який розуміє зміст — відвідувачі миттєво знаходять товари та сторінки з вашої бази знань
Огляд
Панель AI-пошуку — це самостійний пошуковий віджет для вашого сайту. Відвідувачі пишуть своїми словами, і відповідні результати з'являються під рядком, щойно вони роблять паузу: товари з вашого потоку даних у реальному часі — у вигляді карток із зображенням і ціною, а сторінки з вашої бази знань — із заголовком, коротким попереднім переглядом і посиланням. Оскільки пошук іде за змістом, а не лише за точними ключовими словами, відвідувач, який вводить опис, усе одно знаходить потрібний товар.
Вона використовує ту саму базу знань, що й ваш чат-бот, тому нічого додатково індексувати чи підтримувати не потрібно. Два віджети незалежні: використовуйте лише рядок пошуку, лише віджет чату або обидва разом на тих самих сторінках.
Додавання на ваш сайт
Рядок пошуку зі ШІ потребує тарифу Standard або вищого. На нижчому тарифі рядок на сайті з являється, але ніколи не повертає результатів, тож якщо нічого не відбувається, спершу перевірте тариф.
Ідентифікатор віджета показано на сторінці «Рядок пошуку зі ШІ» у вашій панелі.
Найпростіше: замініть наявне поле пошуку
Якщо на сайті вже є пошук - пошук теми Shopify, форма WordPress або власна - нічого розміщувати чи правити в темі не треба. Додайте data-replace до тега script: віджет знайде наявну форму пошуку, сховає її та з явиться точно на її місці:
<script src="https://widget.asyntai.com/static/js/search-widget.js" data-asyntai-id="YOUR_WIDGET_ID" data-replace="auto" async></script>
Цей скрипт може бути будь-де на сторінці, тож підійде будь-який плагін, що додає код у шапку чи підвал. Натискання Enter без вибору результату так само відкриває вашу стару сторінку результатів, тож нічого звичного для відвідувачів не ламається. Якщо на незвичній темі автовизначення обере не той елемент, вкажіть CSS-селектор замість auto, наприклад data-replace=".header-search". Коли нічого не збігається, віджет залишає сторінку без змін.
Розмістити вручну
Якщо рядка пошуку ще немає або ви хочете його в певному місці, вставте обидва рядки туди, де він має з явитися - наприклад у шапку поруч із логотипом. Рядок займає всю ширину елемента, у який ви його помістите, а це зазвичай означає редагування шаблону теми.
<div data-asyntai-search></div>
<script src="https://widget.asyntai.com/static/js/search-widget.js" data-asyntai-id="YOUR_WIDGET_ID" async></script>
Якщо щось не працює
- Рядок узагалі не з являється. Перевірте, чи збігається ідентифікатор віджета у скрипті з тим, що на сторінці пошуку в панелі, і чи справді код стоїть на опублікованій сторінці, а не лише в чернетці чи попередньому перегляді.
- Рядок з являється, але результатів немає. Майже завжди річ у тарифі: пошук працює від 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 до 20data-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 — закрити.