Что такое YML-файл и как его создать

35 226
Оглавление

Продавцам, у которых мало товаров, не составит труда загрузить их на маркетплейс вручную. Если же в каталоге представлены сотни или даже тысячи позиций, их размещение нужно автоматизировать. К счастью, сами маркетплейсы предоставляют такую возможность. Продавцу достаточно загрузить файл в специальном формате, а все остальное система сделает сама. 

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

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

YML — Yandex Market Language, что означает «Язык Яндекс.Маркета». Он был создан на базе технологии XML, которая упрощает передачу данных в приложения и онлайн-платформы. 

Существует также формат CSV, который позволяет автоматически загружать таблицы товаров на маркетплейс. Однако удобнее использовать собственный стандарт Яндекса. 

YML позволяет:

  • добавлять товары в каталог;

  • актуализировать информацию в карточках;

  • переносить прайс-листы из других программ и сервисов;

  • формировать тексты для рекламных объявлений.


YML подходит также для работы в Вебмастере — сервисе Яндекса для аналитики сайтов.

Из чего состоит

YML-файл состоит из следующих элементов:

  • заголовок;

  • <yml_catalog>;

  • <shop>;

  • <categories>;

  • <offers>.


Одни нужно заполнять обязательно, от других можно отказаться — это зависит от особенностей магазина. Детальная информация об элементах есть в справке Яндекса

Информацию о магазине помещают внутри тегов <shop> и </shop>. Сюда вписывают название компании, ссылку на главную страницу магазина, валюты для оплаты, категории товаров, информацию о доставке. 

В оффер, то есть между <offers> и </offers>, добавляют все товары. Для каждой позиции создают отдельный элемент — <offer>. Именно по нему Яндекс определяет, какую карточку создать. Здесь указывают цену, размер скидки, наличие, ссылку на фотографию.

Если необходимо, добавьте дополнительные элементы: <gifts> для подарков, <promos> для промоакций, <adult> для товаров 18+. Пример файла YML можно скачать в Яндекс.Справке.

Синтаксис

Структура документа напоминает HTML, поэтому у тех, кто знаком с версткой, вряд ли возникнут сложности. 

Основные принципы синтаксиса:

  • Закрывающие теги должны полностью совпадать с открывающими. Это значит, что <price> и </Price> относятся к разным тегам.

  • Важно соблюдать порядок. Когда один тег открывается внутри другого, его там же и закрывают. Например, <offer> <name> </name> </offer>. 

  • Нельзя сначала записать </offer>, а потом </name>. Чтобы добавить значение, его заключают в кавычки: id="5".

  • Для комментариев предусмотрена специальная последовательность символов. Начинается с "<!-", далее идет комментарий, а заканчивается "->".

  • Когда нужно добавить специальные символы вроде апострофа или амперсанда, используют служебные элементы. Их полный список вы найдете здесь.

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

Таблицу в Excel создавать проще. С другой стороны, у формата от Яндекса больше возможностей, поэтому стоит научиться с ним работать. Если подробнее разобраться в том, как создать файл YML, можно выделить 3 способа. Выбор зависит от количества товаров.

С помощью CMS

CMS — системы управления магазином, такие как 1С‑Битрикс, InSales, МойСклад. Во многих популярных CMS присутствуют модули, которые позволяют создавать YML-файлы. 

Этот способ удобно использовать при большом количестве позиций, но некоторые элементы все равно придется добавлять вручную: информацию о доставке, предоплате, минимальном количестве единиц при продаже. 

Модуль CMS позволит автоматизировать следующие процессы: 

  • обновление каталога и информации в карточках;

  • изменение цен и назначение скидок;

  • настройку отображения товаров на витрине (например, когда необходимо скрыть некоторые позиции);

  • создание и отправку заявок на поставку;

  • формирование товарных ярлыков-наклеек;

  • обновление данных об остатках товаров;

  • обработку заказов;

  • настройку параметров доставки и оплаты;

  • получение статистики.



