YML-файл (Yandex Market Language) — это формат данных, разработанный Яндексом для передачи информации о товарах. Он основан на стандарте XML и предназначен для выгрузки товарных позиций в каталог маркетплейса, массовой обработки карточек товаров, обновления информации о продуктах и формирования прайс-листов из различных источников.

YML-файл используется не только для Яндекс Маркета, но и для:

товарных фидов в Яндекс Директе (динамические объявления, товарные кампании);
других рекламных и торговых площадок, поддерживающих YML или XML-фиды;
синхронизации ассортимента, цен и наличия товаров;
формирования текстов объявлений через генераторы объявлений на основе товарного фида.

Из чего состоит YML-файл

Отметим основные элементы YML-файла.

Заголовок (XML header)

Определяет версию XML и кодировку файла:

Корневой элемент `<yml_catalog>`

Содержит дату и время генерации файла:

Блок `<shop>`

Основная информация о магазине:

`<name>` — название магазина;
`<company>` — юридическое название;
`<url>` — сайт.

Внутри `<shop>` также располагаются ключевые разделы:

1. `<currencies>`. Список валют:

2. `<categories>`. Дерево категорий:

3. `<offers>`. Список товарных предложений. Каждый товар — это отдельный элемент `<offer>`:

Особые категории и сценарии

Дополнительные сценарии (подарки, акции, офлайн-наличие, товары 18+) реализуются не столько отдельными разделами, сколько через атрибуты и дополнительные элементы внутри ``.

Для этого используются такие элементы:

`<gifts>` — подарки;
`<promos>` — акции;
`<store>` — наличие в магазинах;
`<adult>` — товары для взрослых.

Их применение зависит от площадки и задачи (Маркет, Директ и другие), поэтому важно ориентироваться на требования конкретного сервиса.

Пример описания товара в YML-файле

Синтаксис YML-файла

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

закрывающие теги должны полностью совпадать с открывающими, например <price> и </price> относятся к разным тегам;
важно соблюдать порядок: когда один тег открывается внутри другого, его там же и закрывают. К примеру, <offer> <name> </name> </offer>;
чтобы добавить значение, его заключают в кавычки: id="5";
для комментариев предусмотрена специальная последовательность символов: начинается с <!-, далее идет комментарий, а заканчивается ->;
когда нужно добавить специальные символы вроде апострофа или амперсанда, используют служебные элементы.

Вопросы-ответы

Вручную с помощью текстового редактора или специализированного приложения, такого как Notepad+ (способ подходит, если в каталоге до 50 товаров); через модули CMS (WP, 1С-Битрикс, Shop-Script7, AdvantShop и других) или в специальных приложениях, например через YML-генератор Mysitemapgenerator.

Зайти в подраздел «Прайс» в разделе «Ассортимент», а затем добавить YML-файл в корневую папку, указав ссылку на него в личном кабинете. Также можно загрузить фид-файл до 100 Мб с ПК или выгрузить его через Excel, если товарный фид составлен через него.