Продукты Решения Тарифы Партнерам
Клиентам
Получить консультацию
Связаться
Что такое YML-файл и как его создать
3263 просмотра
11.08.2023

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

Содержание

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

Не пропускайте новости
Получать новости
Спасибо за подписку!

Мы уже отправили вам первое письмо с подборкой лучших материалов

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

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

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

Чем YML отличается от XML

XML (eXtensible Markup Language, «расширяемый язык разметки») используется для унифицированной обработки контента, формирования его структуры. Его активно применяют во многих сферах программирования, но наиболее популярно его использование для создания интернет-страниц.

YML пользуется синтаксисом XML и его логикой, но предназначен исключительно для работы с каталогами магазинов в Яндекс.Маркете: их описаний, условий доставки и т. д. При этом расширение YML-файлов выглядит как .xml — расширение .yml обозначает совсем другой тип файлов, YAML.

В качестве редактора YML-файлов можно использовать любую программу для работы с текстом: Блокнот, Microsoft Word, Open Office и т.д.

Правила синтаксиса YML

  • Теги должны быть парными, то есть открываться (например, ‹ag›, где в угловых скобках стоит обозначение соответствующего тега) и закрываться (‹/tag› — тот же самый тег, но со значком слеша).
  • Если используется «тег в теге», необходимо сначала закрыть внутренний тег и только затем внешний. Пример: ‹offer› ‹price› ‹/price› ‹/offer›.
  • Значение параметра прописывается в кавычках: например, currency id="RUR".
  • Можно добавлять комментарии к описаниям — это делается тегом "‹!-„текст комментария“-›".
  • Для вставки специальных символов необходимо использовать коды, иначе YML воспримет их не как текст для публикации, а как служебный элемент языка.

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

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

Обязательные (общие) элементы

Заголовок

Самая первая строка при создании YML-файла, которая указывает версию XML и кодировку. Рекомендуется всегда использовать ‹?xml version="1.0″ encoding="UTF-8″?›

Корневой элемент ‹yml_catalog›

Появляется только один раз в файле, для YML-формата необходимо использовать элемент ‹yml_catalog› с атрибутом date.

Пример: ‹yml_catalog date="2023-07-22T15:48:38+03:00″›

Магазин ‹shop›

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

Предложения ‹offers›

Содержит описание конкретных позиций ассортимента, каждая из которых стоит в отдельном теге ‹offer›. Предложение можно сформировать по упрощенному типу, когда вся информация о продукции указана в одном элементе, или по произвольному — тип, модель и производитель указываются в трех отдельных тегах. Также необходим id — внутренний идентификатор товара. Как правило, в качестве id используют артикул.

Промоакции ‹promos›

Список всех рекламных акций магазина, каждая из которых представлена отдельным элементом ‹promo›.

Подарки ‹gifts›

Подарки за покупку чтобы отметить их, используется тег ‹gift›.

Опциональные элементы

Категории ‹categories›

Необязательный элемент, вкладывающийся в элемент ‹offer›. Обозначает категорию и подкатегорию (‹category›) товара.

Условия доставки ‹delivery-options›

Может быть вложением как в элемент ‹shop›, если данные условия относятся ко всему ассортименту магазина, так и в элемент ‹offer›, если касаются определенного продукта. Здесь указываются условия доставки: cost (служебная информация), days — срок доставки и order-before — время, начиная с которого доставка оформляется на следующий день.

Условия самовывоза ‹pickup-options›

Указываются по аналогии с ‹delivery-options›. Оба элемента актуальны только для магазинов, работающих по системе DBS — когда товары хранятся на складе компании и доставляются самостоятельно. Если доставка осуществляется через Яндекс.Маркет, включать их в YML-файл не нужно.

Увеличивайте продажи с платформой коммуникаций UIS
Получить консультацию

Пример полного YML файла

Копировать
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2023-07-22T15:48:38+03:00">
<shop> <name>Магазин №1</name>
<company>Бест Компани</company>
<url>http://bestcompany.ru</url>
<currencies> <currency id="RUR" rate="1"/> </currencies>
<categories> <category id="1">Товары для дома</category> <category id="10" parentId="1">Средства для мытья посуды</category> </categories>
<delivery-options> <option cost="200" days="1"/> </delivery-options>
<offers> <offer id="9012"> <name>Таблетки для посудомоечных машин Noname</name> <url>http://bestcompany.ru/product_page.asp?pid=12345</url>
<price>890</price>
<currencyId>RUR</currencyId>
<categoryId>10</categoryId>
<delivery>true</delivery>
<delivery-options> <option cost="300" days="2" order-before="14"/> </delivery-options>
<param name="Количество">100</param>
<weight>3.6</weight>
<dimensions>20.1/20.551/22.5</dimensions> </offer> </offers>
<gifts> <!-- подарки не из прайс листа --> </gifts>
<promos> <!-- промоакции --> </promos> </shop> </yml_catalog>

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

