YML-файл: зачем он нужен магазинам и как его создать

В 2023 году онлайн продажа товаров не ограничивается интернет-магазином. Все большую долю в ecommerce занимают маркетплейсы и товарный поиск Яндекса.

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

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

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

Готовить прайс-лист в формате YML немного сложнее, чем в XLS или CSV. Однако он дает ряд преимуществ. Например, позволяет автоматизировать процесс обновления товарных позиций и их характеристик.

Вот как это работает:

1. Вы создаете прайс-лист, где указываете все необходимые параметры по правилам Яндекса.
2. Яндекс обрабатывает полученные данные и создает карточки для ваших товаров в соответствующих категориях.
3. Если прайс-лист составлен правильно и в нем нет ошибок, вы получаете релевантные целевые клики и продажи.

Контекст на профессиональном уровне и без агентства — в PromoPult. Автоматический подбор слов, генератор объявлений на основе ChatGPT, «умное» управление ставками. Готовые отраслевые решения. Статистика на интерактивном дашборде.

Как выглядит YML-файл

YML-файл состоит из общей информации о магазине и списка товарных предложений (офферов).

Шапка

В шапке YML-файла указана:

• версия XML и кодировка (возможна UTF-8 или windows-1251);
• дата формирования файла.

Вот так выглядит шапка в YML-файле (первые две строки):

<?xml version="1.0" encoding="UTF-8"?>

<yml_catalog date="2020-11-22T14:37:38+03:00">

Информация о магазине

Внутри элемента <shop> указана информация о магазине, оффере и другие данные:

В элемент <shop> вложены другие элементы:

• <name> — фактическое название интернет-магазина, которое публикуется на сайте.
• <company> — полное название компании. Обязательный элемент. Он не публикуется, но необходим для внутренней идентификации на Яндекс Маркете.
• <currencies> — список курсов валют магазина. В примере на скриншоте основная валюта — российский рубль (rate= «1»). Элемент не обязателен.
• <categories> — список категорий и подкатегорий.
• <delivery-options> — условия и стоимость доставки.

Есть еще и дополнительные, необязательные элементы, входящие в <shop>: название агентства, которое отвечает за техподдержку сайта, опции самовывоза и другие. Подробнее о них читайте в соответствующем разделе Справки.

Оффер

Информация обо всех товарах интернет-магазина в YML-файле содержится в элементе <offers>. Внутрь него помещаются элементы <offer> — по одному для каждого товарного предложения.

Вот как выглядит часть YML-файла с одним товарным предложением (<offer>):

На этом скриншоте показан <offer> — одно товарное предложение (в данном случае мороженица). 

Элемент <offer> может быть упрощенного и произвольного типа. Разница — в названии товара:

• В упрощенном типе (этот пример на скрине выше) тип товара, его производитель и модель указываются в одном элементе — <name>. Подробное описание формата — здесь.
• В произвольном типе информация о типе, производителе и модели разнесена по разным элементам:

<offer id="12345" type="vendor.model">
  <typePrefix>Вафельница</typePrefix>
  <vendor>Polaris</vendor>
  <model>65790</model>
  ...
</offer>

Подробное описание формата — по ссылке.

Разберем некоторые параметры элемента <offer>.

• <price> и <oldprice> — в карточке товара будет отображаться скидка, так как новая цена ниже старой.
• <currencyId> — указатель валюты, в которой магазин принимает оплату.
• <picture> — ссылка на фотографию товара. Подтягивается в товарную выдачу Яндекса и на Маркет.
• <store> — значение true говорит о том, что забрать товар в торговом зале можно, false — нельзя.
• <pickup> — значения true и false для возможности забрать товар самовывозом в пункте выдачи.
• <delivery> и <delivery-options> — наличие товара и условия доставки.

Подробнее обо всех элементах YML-файлов можно почитать здесь.

Не все элементы обязательны к использованию. Для каждой категории товаров перечень обязательных и рекомендуемых элементов будет разным. У Яндекса есть готовые рекомендации по подготовке прайс-листов для разных категорий бизнеса. Подробно описывать все их нет смысла — воспользуйтесь удобным рубрикатором Справки Яндекса.

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

Есть три основных способа создания YML-файлов:

• вручную или с помощью скрипта;
• с помощью встроенного функционала и дополнительных модулей CMS;
• с помощью специального ПО.

Вручную

Это самый трудоемкий способ. Он подойдет интернет-магазинам, у которых не более 20-30 товарных предложений.

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

Модули для CMS

Большинство популярных CMS могут экспортировать данные из интернет-магазинов в YML-файлы. У одних CMS есть встроенный функционал — файл можно сгенерировать прямо в административной панели сайта. В других случаях приходится использовать дополнительные модули/плагины.

Фрагмент таблицы с CMS, в которых можно создать YML-файл

Полный список CMS, в которых можно создавать файл прайс-листа для Яндекс.Маркета, здесь.

С помощью софта

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

Например, YML-генератор от Mysitemapgenerator.com. С ним можно:

• индексировать сайт и конвертировать данные в YML;
• настраивать регулярное обновление прайс-листа;
• индексировать бесплатно до 500 страниц.

Как добавить товары в поиск Яндекса при помощи YML

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

