Что такое YML-фид
YML-фид (Yandex Market Language) — это XML-файл с каталогом интернет-магазина: товары, цены, наличие, категории, картинки и ссылки на страницы. По нему сервисы Яндекса узнают о товарах: Маркет, товарные объявления в Директе и Товары в поиске.
Фид выгружает CMS или модуль магазина, обычно по расписанию. Одна ошибка в выгрузке — пропавшие цены, относительные ссылки, товары без категории — и сервис отклонит товары, а они перестанут показываться. Проверка YML-фида находит такие ошибки за один запуск и показывает конкретные товары.
Что проверяет инструмент
- Файл. Фид скачивается целиком, до 20 МБ, с переходом по пяти редиректам; сжатый gzip распаковывается до 30 МБ. ZIP-архив, HTML-страница и XML другого формата — например, фид Google Merchant — не принимаются.
- Структура. Корень
yml_catalogс атрибутомdate, магазинshopс элементамиname,companyиurl, списки валют и категорий;parentIdкатегории должен вести на существующую категорию. - Каждый товар. Уникальный id; полный адрес страницы с
httpилиhttps; цена — число больше нуля с дробной частью через точку;currencyIdиcategoryIdиз списков фида; название —nameили параvendorиmodel. - Замечания. Товар без картинки; старая цена
oldpriceне выше текущей; описание длиннее 3000 символов; атрибутavailableнеtrueи неfalse.
Сводка показывает число товаров, сколько из них в наличии, сколько категорий и долю товаров с картинками. Товары без атрибута available считаются в наличии — так их считает и Директ.
Как проверить YML-фид
- Вставьте адрес фида — можно без
https://, напримерsite.ru/feed.xml. - Нажмите «Проверить». На скачивание фида отводится до 25 секунд.
- Посмотрите раздел «Структура фида»: ошибки в нём исправляют первыми.
- Раскройте каждый вид ошибок в разделе «Товары» — там id товаров и что с ними не так.
- Исправьте выгрузку и проверьте фид ещё раз; ссылку на результат можно отправить разработчику.
Как читать результат
Вверху — итог: «Ошибок нет», «Есть замечания», «Ошибки в структуре» или «С ошибками N из M товаров». У каждой строки — цветная полоса слева:
- Зелёная, галочка — элемент на месте.
- Оранжевая, треугольник — замечание: стоит поправить, часть сервисов такое не примет или покажет хуже.
- Красная, крестик — ошибка: товар или весь фид сервис не примет. Исправляют в первую очередь.
- Значок «i» — справка, например о товарах без
availableили о валюте не в рублях.
Если XML сломан, инструмент покажет строку с ошибкой: всё, что после неё, сервисы не прочитают.
Частые ошибки в YML-фиде
- Цена с пробелом или запятой.
1 990и1990,50— не число для фида. Нужно1990или1990.50. - Относительные ссылки.
/catalog/itemвместоhttps://site.ru/catalog/item— сервис не поймёт, куда вести покупателя. То же с картинками. - Ссылка на удалённую категорию. После чистки каталога у товаров остаётся
categoryId, которого уже нет в<categories>. - Повторяющиеся id. Такие товары сервис отбросит или склеит. Так бывает, когда размеры и цвета выгружаются с id основного товара.
- Фид отвечает ошибкой. Выгрузка переехала, а в кабинете остался старый адрес. Проверьте ответ сервера: фид должен отвечать кодом 200.
Открываются ли сами страницы товаров, покажет поиск битых ссылок: проверка фида адреса из него не открывает.
Вопросы и ответы
Чем YML отличается от обычного XML?
YML — это XML с заданной Яндексом структурой: корень yml_catalog, магазин, валюты, категории и товары. Любой YML-фид — это XML, но не любой XML-фид подойдёт сервисам Яндекса.
Подходит ли проверка для Маркета и Директа?
Да, но это общая проверка формата YML. Требования Маркета, Директа и Товаров отличаются, поэтому перед загрузкой сверьтесь с требованиями конкретного сервиса.
Какой фид можно проверить?
До 20 МБ, а сжатый gzip — до 30 МБ после распаковки. Фид больше проверяйте частями.
Обязательна ли картинка у товара?
Для проверки — нет: товар без картинки отмечается замечанием. Но без картинки товар теряет в показах, а часть сервисов Яндекса его не примет.
Можно ли проверить фид файлом с компьютера?
Нет, только по адресу в интернете. Фид должен открываться по публичной ссылке — так же его скачивают и сервисы Яндекса.
Сохраняет ли сервис мой фид?
Нет. Фид скачивается только для проверки; по ссылке на результат проверка запускается заново.