Ваши данные в AACsearch

Когда вы начинаете работать с AACsearch, вы создаёте несколько сущностей. Давайте разберём, что они означают в человеческих терминах.

Организация

Это ваше рабочее пространство. Когда вы создаёте аккаунт в AACsearch, вы автоматически создаёте организацию. Это как магазин в системе.

В одной организации вы можете:

• Пригласить команду членов
• Создать несколько индексов (для разных каталогов)
• Смотреть общую статистику
• Управлять биллингом

Индекс

Это ваш каталог товаров. Индекс — это единица поиска. Обычно на магазин — один индекс.

Пример:

• Организация: "Мой магазин одежды"
  • Индекс: "Товары" (платья, рубашки, брюки)

Когда вы загружаете товары, они попадают в индекс. Когда покупатель ищет, AACsearch ищет в индексе.

Версионирование индекса (автоматическое)

AACsearch делает умное дело автоматически:

1. Основное имя индекса — это то, что используется при поиске: Товары
2. Версионированное имя — это то, как AACsearch хранит данные: Товары_v1, потом Товары_v2

Зачем версии? Это позволяет переиндексировать товары (например, изменить параметры поиска) без прерывания обслуживания. Поиск работает, пока создаётся новая версия, потом всё переключается.

Вам не нужно ничего делать — это работает автоматически в фоне.

API-ключи

Это ваши пропуски в систему. API-ключ нужен, чтобы:

• Загружать товары в индекс
• Выполнять поиск
• Получать статистику

Есть два типа ключей:

Ключ для поиска (ss_search_*)

• Позволяет покупателям искать товары
• Безопасно использовать на сайте (может быть видимым в HTML)
• Ограничен: может только искать, не может загружать или менять данные

Ключ для загрузки товаров (ss_ingest_*)

• Позволяет загружать и обновлять товары
• Должен быть скрыт на сервере (никогда не на сайте)

Когда вы загружаете товары, система использует ключ для загрузки товаров. Она проверяет, что ключ имеет права, и добавляет товары в индекс.

Когда покупатель ищет, браузер использует ключ для поиска. Этот ключ никому не вредит, потому что может только читать.

Лимиты запросов

Каждый ключ имеет лимит на количество поисков в минуту. Это как скорость в городе — предотвращает злоупотребления и защищает сервер.

Если ключ превысит лимит, запрос будет отклонён на 60 секунд.

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

AACsearch автоматически записывает каждый поиск:

• Что искал покупатель
• Сколько результатов вернулось
• Сколько времени это заняло
• Когда это произошло

Это нужно для аналитики — вы видите, что ищут покупатели.