Що вміє AItransform — з прикладами, без обіцянок

Синоніми без переіндексації

Свій словник під ваш каталог: рядок виду a, b, c робить слова рівнозначними, a => b — заміняє одне на інше. До 500 рядків. Після збереження словник застосовується через Synonyms API Elasticsearch і працює вже в наступному запиті.

# вкладка «Синоніми» в кабінеті
актив, active
вудман, woodman
б/п => бензопила

Після правила «актив, active» запит «актив 110» знаходить ті самі 351 товар, що й «active 110», — без виправлення й банера.

Пропозиції з журналу запитів. Під редактором кабінет показує, що покупці набирали за 30 днів і що рушій для цього виправляв, а також запити без результатів із схожими словами каталогу. Кнопка «Додати» біля кожного варіанта дописує правило запит => варіант — залишається натиснути «Зберегти». Синоніми діють і на пошук по статтях.

Правила видачі

• Закріпити товари для запиту — до 20 артикулів угорі видачі (products[].pinned).
• Категорію вгору, вниз або сховати для запиту — віджет дотримується серверного порядку.
• Переадресація запиту на сторінку сайту: «доставка» → /delivery. Віджет переходить по Enter або коли запит «устоявся» (1,5 с).
• До 200 правил на клієнта; у відповіді API — rules_applied і redirect.

Правила застосовуються після кешу. Закріплення не діють під пагінацією, сортуванням за ціною, фільтром бренду або фільтром out_of_stock; переадресація спрацьовує на запит саме в такому написанні.

Аналітика

Періоди 7 і 30 днів. Плитки та таблиці:

• Пошуки, частка й кількість запитів без результатів, частка виправлених.
• CTR, кліки, додавання в кошик.
• Середній і p90 час відповіді.
• Топ запитів · Запити без результатів · Кліки · Останні запити.

Набір по літерах згортається в один рядок («шо», «шол», «шолом» → «шолом»); кліки приходять із віджета, покупки, «в кошик» і «перегляд» сайт передає через window.AITRANSFORM.track(). За подіями purchase у даних звіту вже рахуються кількість покупок, конверсія (покупки ÷ пошуки) і топ куплених артикулів із сумою замовлень — сума така, як її передав сайт, без перевірки.

Налаштування

• Дозволені домени для ключа — діють із наступного запиту; піддомени охоплюються, =host — точний збіг.
• Мова видачі — uk або ru (визначає title_display).
• Інтервал оновлення фіду — 1, 2, 3, 6, 12 або 24 години; планове завдання перевіряє каталоги раз на 6 годин, тому фактичний мінімум зараз — 6.
• Термін зберігання логу запитів — від 7 до 365 днів (типово 90).

Адміністратор бачить ті самі вкладки для кожного клієнта: схвалення, продовження оплати, вимкнення.

Один тег <script> Віджет

Лоадер сам додає стилі й контейнер, завантажує віджет і знаходить поле пошуку сайту (input[type=text|search] або плейсхолдер «Поиск / Search»). Окремий контейнер не потрібен.

<script defer
  src="https://aitransform.fun/cdn/widget.js"
  data-key="ВАШ_КЛЮЧ"
  data-lang="uk"
  data-datalayer="1"></script>

API для власного фронтенду API

Один запит — уся видача: категорії з товарами, виправлення, ціновий фільтр, фасети. Помилки валідації — 400 до звернення в індекс, недозволений домен — 403.

POST https://api.aitransform.fun/v1/search
{
  "key": "ВАШ_КЛЮЧ",
  "q": "шолом до 1000 грн",
  "sort": "price_asc",
  "facets": true
}

→ 200 (скорочено: показано 1 з 10 категорій, у products і facets — частину полів)
{
  "query_used": "шолом", "corrected": null,
  "match_mode": "exact", "total": 383,
  "price_filter": { "min": null, "max": 1000 },
  "categories": [
    { "name": "Шоломи відкриті (без підборіддя)",
      "parent": "Мотоекіпірування", "count": 112,
      "products": [ … ] },
    …
  ],
  "facets": { "price": { "min": 43.0, "max": 12488.0, "buckets": [ … ] },
              "brands": [ … ], "availability": [ … ] },
  "took_ms": 33, "cached": false, "lang": "uk"
}

Числа — з живого демо-каталогу на 24.09.2026; повний вигляд відповіді — в прикладах документації. Також POST /v1/suggest (підказки), POST /v1/event (клік, кошик, перегляд, покупка) і GET /v1/health.