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

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

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

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

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

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

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

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

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

Из чего состоит 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

Все предельно просто, как в 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.

Маркетинг

Читайте также:

Кому подойдет реклама на Twitch, и как ее запустить

Кому подойдет реклама на Twitch, и как ее запустить

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

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

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

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

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