Импорт товаров в Relavio Search

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

Основной поддерживаемый формат для регулярного обмена - YML-фид. Он подходит интернет-магазинам, которые уже выгружают каталог для маркетплейсов, рекламных систем или товарных агрегаторов.

Что происходит при импорте

Процесс импорта состоит из нескольких этапов:

1. Relavio открывает URL фида магазина.
2. Система считает количество товаров по элементам <offer>.
3. Из блока <categories> строится дерево категорий.
4. Из товаров читаются названия, цены, изображения, ссылки, бренды и характеристики.
5. Характеристики из <param> превращаются в атрибуты для поиска и фильтров.
6. Товары отправляются в поисковый индекс пачками.
7. После успешной индексации новый индекс переключается в работу.

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

Какие данные попадают в поиск

Relavio Search использует данные из фида для разных частей виджета:

Данные	Где используются
Название товара	Поиск, подсказки, карточки товаров
Бренд	Поиск, описание карточки, фильтры
Категории	Поиск, подсказки, фильтр категорий
Цена и старая цена	Карточки товаров, диапазонные фильтры
Изображения	Карточки товаров
Ссылка на товар	Переход из виджета и аналитика кликов
Характеристики <param>	Фильтры и поисковый текст
Синонимы и ключевые слова	Расширение поисковых запросов

Запуск импорта

Для магазина указывается URL фида. После этого импорт можно запускать вручную или по расписанию.

Поддерживаемые расписания:

• ежедневно;
• каждый час;
• каждые 15 минут.

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

Статусы импорта

Импорт может находиться в нескольких состояниях:

Статус	Значение
running	Импорт запущен и выполняется.
completed	Товары успешно проиндексированы.
failed	Импорт завершился ошибкой.

Во время выполнения прогресс обновляется по количеству уже проиндексированных товаров.

Рекомендации к фиду

Чтобы поиск работал качественно, передавайте в фиде как можно более полные данные:

• стабильный id у каждого <offer>;
• понятное название в <name>;
• актуальную цену в <price>;
• ссылку на товар в <url>;
• хотя бы одно изображение в <picture>;
• бренд в <vendor>;
• категорию через <categoryId>;
• характеристики товара через <param>;
• синонимы или ключевые слова для сложных запросов.

Если часть данных отсутствует, товар все равно может попасть в индекс, но качество поиска, карточек и фильтров будет ниже.

Следующие разделы

• YML-фид - формат файла, поддерживаемые поля и пример.
• CSV - импорт из табличных файлов.
• API - передача товаров через API.