Интеграция · Фиды

Хороший поиск доступен любому каталогу, который умеет выгружать файл.

Большинство e-commerce-платформ, ERP и PIM умеют публиковать выгрузку в CSV или JSON. AACSearch забирает её по расписанию, сопоставляет поля с индексом и удаляет товары, которые исчезли из фида.

Что делает коннектор фидов

CSV с сопоставлением колонок

Выберите, какие колонки становятся id, названием, текстом, URL и тегами; остальные колонки сохраняются как поля для фильтров и фасетов.

JSON с корневым путём

Укажите массив внутри ответа (data.items) и сопоставьте поля тем же способом.

Инкрементальные запуски

Если фид поддерживает курсор (since, updated_since), при каждом запуске загружаются только изменённые записи.

Фасеты из колонок

Колонки бренда, категории, размера или цены становятся фильтрами с актуальными счётчиками.

Или отправка вместо загрузки

API документов

Отправляйте до 500 документов за запрос из собственного задания; режимы upsert, create, update или emplace.

Подписанный вебхук

Передавайте изменения в вебхук индекса с подписью HMAC-SHA256 по метке времени и телу запроса.

Характеристики

Форматы
CSV (настраиваемый разделитель), JSON
Документов за запуск
500 по умолчанию, до 5 000
Расписание
вручную, ежечасно, ежедневно или еженедельно
Удаления
записи, отсутствующие при полном запуске, удаляются
Альтернатива с отправкой
API документов, 500 за запрос
Подпись вебхука
HMAC-SHA256 от timestamp.body

Что нужно для старта

  • Публичный https-адрес выгрузки (или доступ по basic auth, до которого мы можем достучаться)
  • Стабильная уникальная колонка id для каждого товара
  • Колонки названия и описания; цена, бренд и категория, если нужны фильтры

Как начать

  1. 1

    Опубликуйте выгрузку

    Большинство платформ умеют выгружать CSV или JSON по расписанию на заданный адрес.

  2. 2

    Создайте коннектор фида

    Вставьте URL, выберите CSV или JSON, сопоставьте колонки id, названия и текста.

  3. 3

    Запустите один раз, затем настройте расписание

    Проверьте первый импорт в консоли, затем переключите коннектор на ежечасный или ежедневный режим.

Вопросы