Проверка YML-фидов: 5 инструментов, ограничения и слепые зоны

При загрузке фидов в аккаунт Директа часто можно столкнуться с ошибками. При этом их описание бывает слишком общим и не дает понимания, что конкретно не так и как это исправить. Например, описание вроде: «Фатальная ошибка парсера».

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

Согласно справке, валидатор Директа проверяет следующие условия:

• присутствие всех обязательных элементов;

• корректность всех названий элементов;

• присутствие каждого элемента не более одного раза.

При невыполнении любого из них файл будет отклонен. Но правило об уникальности элементов применяется не ко всем тегам: <picture> и <param> по спецификации могут повторяться в одном офере.

Но бывает и такое, что YML-фид успешно прошел проверку, а проблемы в нем остались — просто это ошибки другого уровня, которые валидатор Директа либо не проверяет, либо считает допустимыми.

И тут логично возникает вопрос: «Можно ли самостоятельно найти все ошибки в фиде и исправить их, не закопавшись в огромном количестве товаров?». Именно об этом мы и поговорим:

• 4 вида ошибок в YML-фиде

• 5 вариантов проверки фидов

  • XML-валидаторы

  • Валидаторы и плагины в редакторах кода

  • Проверка XML через браузер

  • XML-валидатор Яндекс Вебмастера

  • Использование ИИ при валидации фидов

• Вывод

4 вида ошибок в YML-фиде

Условно все ошибки можно разделить на четыре категории:

1. Синтаксические — это ошибки, при которых файл нарушает правила XML и не может быть корректно прочитан парсером. Проще говоря, это ситуации, когда XML «написан неправильно», независимо от того, какие данные в нем содержатся.

2. Структурные — такие ошибки связаны с тегами и структурой фида, даже если XML валиден. То есть фид «технически читается», но понимается неправильно, потому что нарушает логику YML, которую ожидают сервисы Яндекса.

3. Ошибки значений тегов и атрибутов — самые коварные, потому что фид выглядит корректным, но товары не участвуют в показах или обрабатываются неправильно. Получается, что визуально тег/атрибут есть, но значение у него неправильное.

4. Ошибки контента или качества данных — они связаны с необязательными или условно обязательными данными в YML-фиде, которые не всегда приводят к отклонению товаров, но влияют на качество объявлений, показы и эффективность рекламы.

Разберем на примерах, какие категории ошибок приводят к отклонению фида, а какие не будут обнаружены при проверке внутренним валидатором Яндекса, но окажут влияние на качество рекламы.

Делаем вывод, что самые фатальные ошибки — синтаксические. Если они есть, сервис не сможет прочитать фид целиком. В такой ситуации файл не разбирается парсером, а значит невозможно перейти к проверке структуры YML, значений тегов или атрибутов — эти этапы проверки просто не запускаются.

Хорошая новость: синтаксические ошибки легко находить с помощью XML-валидаторов, редакторов с подсветкой ошибок или даже простого открытия в браузере (для небольших файлов). Ниже — разберем их подробнее.

5 вариантов проверки фидов

Ниже разберем, как проверить YML-фиды на ошибки с помощью:

• XML-валидаторов;

• валидаторов и плагинов в редакторах кода;

• браузера;

• XML-валидатора Яндекс Вебмастера;

• ИИ.

XML-валидаторы

Существует большое количество XML-валидаторов в свободном доступе, например, FreeFormatter, CodeBeautify, LangStop XML Validator. Они удобны для разовой проверки и быстрой диагностики ситуаций, когда фид не открывается или не проходит валидацию из-за фатальных XML-ошибок. Такие онлайн-инструменты:

• указывают на причину синтаксической ошибки — например, отсутствие закрывающего тега <shop> или некорректные спецсимволы;

• уточняют, где возникла ошибка в файле (в отличие от внутреннего валидатора Директа).

Валидаторы и плагины в редакторах кода

Это встроенные или подключаемые расширения, которые позволяют:

• проверять синтаксис XML/YML прямо в редакторе;

• подсвечивать ошибки по строкам и колонкам;

• форматировать XML для лучшей читаемости.

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

• VS Code — плагины XML Tools и Red Hat XML;

• Notepad++ — плагин XML Tools;

• IntelliJ IDEA / WebStorm — встроенные возможности для XML;

• Sublime Text — плагины XML Tools или XML Validator.

Я использую Notepad++ с плагином XML Tools. Вот его основные функции:

1. Check XML syntax now — проверяет валидность XML-файла, позволяя быстро выявить синтаксические ошибки.