С помощью специального сервиса 

Наиболее популярные сервисы для создания файлов YML — Mysitemapgenerator, GitHub и YML-Shop. Они схожи по функционалу и принципу работы: 

  1. Сканируют ваш сайт.

  2. Извлекают данные о продуктах.

  3. Обрабатывают их с помощью искусственного интеллекта.

  4. Конвертируют полученную информацию в XML для различных платформ, а для Яндекса — конкретно в YML. 


Также подобные сервисы предоставляют расширения для интеграции с CMS. 

Вручную

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

Сформируйте YML с помощью специального ПО, такого как Notepad++. Готовые библиотеки возможно получить в сервисе GitHub. Упакуйте файл в ZIP- или gzip-архив. Загрузите в Вебмастер Яндекса, чтобы провести проверку. Если система обнаружит ошибки, в разделе «Источники данных» будет оповещение. 

В бизнесе многие процессы лучше автоматизировать, чтобы избежать ошибок и освободить время сотрудников. Сделки MANGO OFFICE — удобный сервис с полезными инструментами для ведения клиентской базы, автообзвона, обработки чатов, заявок и разговоров. Система автоматически добавляет новых клиентов в базу после звонка, сообщения в мессенджере или соцсети. Весь путь покупателя будет прозрачным для вас — от первого контакта до покупки. 

Как загрузить на маркетплейс

Зайдите в аккаунт своего магазина или зарегистрируйте его в Яндекс.Маркете. Укажите информацию о магазине и подтвердите права доступа. 

Перейдите в личный кабинет → «Товары» → «Каталог» и используйте один из трех способов загрузки файла: 

  1. Если он сохранен на ПК, кликните на «Загрузить файл» и выберите подходящий в открывшемся окне. Размер файла не должен превышать 100 Мб.

  2. Если YML-файл на сайте, кликните «Ссылка» и укажите адрес документа. Затем нажмите «Проверить прайс-лист». Если ошибок нет, информация добавится в Маркет. 

  3. Скачайте шаблон файла и заполните его. Кликните в ЛК «Загрузить файл» → «Добавить товары».


Посмотрите видеоинструкцию загрузки товаров на маркетплейс.

Если в документе присутствуют ошибки, Яндекс не пропустит его в каталог или, по крайней мере, укажет некорректные данные. Чаще всего проблема кроется в синтаксисе. Важно соблюдать порядок тегов, использовать только поддерживаемые символы и добавлять уникальные идентификаторы. 

Реже встречается проблема с кодировкой. Она может быть только UTF-8 и windows-1251.

Как проверить на ошибки

Если хотите заранее убедиться в корректности документа, воспользуйтесь валидатором в Яндекс.Вебмастере. Укажите источник документа и запустить проверку. Любые ошибки будут подробно описаны. После их устранения запустите проверку еще раз, чтобы окончательно убедиться в правильном оформлении.

В процессе работы Яндекс.Маркет предлагает рекомендации по оптимизации, которые помогают увеличить количество заказов — не пренебрегайте ими.

Как обновить прайс-лист

Чтобы пользователи видели только актуальную информацию о товарах, обновляйте прайс-лист. Желательно это делать минимум раз в месяц. Система в первую очередь контролирует изменения цен и скидок. Они проверяются каждые полчаса. Остальную информацию Яндекс анализирует от 4 до 8 раз в сутки в зависимости от категории. Самый удобный вариант — настроить автоматическое обновление.

Заключение

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

  • Документ состоит из трех основных разделов: заголовка, информации о магазине и оффера. 

  • Создают YML-файл вручную, либо с помощью сервисов и модулей CMS. 

  • Перед загрузкой прайс-лист можно проверить на ошибки с помощью валидатора от Яндекса.

  • Подробнее о том, где создать, как открыть YML-файл, и обо всех остальных нюансах ведения онлайн-магазина в Маркете читайте в Яндекс.Справке