Вручную

Проще всего редактировать пример YML-файла, предлагаемый самим Яндекс.Маркетом. Там представлены все элементы, которые можно использовать, но можно выбрать только актуальные для конкретного магазина или товара.

Через модули CMS

Готовые модули CMS (систем управления магазином) для Яндекс.Маркета позволяют автоматически формировать YML-файлы, хотя определенная информация может в них не попадать — например, ограничения при заказе или условия доставки. Их необходимо будет прописать вручную.

Список доступных CMS, предлагающих модули для Яндекс.Маркета:

  • 1С-Битрикс
  • InSales
  • WordPress
  • Shop-Script
  • AdvantShop
  • Netcat
  • PHPShop
  • ReadyScript
  • UMLCMS
  • Magento
  • Simpla
  • OKAYCMS
  • Ecwid
  • Tilda Publishing

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

Сервисы Mysitemapgenerator, GitHub и YML-Shop работают как генераторы YML-файлов онлайн: они сканируют сайт продавца, идентифицируют информацию о продукции и формируют YML-файл. Однако в ходе анализа могут возникнуть ошибки, так что файл необходимо тщательно проверить перед публикацией.

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

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

Возможные ошибки при загрузке файла

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

В отчете могут содержаться следующие данные:

  • Критичные ошибки — если их не исправить, файл не будет опубликован.
  • Общие ошибки в разделе ‹shop› — файл опубликуется, но с неточностями.
  • Ошибки в элементах ‹offer› — если их не исправить, загрузятся только те предложения, которые оформлены корректно.
  • Предупреждения в предложениях — к ним стоит прислушаться, чтобы карточка товара не содержала неточностей.
  • Рекомендации — помогут улучшить представление товаров и повысить их продажи.

Как загрузить YML-файл в Яндекс.Маркет

Существует два способа загрузки YML-файла. Выбор зависит от того, насколько часто обновляются позиции в каталоге.

Файлом

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

Для этого необходимо пройти в раздел «Товары» → «Каталог» → «Загрузить файл», выбрать YML-файл на своем устройстве (он должен быть не больше 100 мб — в противном случае необходимо будет создавать несколько отдельных файлов).

При выгрузке товаров в Яндекс.Маркет можно выбрать, какие атрибуты (вес, срок годности, ресейл и уценка и и.д.) будут отражаться в карточке товара.

Ссылкой

Таким способом загрузки удобнее пользоваться магазинам, ассортимент которых обновляется регулярно. YML-файл нужно сохранить в облачное хранилище (например, Google.Drive или Яндекс.Диск) и открыть к нему доступ по ссылке. Робот Яндекс.Маркета будет каждые полчаса проводить автоматическую проверку обновлений файла и отражать их без необходимости каждый раз загружать файл вручную.

Чтобы настроить автообновление, необходимо перейти в раздел «Товары» → «Автообновление каталога» → «Добавить ссылку на файл».

При этом каталог товаров загружается отдельно (необходимо выбрать «Товары» в окне «Что передаем»), а цены в магазинах, остатки и другие условия размещения придется указывать отдельной ссылкой.

Как обновить файл

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

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

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

Оцените статью
Средняя оценка: 5
Количество голосов: 0
Поделитесь с друзьями

Новое на сайте

Как правильно квалифицировать лиды и увеличить конверсию
06 декабря
Чаты в RetailCRM, мобильная версия РМО, обновление Софтфона, доработка виджетов лидогенерации и отчет по эффективности виджетов
28 ноября
Где и как искать первых клиентов на рынке с огромной конкуренцией
27 ноября
Как строить аналитику в BI системе на базе данных UIS
21 ноября
Кейс застройщика загородной и жилой недвижимости
18 ноября
Что такое краудсорсинг технология?
01 ноября
Причины out-of-stock и анализ в торговле
05 ноября
Бизнес не игрушка
07 ноября
Что такое репрезентативная выборка данных
06 ноября
BTL-реклама: коммуникация, виды, примеры, каналы
05 ноября
Чаты в Битрикс24 и Мегаплан, распределение чатов по данным о клиенте, звонки по клику из Софтфона, доработки в отчетах и настройках
29 октября
Как построить автобизнес для себя и для клиентов: главный ключ к успеху франшиз
22 октября
Полезные кейсы, статьи и исследования от экспертов UIS
Подписаться
Нажимая кнопку вы подтверждаете, что согласны получать рассылку
Вы успешно подписаны на новости!
Спасибо за обращение
Понятно