Что такое YML-файл, и зачем он нужен

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

1. YML-файл: что это, для чего используется и как выглядит

YML-файл для Яндекс.Маркета пишется на языке Yandex Market Language, созданном специалистами этой поисковой системы на основе стандарта XML.

Он позволяет получать сведения о товарных предложениях интернет-магазинов и добавлять их на торговую площадку.

Yandex YML-файл размещается на сайте и автоматически обновляет информацию о товарных позициях на Яндекс.Маркете, например, сведения о стоимости или наличии товаров. Это одно из преимуществ такого формата по сравнению с CSV и XLSX, в которых также можно загружать прайс-листы магазина, однако в них не доступно автоматическое обновление информации.

2. Как создать YML-файл

Файл YML Яндекс необходимо создавать в кодировке UTF-8 или windows-1251. Для описания товаров используются специальные теги, добавляются наименование товара, цена, валюта, категории, акции, параметры. При заполнении всех тегов формируются стандартные рекламные предложения либо карточки товаров в Яндекс.Маркете с расширенной информацией — рейтингом, обзорами, отзывами и прочими данными.

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

2.1. Создание YML-файла в ручном режиме

Перед тем как перейти к созданию, стоит ознакомиться со следующими правилами:

• Из непечатаемых символов с ASCII-кодами от 0 до 31 можно использовать только табуляцию, возврат каретки и перевод строки.
• Заменяйте специальные символы:
  " на &quot & — &amp > — &gt < — &lt ' — &apos
• Разделителем целой и дробной части числа должна быть только точка.

Алгоритм создания YML-файла

1. Откройте текстовый редактор и разместите в самом начале первой строки заголовок , указав в нём версию и кодировку:
   
   <em><?xml version="1.0" encoding="UTF-8"?></em><br>

2. Добавьте корневой элемент yml_catalog с датой и временем создания файла:
   
   <yml_catalog date="2020-01-15 14:28">

3. Разместите элемент shop, в котором будет находиться описание магазина, его товары и акции. В каждом элементе должны присутствовать обязательные теги, которые мы рассмотрим более детально.

Обязательные теги блока с описанием магазина:

• <name> — название интернет-магазина.
• <company> — название компании-собственника магазина. Используется только для идентификации Яндекс.Маркетом.
• <url> — адрес сайта.
• <currencies> — список курсов валют.
• <categories> — категории интернет-магазина.
• <delivery-options> — сведения о доставке, обязательный тег, если информация о доставке передаётся в YML-файле.
• <offers> — перечень предложений интернет-магазина.
  

О необязательных тегах элемента можно почитать в документации Яндекс.

Товарные предложения могут описываться в упрощённом и произвольном типах. Они размещаются внутри элемента , в котором содержатся все товары магазина. В упрощённом типе название, производитель и тип товара добавляют в один элемент, а в произвольном — в отдельные.

Обязательные теги и атрибуты для произвольного типа описания:

• <offer id="уникальный идентификатор" type=vendor.model> — идентификатор предложения и его тип описания.
• <model> — модель и наименование предложения.
• <vendor> — производитель.

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

Обязательные теги элемента <offer> для упрощённого типа описания:

• <name> — расширенное название товара, включает тип, производитель, модель, наименование и ключевые характеристики. Указанные сведения используются для привязки к карточке товара.
• <id> — уникальный идентификатор товара, состоящий из цифр и латинских букв.
• <url> — ссылка на товар в интернет-магазине.
• <price> — стоимость товара. Должна соответствовать цене, указанной на сайте рекламодателя.
• <currencyId> — обозначение используемой валюты на латинице (USD, UAH, RUR).
• <categoryId> — число-идентификатор категории.

В некоторых случаях необходимо добавлять и другие теги. Весь список также доступен в Яндекс.Помощи.

Элементы промоакций <promos> и <gifts>
В YML-файл также могут добавляться данные об акциях магазина. При этом они могут распространяться как на отдельные товары, так и на категории. В данном блоке размещают описание акций и идентификаторы позиций и категорий, которые в них участвуют. Доступны такие акции:

1. Снижение цены на определённое время.
2. Подарок при покупке:
   • другая товарная позиция, которая не размещена на Маркете;
   • такой же товар, если куплено определённое количество единиц.
3. Скидка по заданному промокоду.

Информация по акциям должна совпадать в Яндекс.Маркете и на сайте компании. Какие теги нужны для формирования акций, можно узнать в справочной документации Яндекса.

Пример файла:

2.2. Программы для автоматического создания YML-файла

Для крупных интернет-магазинов ручное создание YML-файла Яндекс.Маркета — слишком трудоёмкий процесс. Автоматизировать задачу позволяют различные модули и расширения, которые генерируют файл с ассортиментом онлайн-магазина. Полный список расширений и модулей размещён в Яндекс.Справке. Упомяну несколько их них:

1. Плагин Export YML для сайтов на WordPress.

   
   

2. Модуль «Подготовка прайс-листа для Маркета и Беру».

   
   

3. Модуль выгрузки товаров на Яндекс.Маркет — Мультифид для ресурсов на Magento.

   

4. В Tilda добавлена опция импорта и экспорта товаров.

   

3. Как добавить YML-файл в Яндекс.Маркет

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

1. Добавить ссылку на файл, размещённый на сайте.
2. Загрузить файл в личном кабинете — доступно для документов до 100 Мб.
   

Для начала зарегистрируйтесь в Яндекс.Маркете и добавьте сведения о магазине:

Затем загрузите юридическую информацию. В личном кабинете перейдите на страницу «Ассортимент» — «Прайс-лист». Здесь можно добавить ссылку либо сам файл-YML:

После добавления ссылки либо файла нажмите «Проверить прайс-лист». Если ошибки не будут обнаружены, нажмите «Добавить прайс-лист», и на этом настройка будет завершена.

На основании полученной информации для популярных продуктов формируются карточки товаров.

Для товаров, пользующихся меньшим спросом, — обычные рекламные блоки.

Чтобы ускорить процесс попадания своего товара на карточку, отправьте соответствующий запрос в форме обратной связи.

Подводим итоги

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

Также файл YML позволяет автоматически обновлять информацию о наличии товаров, изменять их цены в Яндекс.Маркете. Если разместить файл по ссылке, он будет загружен в течение двух с половиной минут. Регулярное обновление файла позволит быстро менять данные товарных предложений на Яндекс.Маркете— это занимает не более четырёх часов, а иногда достаточно всего 30 минут.

А вы используете в работе YML-файлы? Буду рада, если поделитесь своими мнением и опытом в комментариях :)