2. Pretty Print (XML Only with Line Breaks) — форматирует XML, расставляет отступы. В результате становится гораздо удобнее просматривать и анализировать файл в виде структуры:
   
   <yml_catalog> → <shop> → <offers> → <offer>

3. Validate now — проверяет документ по XSD/DTD, если есть схема для внутреннего XML (к сожалению, для YML официальной схемы нет).

4. XPath query — находит узлы по выражению XPath, например, можно выбрать все <offer> без <price>.

5. XML Tree Viewer — показывает дерево XML, чтобы визуально оценить структуру фида и вложенность тегов.

Редакторы с валидаторами — это основной инструмент разработчика фидов. Они не заменяют проверки Яндексом, но помогают быстро и эффективно находить синтаксические и частично структурные ошибки до загрузки — экономят время и ресурсы.

Проверка XML через браузер

Проверка через браузер — самый быстрый способ выявления фатальных ошибок без дополнительных инструментов. Когда вы открываете YML-фид (XML-файл) в браузере, он не проходит полноценную валидацию, но вы можете увидеть, есть ли синтаксические ошибки и частично структурные проблемы, особенно на маленьких фидах. Подробнее о том, как это работает, и сравнение с полноценными валидаторами — в таблице.

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

XML-валидатор Яндекс Вебмастера

YML-фид — это XML-файл, который соответствует требованиям и стандартам Яндекса. Из этого следует, что формально валидный XML может быть непригоден для продвижения в Поиске и РСЯ. Например, typePrefix является обязательным элементом для фида произвольного типа в Директе, но необязателен для других сервисов, использующих YML-формат (например, Маркета). Поэтому XML-валидаторы не подсвечивают его отсутствие как ошибку, а значит, только этой проверки будет недостаточно.

У самого Яндекса есть инструмент, представляющий что-то среднее между общедоступными XML-валидаторами и внутренним валидатором Директа — это XML-валидатор Яндекс Вебмастера. Он проверяет:

• синтаксис XML;

• корректность кодировки;

• общую целостность документа;

• часть ошибок в структуре YML;

• некорректные значения некоторых тегов;

• неизвестные теги.

По сравнению с внутренним валидатором Директа XML-валидатор Яндекс Вебмастера:

• выдает более понятные сообщения об ошибках с указанием строк, в которых они содержатся;

• не находит специфические ошибки именно Директа (а не YML).

По сравнению с XML-валидаторами XML-валидатор Яндекс Вебмастера:

• учитывает стандарты Яндекса (YML) — находит больше ошибок;

• ограничен по размеру: не более 10 МБ — не подходит для больших фидов.

Использование ИИ при валидации фидов

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

К сожалению, ИИ-помощник Директа пока не умеет валидировать фиды.

Поэтому обратимся за помощью к другим нейросетям, например, ChatGPT. Рассмотрим ситуации, в которых он может быть полезен:

1. Внутренний валидатор Директа выдал ошибки, которые не нашли XML-валидаторы и валидатор Вебмастера. В итоге у нас нет полного списка оферов, а только примеры.

2. Внутренний валидатор Директа не нашел ошибок, но есть недочеты, которые влияют на качество объявлений. Например, у части оферов могут быть пустые теги description или picture. Также отсутствие элемента name для фида комбинированного типа не будет ошибкой, но нам он может быть необходим для ручной генерации заголовков вместе с typePrefix, vendor, model, и пр.

Можно попробовать закрыть задачу полностью с помощью ChatGPT. Но важно дать ИИ максимально четкие однозначные инструкции: что по каким правилам проверять и как должен выглядеть результат. Ниже — пример такого запроса, его можно адаптировать под разные требования для конкретного проекта.

Промпт для проверки YML-фида комбинированного типа

Полученный в таком виде результат поможет подготовить подробное ТЗ для разработчика на исправление всех ошибок.

Вывод

Помните, что ИИ не заменяет проверку в Директе — всегда нужно перепроверять фид после исправлений. Комбинация классических валидаторов, инструментов Яндекса и ручных (или полуавтоматических) проверок остается на сегодняшний день самым надежным подходом.

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

Больше о работе с фидами — в спецпроекте «Настольная книга по работе с фидами»:

• § 1. Что такое фиды и почему их не нужно бояться

• § 2. Фишки, которые стоит использовать при работе с фидами

• § 3. Частые ошибки в фиде и как их исправить

• § 4. Как оптимизировать товарную рекламу в Директе, чтобы повысить эффективность — 19 советов