YML-файлы: формирование, ограничения и настройки

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

Генерация файла YML

В некоторых популярных CMS есть уже готовые инструменты для создания YML-документов. Например, такой плагин есть в 1С Битрикс и OpenCart. Если функционал вашей системы управления сайтом не позволяет генерировать турбо-страницы автоматически, вы можете разработать их вручную. Для этого необходимо создать документ в формате XML и разместить в нём информацию о товарах с помощью специальной разметки.

Требования к содержимому файла

Стандарт YML был разработан Яндексом на основе языка гипертекстовой разметки XML. Пример структуры документа, в котором используется такая разметка, вы можете посмотреть на скриншоте ниже:

Чтобы создать подобный документ, обладать навыками программирования не нужно. Достаточно следовать описанию XML-тегов, которые указаны в справке Яндекса. Структура документа произвольная (то есть вы сами выбираете какие передавать данные о товарах), но на странице обязательно должны быть следующие элементы:

• Наименование производителя (vendor);
• Модель и название товара (model);
• Актуальная стоимость продукта (price) — указывается без пробелов и обозначения валюты;
• Описание товара (description) — не более 3000 символов;
• Описание характеристик товара (param) — элемент используется для товаров одной модели, которые отличаются индивидуальными характеристиками (например, цвет, размер);
• Ссылка на страницу товара на сайте магазина (url).
• Некоторые другие обязательные элементы в зависимости от того какой используется тип передачи данных — упрощённый или произвольный.
• Также на странице должна быть кнопка добавления товара в корзину. Она настраивается с помощью Яндекс.Вебмастера в разделе “Турбо-страницы — Настройки” (блок “Настройки товарных страниц”). Вы можете выбрать один из следующих способов оформления заказа:
• Добавить в корзину — клиент будет переадресован в корзину вашего магазина с добавленным товаром.
• Купить в 1 клик — заказ поступит на электронную почту.

Ограничения YML-файла

Для каждого сайта доступно подключения до 10 документов при условии соблюдения следующих ограничений:

Экспорт YML в сервисы Яндекса

Сформированный документ необходимо загрузить в корневую директорию сайта и разрешить его индексацию в файле robots.txt.

После выгрузки документа на сервер последовательно выполните следующие шаги:

1. Перейдите в раздел “Турбо-страницы — Источники” Яндекс.Вебмастера и в блоке “Ссылка на источник” установите ползунок в значение “YML”;
2. В поле ниже укажите адрес документа на вашем сайте;
3. При необходимости укажите логин и пароль для доступа к документу.
4. Нажмите кнопку “Вкл” напротив нужного источника.

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

Примеры ошибок в YML

Обновление YML

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

Актуальную версию турбо-страницы можно увидеть по ссылке “Предварительный просмотр” в разделе “Турбо-страницы — Источники”.