О чем речь? YML-файл стал незаменимым инструментом для предпринимателей и маркетологов, работающих с маркетплейсами Яндекса. Этот формат позволяет эффективно управлять товарными предложениями, автоматизировать процесс выгрузки каталогов и оптимизировать работу с онлайн-площадками.
Что учесть? По сути, YML-файл — попытка компьютерщиков заговорить на человеческом языке, где структура данных задается не пугающими тегами, а обычными пробелами и переносами строк.
В этой статье:
- Что собой представляет YML-файл
- Практическое применение YML-файла
- Элементы YML-файла
- Как создать YML-файл
- Как сделать YML-файл вручную
- Проверка YML-файла
- Как загрузить YML-файл в Яндекс.Маркет
- Как загружать YML-файл на сайт
- Обновление YML-файла
- Часто задаваемые вопросы об YML-файле
-
Чек-лист: Как добиваться своих целей в переговорах с клиентамиСкачать бесплатно
Что собой представляет YML-файл
«Язык Яндекс.Маркета» принято сокращать до YML, от английского «Yandex Market Language». Это структура на базе технологии XML, позволяющая передавать данные в онлайн-платформы и в приложения без особого труда.
Выделяют еще один формат, названный CSV. Он дает возможность загружать таблицы товаров прямо на маркетплейсы в автоматическом режиме. Хотя в наше время многие пользуются установленными стандартами «Яндекса».
Источник: shutterstock.com
YML-файл дает возможность:
-
обновлять данные в карточках;
-
добавлять товары в каталог;
-
переносить данные из других программ и сервисов;
-
создавать материалы для рекламы.
Подход YML-файлов применяют также в «Вебмастере» — сервисе «Яндекса» для анализа сайтов.
Читайте также!
Практическое применение YML-файла
Файл формата YML позволяет:
-
сделать процесс добавления карточек в интернет-магазине автоматическим;
-
генерировать рекламные объявления и запускать ретаргетинг;
-
менять данные в объявлениях массово во всех выбранных карточках;
-
сделать сайт более видимым для поисковых систем.
-
Для маркетплейсов.
Позволяет экономить массу сил, времени, денег, которые продавцы и менеджеры тратят на ручное добавление в каталог магазина. Также обновлять данные о товарах становится гораздо легче.
-
Для динамической рекламы и смарт-баннеров.
При помощи фидов можно настроить рекламные кампании максимально точно, это дает возможность не сливать бюджеты на продвижение. К примеру, можно заказать баннеры, которые покажут только аудитории, интересующейся данным типом товара.
-
Для контекстной и товарной рекламы.
Данный метод подходит под указанные виды рекламы, потому что информация о них циркулирует в системах «Яндекса». Это могут быть данные о ценах, описания, информация о параметрах и других показателях. Все это учитывается при настройке показов рекламы.
Элементы YML-файла
YML-файл можно создать из следующих элементов:
-
заголовок;
-
<yml_catalog>;
-
<shop>;
-
<categories>;
-
<offers>.
Что-то нужно заполнить в обязательном порядке, где-то можно пропустить. Все зависит от вашей платформы. Лучше всего уточнить информацию об элементах в справочнике «Яндекса».
Все данные о магазине хранятся в разделе с тегами <shop> и </shop>. Здесь указана информация: название фирмы, ссылка на интернет-магазин, валюта для оплаты, типы товаров, доставка.
Все товары магазина помещают в теги <offers> и </offers>. «Яндекс», ориентируясь на них, определяет тип карточки. Здесь нужно указать стоимость, размер скидок, наличие и ссылку на фото.
Источник: shutterstock.com
Когда нужно указать дополнительную информацию, то подключают такие теги: <gifts> для подарков, <promos> для промоакций, <adult> для товаров для взрослых. Пример файла YML доступен к скачиванию в «Яндекс.Справке».
Как выглядит этот документ? По структуре он напоминает HTML. Если вы разбираетесь в этой верстке, то сложностей с новым методом быть не должно.
Основные правила работы синтаксиса:
-
Во всем должен быть порядок. Тег открывается внутри другого, его нужно закрыть. К примеру: <offer> <name> </name> </offer>.
-
Теги закрывающего типа совпадают с теми, что открывают. К примеру, <Name> и </name> являются разными тегами.
-
Запрещено в начале написать </offer>, а затем </name>. Для добавления значения используйте кавычки: id="5".
-
Чтобы оставлять возможность для комментариев, пользуйтесь утвержденной последовательностью символов. Начать нужно с "<!-", затем вписывают комментарий, а заканчивают "->".
-
Для добавления специальных символов, к примеру, апострофа, воспользуйтесь служебными элементами.
Читайте также!
Как создать YML-файл
Такой файл создать непросто. Рассмотрим понятные схемы, примеры, как создать YML-файл.
-
При помощи CMS.
Данный метод подойдет тем, у кого много товаров, а описывать каждый отдельно будет недешево. Многие системы работают по одному принципу — они берут информацию о товарах и ценах из интернет-магазина и переводят их в YML-формат.
-
При участии специального софта.
Подойдет тем, у кого много товаров, но не интегрирована система CMS с «Яндекс.Маркетом». Пишите свое программное обеспечение или пользуйтесь готовым:
-
YMLShop.
Данные решения подойдут тем, кто хочет добавить свой ресурс, система произведет индексацию и позволит создать на их основе YML-файл онлайн.
Эту программу делали разработчики на стороне, поэтому учитывайте правила безопасности при работе.
Как сделать YML-файл вручную
Бывает, что в магазине огромное количество товарных позиций. Описать каждую — потратить массу денег и времени. Для самостоятельной работы зайдите в личный кабинет «Яндекс.Маркета» и найдите «Товары». Затем перейдите в «Ассортимент магазина» и кликните на «Справка». Потом найдите «Файлы с каталогом» и выберите формат YML, нажмите «Скачать шаблон».
Источник: shutterstock.com
Теперь поработайте над некоторыми разделами в ручном режиме:
-
<yml_catalog>
В начале нужно ввести заголовок, где описывается код. Он всегда имеет одинаковую структуру, можно оставить общепринятый. Затем опишите корневой элемент. Туда вставляют каталог с атрибутом даты: актуальные на момент заполнения время и число.
-
<shop>
Найдите элемент <catalog> и вложите в него <shop> без атрибутов. Там будут добавлены несколько элементов. Если в шаблоне информация выделена черным, ее нужно заполнить, туда вставляют актуальные данные о товарах и магазине. <shop> в YML-файле только в единственном экземпляре.
-
<categories>
Его тоже необходимо вложить в <shop>. Под категориями понимают виды товаров. К примеру, вы продаете шубы, то это будут категории: верхняя одежда, женская одежда. Для каждой категории нужно придумать порядковый номер или свой идентификатор. Записывать их следует через атрибут id. Когда одна категория вложена в другую, использовать атрибут parentid. К примеру, «верхняя одежда» и «женская одежда».
-
<offers>
Элемент, который необходимо вложить в <shop>. Здесь следует описать товары, которыми вы торгуете, указать цены. На каждый элемент добавляют один товар. Заполнить следует все параметры, от названия до описания и производителя.
Не забывайте об атрибуте id, он состоит из SKU — туда входит идентификатор товара в «Яндекс.Маркете». У каждого товара он свой. Его придумывают заранее, но некоторые прописывают его и во время заполнения YML. Выбирайте в качестве SKU артикулы товаров.
Источник: shutterstock.com
Имеются четкие требования: не более 80 символов, английские и русские буквы без е, цифры, символы: . , \ ? ( ) [ ] - =.
-
<delivery> и <pickup>
Здесь вы прописываете условия доставки или самовывоза. Если ваш магазин не предусматривает доставку товара, то пропишите: <delivery>false</delivery>. Если работаете без самовывоза, нужно указать: <pickup>false</pickup>.
Когда добавляете товары, то в середину добавьте «true», а затем заполняйте файл. У <delivery> и <pickup> имеются вложенные элементы — <delivery-options> и <pickup-options>.
-
<delivery-options>
Данный элемент тоже хранится в <shop>. Это позволит описать все способы доставки ваших товаров. Некоторые добавляют его в <offers> — это позволяет указать специальные типы доставок для определенных товаров.
Элемент <delivery-options> имеет вложенный элемент <option>. У него есть три атрибута:
-
days — срок доставки в днях. Укажите число дней или интервал, если не можете определиться, ничего не вводите.
-
cost — атрибут для технической проверки. Укажите любую стоимость.
-
order-before — укажите, до скольки допустимо оформление доставки выбранным способов. Обычно срок считают с дня заказа. Введите число от 0 до 24. Необязательно заполнять.
-
<pickup-options>
Данный элемент позволяет прописать варианты для самовывоза. Лучше вложить в <shop>, и в <offers>. Первый вариант для самовывоза по умолчанию, второй — при определенных условиях.
Работает по схеме <delivery-options>, где имеется вложенный элемент <option>. Тот, в свою очередь, имеет три атрибута: cost, days и order-before. Все они функционируют по схеме, описанной ранее.
Когда вы подготовите ваш YML-файл сайта, можете смело его протестировать.
Проверка YML-файла
Вам нужно проверить YML-файл на корректность работы, это необходимо, чтобы определить и устранить возможные ошибки. Они часто сбивают систему и приводят к оплошностям. Разберем, какие ошибки встречаются наиболее часто, как их заметить.
Обычно работники сферы интернет-торговли совершают такие промахи:
-
неправильный синтаксис: пропуски букв, символов, неправильно сделанные отступы;
-
неверно определенные типы данных: присваивание строке значения, которое является числом;
-
опечатки, допущенные в ключах: написали слово с ошибкой или использовали слово, которое уже используется в другом значении.
Чтобы обнаружить ошибки, поместите файл в тестовый редактор, посмотрите на строки. Лучше прибегать к сервисам в интернете, которые специализируются на проверке YML-файлов. Они быстро выявляют баги, которые глаз может пропустить.
Документ на корректность проверит валидатор «Яндекс.Вебмастера». Для этого укажите источник фида и запустите проверку. Если ошибки есть, то их вам покажут. Исправьте неточности и запустите проверку по новой.
Источник: shutterstock.com
Как устранить ошибки:
-
Зайдите в текстовый редактор, откройте свой фид, обратите внимание на структуру, закройте теги, они должны соответствовать спецификации, в них должны быть прописаны данные.
-
Включите автоматическую проверку при участии валидатора. Программа пройдется по данным и покажет, где нужно внести корректировки.
-
Обратите внимание на ошибки в тегах, уберите опечатки, добавьте уникальные идентификаторы, соблюдайте порядок.
-
Уберите неправильные URL: ссылки с пробелами, кириллицей.
-
Проверьте кодировку файла. Лучше применять UTF-8. Допустим и «windows-1251», если она верно указана в XML-заголовке.
-
Проверьте, что в тегах <picture> указаны ссылки, которые ведут на открывающиеся картинки, которые доступны по HTTP/HTTPS. В ссылке не должно быть пробелов и неэкранированных символов. Проведите кодирование по RFC 3986 (по необходимости).
Увеличим продажи вашего бизнеса с помощью комплексного продвижения сайта. Наша команда экспертов разработает для вас индивидуальную стратегию, которая позволит в разы увеличить трафик, количество заявок и лидов, снизить стоимость привлечения клиентов и создать стабильный поток новых покупателей.
Как загрузить YML-файл в Яндекс.Маркет
Выделяют два способа, позволяющих загрузить и запустить YML-файл. Выбор метода зависит от частоты обновления каталога.
-
Файл.
Его используют менеджеры магазинов, которые не часто обновляют ассортимент. К примеру, при внесении изменений они заново загружают файл.
Чтобы совершить это действие, пройдите такой алгоритм: «Товары» → «Каталог» → «Загрузить файл». Затем выберите YML-файл на своем устройстве. Он не должен превышать сто мегабайт, иначе придется дробить файлы.
Когда выгрузите товары на «Я.Маркет», выбирайте атрибуты: вес, срок годности, скидки, распродажа. Их покажут в карточке товара.
-
Ссылка.
Этот метод подходит продавцам, которые регулярно добавляют новые категории товаров. Файл они могут сохранить в «облаке», открыв к нему доступ по ссылке. Автоматическая система «Яндекс.Маркета» каждые полчаса будет проверять обновления файла и добавлять новую информацию, это позволит избежать внесения изменений в ручном режиме. Для настройки автоматического обновления следуйте алгоритму: «Товары» → «Автообновление каталога» → «Добавить ссылку на файл».
Каждый каталог нужно загрузить отдельно. Выберите «Товары» в окошке «Что передаем», остальную информацию, например, наличие, цены, придется разместить под отдельной ссылкой.
Как загружать YML-файл на сайт
Чтобы добавить YML-файлы на сайт, нужно выбрать инструмент передачи информации, его можно создать при помощи инструмента импорта данных, который может быть реализован через:
-
Встроенные функции CMS или конструктора.
-
Дополнительные модули и плагины (бесплатные или платные).
-
Личные скрипты на сервере.
Рассмотрим некоторые способы подробнее.
Использование встроенных функций CMS
Некоторые популярные движки сайтов позволяют импортировать товары через YML-файлы.
Если в системе нет встроенного импортера, то воспользуйтесь плагином или модулем выделяют такие популярные виды:
-
Для WooCommerce: «YML Import for WooCommerce».
-
Для CS-Cart: «Импорт товаров из YML».
-
Для OpenCart: «YML Import PRO», «Simple YML Import».
-
Для PrestaShop: «YML Product Import».
Обычно платные версии позволяют настроить файлы под свои нужды, в том числе загружать сложные YML-файлы товаров. В бесплатных версиях функционал обычно строго ограничен, в нем нет фильтрации товаров и обновления остатков.
Источник: shutterstock.com
Плюсы при использовании модулей:
-
Автоматическое соединение с поставщиками.
-
Обновление цен, наличия и характеристик автоматически.
-
Настройка фильтров товаров перед импортом.
Создание своих скриптов и API для импорта
При нехватке своих решений, когда нужно работать с большими объемами данных, пишут скрипты, например, на «Python» или другом языке программирования.
Обновление YML-файла
Чтобы обновить данные, нужно обязательно учитывать, что в магазине всегда указана актуальная информация:
-
стоимость;
-
наличии товара на складе;
-
условия оплаты и доставки.
Когда вы разместили прайс-лист в «Яндекс. Маркете», то регулярно обновляйте его, лучше раз в месяц, если же вы загрузили YML-файл на сайт, то обновление настройте на каждое изменение по ключевым данным: цене, числу товаров. Робот «Яндекса» сам будет скачивать новый файл и подгружать его.
Он индексирует данные каждые 3-6 часов. За это время все карточки товаров полностью обновляются. Цены и скидки подгружаются каждые полчаса. Лучше настроить автоматическое обновление для файла на сайте. Тогда в «Маркете» всегда будут актуальные цены и товары.
Источник изображения на шапке: shutterstock.com
Часто задаваемые вопросы об YML-файле
Рекомендуется ли создавать сразу несколько YML-файлов?
Данный вариант нужен, когда в магазине много товаров, а робот «Яндекса» быстрее рассмотрит сразу несколько файлов, чем один объемный. Когда интернет-магазин включает широкую линейку товаров разных категорий, работать с ними будет удобнее. В одном файле лучше описать одну категорию, а в других – остальные.
Какая кодировка используется для YML-файла в Маркете?
Исключительно UTF-8 без BOM.Что такое bid и cbid в YML? Выделяют такие разновидности ставок: bid — ставка за клик (типичное продвижение); cbid — ставка за клик для товаров в категории «Товары на Маркете» (CPC).
Допустимо ли задействовать HTML при описании товара (<description>)?
Для этого рекомендуется добавлять базовые теги: <br>, <ul>, <li>, <b>, <p>. Не добавляйте скрипты и сложную верстку. «Яндекс.Маркет» убирает их или не воспринимает.
Сколько товаров необходимо добавить в один YML?
Принято ограничение – вы можете добавить до миллиона товаров. Хотя рекомендуется не включать более 300 тысяч. Файл не должен превышать 150-200 мегабайт. Лучше делать меньше.
Как сжать YML для загрузки?
Данный файл можно сжимать при помощи форматов «Зип». Принимаются файлы с расширением: .yml, .yaml, .xml, .zip, .gz. Важно добавить в архив файл с расширением .yml.
Много ли раз надо обновлять YML-файл на сервере?
Лучше делать это раз в сутки. Если у вас большой магазин с богатым ассортиментом, то обновление стоит делать 1-6 раз в день. По ссылке обновления YML-файл «Маркет» проверяет автоматически.