Готовый прайс-лист для товарного поиска Яндекса загружается через Вебмастер. В разделе Товары и предложения — Источники данных нужно найти кнопку «Загрузить фид»:

При добавлении фида нужно выбрать регион показа объявлений и регион доставки.

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

Загрузить фид можно также через API Яндекса по инструкции.

После загрузки фида Вебмастер выдаст информацию о наличии или отсутствии ошибок в нем. Чтобы увидеть подробный отчет, нужно нажать на кнопку «Смотреть ошибки»:

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

Общее количество загруженных и принятых товаров, а также товаров с ошибками отображается в разделе Товары и предложения — Сводка.

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

Добавить товары на Маркет можно несколькими способами: вручную, через Excel шаблон, через модуль в CMS или через YML файл. Информация о первых трех способах доступна в Справке.

Чтобы данные о товарах обновлялась автоматически, стоит использовать именно YML фиды. 

В личном кабинете магазина перейдите на вкладку «Товары» — «Автообновление».

Далее нажмите на кнопку «Добавить ссылку на файл». 

На этом этапе необходимо выбрать, будет ли фид передавать информацию конкретно о товарах или только об условиях размещения в магазинах: ценах, остатках и проч.

Разделение файлов удобно для продавцов, работающих одновременно по разным бизнес-моделям. Предположим, у вас есть два магазина, FBS и DBS, с одинаковым ассортиментом. В этом случае вы создаете три фида: один с товарным каталогом и два с индивидуальными условиями размещения для каждого магазина.

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

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

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

Подробнее о тонкостях добавления YML фидов для Маркета можно почитать здесь.

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

Проверка YML на ошибки

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

Если вы не проверите YML-файл, в любом случае при добавлении его в Вебмастер сервис проверит его на ошибки и выдаст отчет.

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

Есть несколько классификаций ошибок, о которых сообщает Яндекс:

• Критичные ошибки. Обязательно нужно исправить, иначе прайс-лист не опубликуется на Маркете.
• Общие ошибки. Ошибки в элементе . Такой прайс-лист скорее всего будет опубликован, но в товарных позициях могут быть неточности.
• Ошибки в предложениях. Обязательно нужно исправить, так как товарные предложения не опубликуются на Маркете.
• Предупреждения в предложениях. Неточности, которые лучше исправить. Товары будут опубликованы, даже если не исправлять, но в таком случае это может привести к нерелевантным кликам.
• Рекомендации. Советы по оптимизации прайс-листа. Помогают получать больше переходов и заказов на Маркете.

Подробнее об ошибках — здесь.

Отличия в YML фидах для поиска и для Маркета

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

Примеры подобных элементов:

• bid — ставка для аукциона на Маркете;
• count — остаток товара на складе;
• downloadable — для виртуальных товаров, которые пользователи скачивают с предоплатой;
• expiry — срок годности товара;
• manufacturer_warranty — официальная гарантия от производителя;
• supplier — ОГРН или ОГРИП стороннего продавца.

Полный перечень необязательных строк доступен в Справке.

Элемент platform, в котором продавец указывает версию CMS своего сайта, наоборот, обязателен для YML фидов в товарном поиске.

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

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

• цене;
• наличии товара на складе;
• условиях оплаты и доставки.

Размещенный на Маркете прайс-лист нужно обновлять как минимум один раз в 30 дней, если вы загружали его в личном кабинете.

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

Общая индексация Яндекс Маркета проводится каждые 3-6 часов. За это время полностью обновляются все товарные предложения на Маркете. Измененные цены и скидки обновляются быстрее — 30-40 минут.

Удобнее всего настроить автоматическое обновление YML-файла на сайте. Тогда на Маркете всегда будет актуальная информация.

При добавлении фида в Вебмастер Яндекс сам будет периодически скачивать файл и актуализировать информацию о товаре.

YML-файл полезен для контекстной рекламы

Еще один вариант применения YML-файла — быстрое составление объявлений для контекстной рекламы. Для того чтобы в один клик получить объявления для каждого товара:

1. Перейдите в бесплатный Генератор из YML и укажите ссылку на ваш YML-файл (например, https://mysite.ru/market.xml).
2. Загрузите результат в формате XLSX в «Списке задач».

Объявления выглядят так:

Без автоматизации пришлось бы долго вручную перебирать все названия и цены товаров. Для интернет-магазинов с большим ассортиментом Генератор из YML — удобное решение. Вот исчерпывающий гайд по работе с Генератором из YML от PromoPult.

Если же вы хотите полностью избавиться от необходимости составлять объявления контекстной рекламы, попробуйте инструмент «Написание контекстных объявлений» от PromoPult. Вот инструкция по работе с ним.

Резюме

• Фиды YML позволяют разместить торговые предложения в Яндекс Маркете и в поиске по товарам Яндекса. Присутствуя на этих площадках, вы значительно расширяете свой контакт с аудиторией и, соответственно, повышаете продажи.
• YML фид можно сгенерировать вручную или с помощью плагинов для CMS. Второй вариант предпочтительнее, так как он сокращает возможность появления ошибок в файле.
• В фидах для Яндекс Маркета и для товарного поиска есть небольшие различия, об этом стоит помнить при подготовке офферов.
• И напоследок: позаботьтесь о должном качестве сайта, чтобы привлекаемый трафик не уходил из-за досадных ошибок.