Ошибки и предупреждения YML: что мешает загрузке фида, а что снижает его качество

Магазин отправил рекламной системе каталог из 1 200 товаров. YML-фидXML-файл, который описывает магазин, справочники и товарные предложения открылся в браузере, но 37 позиций не загрузились: у них отсутствовала категория. Рядом система показала предупреждения о коротких описаниях. Эти сообщения выглядят одинаково тревожно, хотя требуют разной очереди действий.

Ошибка мешает обработать файл или товар; предупреждение обычно оставляет товар в работе, но указывает на риск качества или охвата. Сначала проверяют структуру и обязательные поля, затем улучшают данные.

Учебный кейс

В учебном YML корневой yml_catalog и блок магазина корректны. Из 1 200 offer у 37 указан categoryId=99, но такой категории нет в categories. Ещё у 180 товаров описание короче внутреннего стандарта магазина.

Команда сначала исправила ссылку на категорию и повторно проверила все 1 200 офферов. Только после успешной загрузки занялась описаниями. Если бы она начала с текста, блокирующая связь осталась бы, а труд редактора не появился бы в рекламе.

Три уровня замечаний

Количество замечаний само по себе мало что говорит. Одна ошибка корневого XML может остановить весь каталог. Тысяча рекомендаций по описаниям не мешает загрузить товары, хотя влияет на качество объявлений.

Сначала проверьте структуру документа

У YML один корневой элемент yml_catalog. Внутри shop справочники валют и категорий располагаются перед списком предложений. Каждый товар описывается отдельным offer.

На этом уровне ищут:

• незакрытые теги;
• второй корневой элемент;
• повреждённую кодировку;
• недопустимые символы;
• оборванный файл;
• HTML-страницу вместо XML;
• неправильный порядок основных разделов.

Если ссылка возвращает страницу авторизации, антибот-проверку или сообщение сервера, расширение .xml в адресе не превращает ответ в фид. Сохраните фактическое тело ответа и проверьте его начало.

Обязательность зависит от типа оффера

YML поддерживает разные типы описания товара. Атрибут type влияет на набор элементов, которые проверяет робот. Поэтому универсальный список «обязательных тегов» без учёта типа создаёт ложные ошибки.

Например, упрощённое предложение может передавать название через name. Для произвольного типа используются typePrefix, vendor и model. Проверка должна сначала определить профиль оффера, а затем применять правила.

К общим рискам относятся:

• отсутствующий или повторяющийся идентификатор;
• ссылка без http или https;
• категория, которой нет в справочнике categories;
• валюта, которой нет в currencies;
• цена в неправильном формате;
• отсутствие обязательного названия для выбранного типа;
• несогласованное наличие товара.

Ошибка категории

Поле categoryId должно ссылаться на существующий идентификатор категории. Если оффер содержит categoryId=42, а в справочнике нет <category id="42">, товар теряет связь с каталогом.

В отчёте разработчику нужны три фрагмента:

1. ID оффера.
2. Значение categoryId.
3. Факт отсутствия такого ID в справочнике категорий.

Фраза «ошибка категории» без этих данных заставляет повторять весь поиск вручную.

Изображения и описания

Отсутствие picture или description может иметь разный статус в зависимости от формата и рекламного сценария. Даже когда поле формально допускается пропустить, товар без изображения не подойдёт для части визуальных размещений, а слабое описание уменьшает объём данных для формирования объявления.

Такое замечание полезнее формулировать через последствие: «оффер загрузится, но не готов для товарной галереи» или «описание отсутствует, системе доступно меньше характеристик товара».

Согласованность с сайтом

Фид обновляет рекламу данными магазина. Название, цена, наличие и ссылка должны соответствовать странице товара и оформлению заказа. Валидный XML с устаревшей ценой остаётся проблемой для рекламного размещения.

Статическая проверка файла может подтвердить структуру и значения. Фактическую доступность тысяч карточек, загрузку изображений и окончательную модерацию разумно оставить рекламной системе. Массовый сетевой обход заметно увеличивает время, стоимость и риск блокировок.

Что передать разработчику

Хороший отчёт содержит:

• статус и приоритет;
• ID товара и номер строки, если он доступен;
• конкретный фрагмент XML;
• правило, которое нарушено;
• наблюдаемый факт;
• ожидаемое состояние;
• понятную рекомендацию.

Пример:

Ошибка. Оффер A-104 содержит <categoryId>42</categoryId>, но категории 42 нет в разделе categories. Добавьте категорию в справочник или замените ссылку на существующий ID.

Порядок исправления

1. Добейтесь корректного XML и полного ответа по URL.
2. Исправьте общие справочники.
3. Устраните ошибки обязательных полей офферов.
4. Проверьте идентификаторы, цены, валюты, ссылки и наличие.
5. Разберите предупреждения, влияющие на нужные форматы рекламы.
6. Улучшите названия, описания, изображения и идентификаторы товара.
7. Повторите анализ на новой версии файла.

Анализатор фидов WiseLab принимает XML, YML, CSV и TSV по файлу, ссылке или вставленному коду. После проверки можно скачать Markdown-отчёт для разработчика и полный CSV со всеми замечаниями.

Что забрать в работу

Разбирайте диагностику в порядке зависимости: файл читается → обязательные сущности существуют → ссылки между ними целы → значения соответствуют карточкам → рекомендации по качеству обработаны. Это быстрее возвращает ассортимент в рекламу и даёт разработчику воспроизводимый пример вместо общего сообщения «фид сломан».