Как обновляется индекс

Фид даёт полный каталог по расписанию, API индексации — быстрые точечные изменения между загрузками.

Расписание

Частота загрузки фида задаётся в настройках проекта:

Режим	Когда
Каждый час	по умолчанию
Каждые 4 часа
Раз в день
Раз в неделю
Каждые N минут	минимум 30 минут, включается поддержкой

Если фид не изменился с прошлой загрузки (дата в <yml_catalog date> не учитывается), индексация пропускается — поиск не тратит ресурсы впустую.

Что происходит при загрузке

1. Скачивание. Таймаут соединения — 30 секунд; если скорость ниже 1 КБ/с дольше 2 минут, загрузка прерывается. Поддерживаются редиректы и gzip.
2. Разбор. Фид читается потоково, поэтому размер файла не ограничен: каталоги на миллионы товаров — нормальная ситуация.
3. Обогащение. Синонимы, токены артикулов и штрихкодов, векторы картинок для поиска по фото.
4. Инкрементальная запись. В индекс пишутся только товары, которые изменились; товары, пропавшие из фида, удаляются. Раз в неделю ночью и после смены настроек поиска индекс пересобирается целиком.

Обычно изменение в фиде доходит до поиска за несколько минут после очередной загрузки. Цены и остатки быстрее доставляются через API индексации.

Защита каталога

• Фид без товаров не применяется. Если пришёл пустой или битый файл, HTML-заглушка вместо XML или ошибка HTTP, поиск продолжает работать на прошлой версии каталога, а вам приходит уведомление.
• Резкое уменьшение каталога (в 5 раз и больше) применяется, но вы получите предупреждение — проверьте выгрузку.
• Сбой записи. Если не удалось записать 1% товаров и больше, индексация откатывается.

Осторожно

Фид, который законно уменьшился (распродали коллекцию), применится сразу. Если выгрузка иногда отдаёт половину каталога из-за таймаутов на вашей стороне — исправьте её: такой «половинчатый» фид удалит товары из поиска до следующей загрузки.

Частые ошибки загрузки

Ошибка	Что делать
Ресурс недоступен / 403 / 429 / 503	Сайт блокирует наш загрузчик. Добавьте IP из уведомления в белый список антибота или WAF.
Вместо фида пришла HTML-страница	Ссылка ведёт на страницу входа, капчу или 404. Откройте её в режиме инкогнито.
Ошибка XML / неэкранированный &	Экранируйте & как &, HTML в описаниях оборачивайте в CDATA. Временно можно включить «игнорировать ошибки XML».
Невалидный UTF-8	Исправьте кодировку выгрузки или включите очистку не-UTF-8 символов в настройках фида.
Товаров меньше, чем ожидалось	Посмотрите проверку фида: чаще всего у офферов нет категории или названия, либо превышен лимит товаров тарифа.

История загрузок, количество товаров и ошибки — в личном кабинете, раздел Фид.