16 января 2022
Темы | Маркетинг
Нет времени читать?
Отправить статью на почту

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

16 января 2022
15 мин на чтение
14470
Что такое YML-файл и как его создать
author__photo

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

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

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

YML – особенный формат файла, разработанный специалистами Яндекс.Маркета для обработки прайсов. Основой послужил стандарт xml. Задействованы кодировки UTF-8, windows-1251. По сравнению с альтернативными вариантами обладает расширенными возможностями. В их числе автоматическая актуализация данных (стоимость, наличие, характеристики).

Файлы YML предназначены для:

  • выгрузки товарных позиций в каталог Яндекс.Маркет;
  • массовой обработки карточек товаров;
  • обновления информации о продуктах;
  • формирования price-листа из Google Docx, Excel, информационных баз, в том числе на основе OpenOffice;
  • генерации текстов объявлений для платной рекламы.

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

А для того, чтобы автоматизировать бизнес-процессы, подключите сквозную аналитику Calltouch. Она объединяет в себе все основные данные: заявки покупателей, рекламные расходы, финансы, клиентскую базу. С ее помощью вы сэкономите время на обработке заказов, оптимизируете рекламу и увеличите продажи.

Сквозная аналитика
Оценивайте эффективность всех рекламных кампаний в одном окне от клика до ROI
Вкладывайте в ту рекламу, которая приводит клиентов
Подробнее

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

Документ имеет четкую структуру: шапка, информация об интернет-магазине, offers (предложения). В состав YML-файла иногда включают подарки (gifts), рекламные предложения (promos – скидки, акции). Рассмотрим подробнее основные элементы.

Шапка

Состоит из двух элементов: 

  • xml header – указывает тип кодировки; 
  • yml_catalog – содержит дату и время, а также, как правило, момент генерации файла. 

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

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

Фактически, это описание торговой точки. Основные элементы раздела:

  • <name> – название онлайн-магазина;
  • <company> – официальное наименование компании-продавца, по которому Яндекс.Маркет ее распознает;
  • <url> – ссылка на интернет-магазин, обязательна при использовании модели «перейти на сайт», ведет на главную страницу;
  • <currencies> – перечень валют;
  • <categories> – товарные категории и подразделы;
  • <delivery-options> – доступные варианты доставки, стоимость.

Определенные теги предназначены для указания вспомогательной информации.

Offers

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

  • упрощенный – наименование товара состоит из 1 элемента, содержащего тип изделия, бренд, модель;
  • произвольный – название составное (3 элемента).

Оба варианта подходят для большинства категорий товаров.

Для определенных товарных категорий существуют специальные описания. Например, лекарств, аудио-, видеопродукции, алкоголя, литературных изданий, билетов на мероприятия (концерты, лекции и так далее), туров. 

Особые категории

К ним относят подарки, рекламные товары, изделия, доступные без предзаказа, товары для взрослых. Размещаются с применением тегов <gifts>, <promos>, <store>, <adult>. Полный список доступных элементов shop представлен на странице Яндекс.Маркета.

Обязательные элементы файла YML: name, company, url, categories, delivery-options (если данные об условиях доставки внесены в прайс-лист), offers.

Синтаксис YML

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

  1. Регистр имеет значение – оба тега (открывающий/закрывающий) следует писать одинаково. <name> </Name> – неправильно, <name> <name/> – правильно.
  2. Корректное вложение тегов. <categories> <category> </categories> </category> – неправильно, <categories> <category> </category> </categories> – правильно. То есть, если элемент открыт внутри другого, закрыть его следует тоже внутри него.
  3. Обязателен корневой элемент – всегда один, он – родительский для всех остальных. <корневой элемент> содержимое документа </корневой элемент>.
  4. Шапка. Аналог XML-пролога. Всегда первая строка: <?xml version=”1.0″ encoding=”UTF-8″?>. В YML документе используется кириллица (названия категорий, подкатегорий, товаров, валюта и так далее). Кодировка обеспечивает правильное отображение символов.
  5. Значения заключаются в кавычки – как в HTML и XML. Пример: <pickup-options><!– условия самовывоза –><option cost=”500″ days=”1″/></pickup-options>. Атрибут – option cost, значение – «500», атрибут days, значение – «1». Если значение указано без кавычек, система не воспримет его адекватно.
  6. Сущности. Это замена определенных символов на альтернативные комбинации. К примеру, возникла необходимость использовать знак «<», вместо него применяют &lt. Аналогично в замене нуждаются кавычки и другие служебные элементы YML: апостроф, амперсанд, знак «больше»/«меньше».
  7. Комментирование. Начало обозначают «<!–», окончание – «–>». Пример: <!– названия подкатегорий –>. Важно! Внутри комментария запрещена последовательность двух тире без пробела.

Важное понятие – валидность, правильность фида. Проверяется с помощью валидатора. Существует несколько схем валидации, доступна проверка файла, в текстовом формате, по ссылке. 

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

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

Вручную

Подойдет любой текстовый редактор, но все же удобнее пользоваться специализированными приложениями, например, Notepad+. Технология трудоемкая, востребована при незначительном количестве товаров (максимум до 30-50). Процесс станет проще, если использовать готовые библиотеки с GitHub.

Модули CMS

Возможность экспорта данных в YML-прайсы предусмотрена во многих системах управления контентом – в админпанели или плагинах. Например, в WP, 1С-Битрикс, Shop-Script7, AdvantShop и других. На Magento, Simpla, OCAYCMS, Ecwid модули для формирования прайслиста YML предоставляются платно. В некоторых CMS действуют ограничения:

  • несоответствие формату Яндекс.Маркета – проверьте предложения перед выгрузкой, чтобы они оказались в правильной категории;
  • надо вручную добавлять элемент sales_notes, который описывает условия продажи, например, обязательную предоплату, минимальный объем поставки и так далее;
  • параметры доставки придется прописать вручную в персональном кабинете.

