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

Мануалы
4Нравится
1Комментарии
Поделиться
Что такое 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. Скидка по заданному промокоду.

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

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

<?xml version="1.0" encoding="UTF-8"?> <yml_catalog date="2020-01-01 15:03"> <shop> <name>Our Shop</name> <company>Our Company</company> <url>https://our-shop.com</url> <currencies> <currency id="UAH" rate="1"/> </currencies> <categories> <category id="2">Мобильные телефоны</category> <category id="5" parentId="2">Смартфоны</category> </categories> <delivery-options> <option cost="75" days="3"/> </delivery-options> <offers> <offer id="742"> <name>Samsung Galaxy S 10</name> <url>https://our-shop.com/samsung-galaxy-S10</url> <price>3560</price> <currencyId>UAH</currencyId> <categoryId>5</categoryId> <delivery>true</delivery> <delivery-options> <option cost="50" days="2"/> </delivery-options> <param name="Цвет">Чёрный</param> <weight>0.1</weight> <dimensions>12/5/0.8</dimensions> </offer> </offers> </shop> </yml_catalog>

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

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

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

    Плагин «Export YML» для автоматического создания YML-файла на сайтах на WordPress

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

    Модуль «Подготовка прайс-листа для Маркета и Беру» для автоматического создания YML-файла

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

    «Модуль выгрузки товаров на Яндекс.Маркет — Мультифид» для ресурсов на Magento для автоматического создания YML-файла

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

    Функция «Каталог товаров» в Tilda, с помощью которой можно создать файл в формате YML

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

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

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

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

Как зарегистрироваться в Яндекс.Маркете

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

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

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

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

Пример карточки товаров в Яндекс.Маркете

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

Пример рекламных блоков в Яндекс.Маркете

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

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

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

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

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