Важно! За исключением 1С-Битрикс и Insales все модули созданы сторонними компаниями, из-за чего маркетплейс не берет на себя ответственность за их работу.

При помощи программ

Этот способ менее популярен, чем модули CMS. Наибольшее распространение получил YML-генератор Mysitemapgenerator. Это условно бесплатный сервис. До 500 позиций можно загрузить бесплатно. Пользоваться предельно просто:

  1. Выберите тарифный план (бесплатно, Static Pro, постоянный).
  2. Введите корневой URL интернет-магазина.
  3. Запустите сканирование сайта.

Конвертация в YML-файл происходит автоматически. Генератор самостоятельно извлечет информацию о товарах.

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

Необходимо зайти в подраздел «Прайс» (в разделе «Ассортимент»). Возможны 3 варианта:

  1. Добавить YML-файл в корневую папку, в персональном кабинете маркетплейса указать ссылку на него. Дополнительно потребуется предоставить данные для доступа (логин, пароль).
  2. Загрузить фид-файл с ПК (ограничение по объему 100 Мб).
  3. Выгрузка с использованием макроса в Excel (если фид составляли в нем). Авторизуйтесь в Excel (потребуются номер рекламной кампании, ключ).

Загрузка с ПК подойдет для небольших интернет-магазинов, первый способ – универсальный, применим к бизнесу вне зависимости от масштаба деятельности.

Как проверить YML

Воспользуйтесь валидатором Yandex. Сервис оценивает корректность оформления элементов, атрибутов и значений, соответствие XSD-схеме. Доступны стандартные схемы и произвольные (следует выбрать вариант «другие схемы»). Основные этапы:

  1. Выбор схемы валидации.
  2. Определение источника фида (файл, ссылка, текст).
  3. Запуск проверки на соответствие YML-формату. 
  4. Устранение ошибок и повторная валидация – несколько циклов до получения нужного результата.

Валидатор укажет тип и расположение ошибок, что существенно упрощает процесс.

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

Изменились цены, условия доставки или характеристики товара? Позаботьтесь о том, чтобы описания ваших товаров на Яндекс.Маркете всегда были актуальными.

Ключевые моменты:

  • загруженный через персональный кабинет прайс-лист рекомендуется обновлять не реже, чем каждые 30 дней;
  • при размещении в корневой папке сайта актуализация данных нужна при каждом изменении важных параметров – робот маркетплейса самостоятельно скачает обновленный файл во время индексации;
  • в среднем индексация происходит каждые 3-6 часов, ключевые характеристики (цены и скидки) обновляются значительно быстрее – в течение 30-40 минут.

Рекомендуем наладить автоматическое обновление на сайте – тогда данные о ваших товарах всегда будут достоверными.

А для того, чтобы объективно анализировать эффективность рекламных кампаний и  стать еще ближе к ЦА, используйте технологию распознавания речи и автоматического определения типов обращений – речевую аналитику Calltouch Предикт.

Предикт
Анализируй и сегментируй звонки легко и быстро
Текстовая расшифровка звонков и автотегирование
Подробнее

Возможные ошибки при экспорте данных

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

  1. Некорректно указаны спецификации. Чтобы проверить, переименуйте файл (укажите расширение .xml), после чего просмотрите его в браузере. Альтернативный вариант – проверка с помощью валидатора (описано выше).
  2. Не соблюдены правила синтаксиса YML (порядок элементов, значения атрибутов, вложенность тегов и прочее).
  3. Использованы символы, которые не поддерживаются. Их необходимо заменить сущностями (комбинациями символов).
  4. Неверная кодировка – допускается только UTF-8 и windows-1251.

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

Коротко о главном

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

Важные моменты:

  1. YML-файл содержит два основных элемента: шапку и shop, который содержит описание интернет-магазина, предложения, структурированные по категориям и подразделам.
  2. Оффер – самый важный элемент прайса, содержащий основную информацию о товаре: название, модель, стоимость, характеристики, условия доставки и продажи.
  3. Доступны 3 способа формирования YML-фидов: вручную, с помощью модуля CMS, специальных программ (YML-генераторов).
  4. Выгрузка прайса на Яндекс.Маркет возможна как в персональном кабинете (с ПК), так и путем предоставления ссылки на файл на сайте (могут потребоваться логин и пароль).

Для автоматического обновления данных в маркетплейсе предпочтительнее настроить актуализацию на сайте, в этом случае информация будет обновляться не реже, чем раз в 6 часов, а цены и скидки – до 40 минут.

Автор блога Calltouch
Нет времени читать?
Оцените
Поделитесь с друзьями
Лучшие маркетинговые практики — каждый месяц в дайджесте Calltouch
Подписывайтесь сейчас и получите 13 чек-листов маркетолога
Нажимая на кнопку "Подписаться", вы даёте своё согласие на обработку персональных данных и получение рекламной информации о продуктах, услугах посредством звонков и рассылок по предоставленным каналам связи.
У вас интересный материал?
Опубликуйте статью в нашем блоге
Опубликовать статью
Хотите получить актуальную подборку кейсов?
Прямо сейчас бесплатно отправим подборку обучающих кейсов с прибылью от 14 730 до 536 900р.
[contact-form-7 404 "Not Found"]
У нас тут cookies…
На сайте используются файлы cookies. Продолжая использование сайта, вы соглашаетесь с этим. Подробности об обработке ваших данных — в политике использования файлов cookie.
Вставить формулу как
Блок
Строка
Дополнительные настройки
Цвет формулы
Цвет текста
#333333
Используйте LaTeX для набора формулы
Предпросмотр
\({}\)
Формула не набрана
Вставить