Настройка плагина YML for Yandex Market

Эта инструкция даст ответы на вопросы: "Что такое YML фид?", "Как создать YML фид в WooCommerce?".

Что такое YML фид?

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

Этот формат позволяет эффективно управлять товарными предложениями, синхронизировать данные в реальном времени и использовать каталог для рекламных кампаний в Яндекс.Директ, а также для работы с поставщиками.

Основные функции плагина YML for Yandex Market (Y4YM)

Плагин YML for Yandex Market автоматизирует процесс создания и обновления YML фида для вашего интернет-магазина на WooCommerce.

Требования

Для успешной работы плагина YML for Yandex Market необходимо выполнение следующих условий:

  • Версия WordPress: Плагин разработан для работы с WordPress версии 5.9 и выше.
  • Версия WooCommerce: Плагин совместим с WooCommerce версии 3.0.0 и выше. Рекомендуемая версия WooCommerce — 9.3 и выше.
  • Версия PHP: Минимальная поддерживаемая версия PHP — 7.4. Рекомендуется использовать PHP версии 8.3 и выше для оптимальной производительности и безопасности.
  • Функционирующий WP_CRON: Минимальный интервал срабатывания CRON должен составлять не менее 1-го раза в 2 минуты. Если вы отключили WP_CRON в пользу серверного, то обязательно следуйте рекомендациями из этой статьи.

Установка и активация плагина YML for Yandex Market

Самый простой способ установить плагин — через админку вашего сайта. Откройте раздел "Плагины", выберите "Добавить плагин". В строке поиска введите "YML" и нажмите "Установить сейчас" напротив плагина YML for Yandex Market.

Установка YML for Yandex Market

После установки активируйте, нажав кнопку "Активировать плагин".

Альтернативные способы установки Y4YM

Скачайте из репозитория WordPress архив с плагином (для скачивания перейдите по ссылке https://ru.wordpress.org/plugins/yml-for-yandex-market/). Далее возможны варианты:

Вариант 1: Установка архива плагина через админ-панель WordPress
  • Зайдите в админку WordPress под учетной записью администратора.
  • Перейдите в раздел "Плагины" - "Добавить новый".
  • Нажмите на кнопку "Загрузить плагин".
  • Выберите загруженный архив с плагином и нажмите "Установить".
  • После завершения установки нажмите "Активировать плагин".
Вариант 2: Установка через FTP
  • Распакуйте архив с плагином на своём компьютере.
  • Подключитесь к серверу вашего сайта через FTP-клиент (например, FileZilla).
  • Загрузите распакованную папку с плагином в директорию /wp-content/plugins/ вашего сайта.
  • Перейдите в административную панель WordPress, откройте раздел "Плагины" и найдите плагин YML for Yandex Market.
  • Нажмите "Активировать" для включения плагина.

Настройка плагина (создание YML фида)

Приступаем к настройке плагина. Первое, что необходимо сделать после установки - нажать в боковом меню на пункт "Y4YM" и далее на кнопку "Добавить новый фид".

Добавить новый YML фид

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

Вкладка "Основные настройки" отвечает за общие настройки генерации фида.

Вкладка "<shop>...элементы между...<offers>" отвечает за то, какие элементы (теги) будут включены в разделы <shop> и <offers>.

Вкладка "<offer>...элементы между...</offer>" отвечает за то, какие элементы (теги) будут отображаться между открывающим и закрывающим тегами <offer>. По факту, всё что между одной парой тегов <offer> и </offer> - это параметры одного конкретного товара (или одной вариации товара). Соответственно, в вашем фиде будет много таких пар.

Вкладка "Фильтрация" позволяет дополнительно отфильтровать товары по тем или иным параметрам. В бесплатной версии плагина данная вкладка содержит лишь несколько фильтров. В про-версии настроек значительно больше.

Теперь разберём каждую вкладку более подробно.

Вкладка "Основные настройки"

Создание фида  — секция настроек задаёт интервал обновления вашего фида. Если вы выберете "Создать фид один раз и НЕ обновлять его" после создания фида значение параметра изменится на "Отключить создание и обновление этого фида".

Также в данной секции можно указать время, в которое должна начаться генерация фида.

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

  • Какие элементы будут включены в разделы между тегами <shop> и <offers>
  • Какие параметры товара будут отображаться в теге <offer>
  • Общая структура формируемого фида

Особенности работы с правилами

Формат YML имеет различные спецификации для разных площадок, которые могут существенно отличаться. Важно учитывать:

  • Специфичность требований: каждая площадка (Яндекс.Маркет, Яндекс.Директ, другие маркетплейсы) имеет свои правила формирования фида
  • Совместимость: использование фида, созданного по правилам одной площадки, для другой может привести к ошибкам валидации
  • Автоматизация настроек: плагин автоматически определяет необходимые параметры на основе выбранного набора правил

Механизм работы

При выборе правил плагин:

  • Активирует соответствующие настройки во вкладках "<shop>...элементы между...<offers>" и "<offer>...элементы между...</offer>" скрывает из списка те, которые не соответсвуют конкретному правилу
  • При генерации фида проверяет обязательные элементы для выбранной площадки. Исключает товары, не соответствующие минимальным требованиям (товары, у которых отсутствуют обязательные элементы)
  • Формирует корректный YML-файл

Рекомендации по использованию

  • Для работы с конкретными маркетплейсами выбирайте соответствующий пункт в списке
  • Для нестандартных ситуаций выберите пункт "Нет правил". Эта опция позволяет показать абсолютно все настройки.
  • Убедитесь, что все обязательные поля заполнены для выбранного набора правил

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

Совет: Быстро узнать причину по которой тот или иной товар был исключен из фида можно при помощи симуляции запроса.

Назначение фида — Опция не влияет на формирование фида. То, что вы введёте в этом поле будет выводится рядом с его названием в админке сайта.

Имя файла фида  — эта секция состоит из двух настроек.

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

Выпадающий список служит для указания расширения файла. Если создаёте фид для Яндекс Вебмастера, то обязательно выбирайте XML. В остальных случаях, по большому счёту, без разницы. Лично я использую XML.

Важно помнить: YML-формат определяется содержанием файла, а не его расширением. Даже если файл называется feed.xml, но внутри присутствуют теги YML, он считается YML-файлом, а не XML.

Архивировать в ZIP — это параметр, который позволяет управлять процессом архивации файла фида после его создания. При активации этой опции фид автоматически упаковывается в ZIP-архив. При отключении опции файл фида сохраняется в исходном XML/YML-формате.

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

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

Максимальное время выполнения скрипта — параметр, определяющий, сколько секунд беспрерывно может выполняться скрипт при создании фида.

  • Значение по умолчанию: 26 секунд
  • При возникновении зависания во время создания фида рекомендуется:
    • Увеличить параметр на 10–30 единиц
    • Например, установить значение 36–56 секунд

Важно учитывать:

  • Увеличение времени выполнения может потребоваться при работе с большими объёмами данных
  • Чрезмерное увеличение параметра может привести к перегрузке системы
  • Настройка помогает избежать ошибок при генерации фида из-за превышения времени выполнения скрипта, разрешенного вашим сервером

При настройке данного параметра следует найти оптимальное значение, при котором:

  • Система работает стабильно
  • Процесс генерации фида завершается успешно
  • Не возникает ошибок выполнения скрипта

Игнорировать кэш плагина — настройка, которая позволяет управлять использованием кэша при работе с фидом.

Когда использовать:

  • Если после обновления фида цены, а также другие данные в нём остаются неизменными
  • В случаях, когда на сайте используются "тихие правки". Т.е, когда другой скрипт или плагин на вашем сайте напрямую работает с базой данных в обход штатных функций WordPress и WooCommerce

Важно помнить:

  • Изменение этой настройки может существенно повлиять на производительность системы
  • Рекомендуется использовать только при возникновении проблем с обновлением цен
  • Подробные инструкции по работе с этой опцией доступна по ссылке

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

Влияние на производительность:

  • При включенном кэшировании:
    • Фид создаётся быстрее
    • Уменьшается нагрузка на базу данных сервера
    • Замедляется процесс сохранения товаров
  • При отключенном кэшировании:
    • Фид создаётся значительно медленнее
    • Возрастает нагрузка на базу данных

Рекомендации по использованию:

  • Рекомендуется оставлять опцию включенной для оптимальной работы сайта
  • Учитывать, что отключение может существенно повлиять на производительность

Управление элементами фида

Основные характеристики настроек:

  • Настройки управляют тегами (элементами) и их содержимым в XML-фиде
  • Конфигурация влияет на структуру и наполнение генерируемого файла

Структура вкладки:

  • Организована в виде раскрывающихся блоков
  • Каждый блок имеет:
    • Человеко-понятное название
    • Указание основного тега, за который отвечает блок

Типы элементов управления внутри блоков:

  • Текстовые поля для ввода строковых значений
  • Числовые поля для ввода количественных параметров
  • Выпадающие списки (селекты) для выбора одного значения
  • Мультиселекты для выбора нескольких значений одновременно

Особенности работы с настройками:

  • Возможность детальной настройки каждого элемента фида
  • Гибкая конфигурация структуры XML-документа
  • Точный контроль над содержимым генерируемого файла

Рекомендации по использованию:

  • Внимательно проверяйте настройки каждого блока
  • Учитывайте взаимосвязь между различными элементами
  • Сохраняйте изменения после настройки каждого параметра
  • Проверяйте результат через инструменты симуляции

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

Вкладка "<shop>...элементы между...<offers>"

Настройки этой и следующей вкладки управляют тегами (элементами) и их содержимым в фиде. Вкладка состоит из раскрывающихся блоков в шапке которых указано человеко-понятное название блока, а также основной тег, за который он отвечает. На всех блоках останавливаться не будем, остановимся лишь на некоторые.

Название магазина — краткое название магазина, должно содержать не более 20 символов.

Наименование компании — полное наименование компании, владеющей магазином.

Валюты магазина — отвечает за передачу информации о списке валют.

Вкладка "<offer>...элементы между...</offer>"

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

Производитель — по заголовку блока ("Производитель <vendor>") становится ясно, что этот блок отвечает за добавление в фид тега vendor, который в свою очередь отвечает за передачу информации о производителе/бренде товара. Содержимое блока состоит из выпадающего списка и поля для ввода текста. Рассмотрим выпадающий список. Его содержимое состоит и заранее заданных плагином значений, а также всех глобальных атрибутов на вашем сайте.

Если выбрать "Отключено", то в фиде не будет тега <vendor> совсем.

Если выбрать "Бренды WooCommerce", то плагин создаст между тегами <offer> и </offer> тег <vendor> со значением бренда из стандартного поля WooCommerce (если, конечно, оно у товара заполнено, а если нет, то тега vendor у конкретного товара НЕ будет).

Стандартное поле брендов для WooCommerce

Если выбрать "Подставлять из метаполя", то необходимо будет обязательно заполнить текстовое поле "Значение по умолчанию / Имя метаполя", указав в нем имя метаполя (другое название: "Произвольное поле"). То самое, которое используется при работе функции get_post_meta().

подстановка значения из метаполя

Если выбрать Значение из поля "Значение по умолчанию", то необходимо будет обязательно заполнить текстовое поле "Значение по умолчанию / Имя метаполя", указав в нем название бренда. Этот бренд будет добавлен во все карточки товара.

настройка тега vendor для фида

Если выбрать любой из атрибутов в списке, то плагин будет действовать следующим образом:
Если у товара есть глобальный атрибут, то плагин возьмёт его значение, подставит в тег <vendor>, а если такого атрибута нет, то пропустит добавление данного тега для конкретного товара.

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

Вкладка "Фильтрация"

Что экспортировать — параметр в виде выпадающего списка, который определяет типы товаров для экспорта.

Доступные значения:

  • Обычные товары — экспортируются только простые товары без вариаций
  • Вариативные товары — экспортируются только товары с различными вариациями
  • Вариативные и обычные товары — экспортируются все типы товаров

В PRO-версии дополнительно доступен:

  • Только выбранные товары — позволяет экспортировать только те товары, которые были предварительно отмечены пользователем

Важно учитывать:

  • Выбор значения зависит от конкретных задач экспорта
  • Разные типы товаров требуют разного подхода к обработке данных
  • PRO-версия предоставляет расширенные возможности фильтрации товаров при экспорте

Категории вариативных товаров для которых запрещен group_id — Еще один параметр, о котором стоит рассказать чуточку больше. Работает только для вариативных товаров и только в паре с "Подставлять в название след атрибуты" и "Варианты разделителя". В некоторых моделях сотрудничества с Яндекс Маркете только товары, относящиеся к категориям: "Одежда, обувь и аксессуары", "Мебель", "Косметика, парфюмерия и уход", "Детские товары", "Аксессуары для портативной электроники" могут быть вариативными. В YML-фиде такие товар объединяются атрибутом group_id. Но как быть тем, кто, например, продает бытовую технику разных цветов? Если объединить такие товары при помощи group_id - Маркет выдаст ошибку. В таких случаях плагин YML for Yandex Market поступает следующим образом: Он выгружает в фид вариацию так, как будто бы это независимый товар. Однако, по правилам Маркета нельзя, чтобы названия у товаров совпадали. На помощь приходит "Подставлять в название след атрибуты". Зажимаем ctrl и отмечаем те атрибуты, которые будут добавлены в названия вариций и позволят уникализировать заголовки.

Запрещён group_id

Варианты разделителя. Нужен для того, чтобы выбрать необходимый формат подстановки атрибутов в название. Например Тип_1 (В1:З1, В2:З2, ... Вn:Зn) означает, что названия будут такими:

Гироскутер (цвет: красный, производитель: китай)

(т.е в скобках, после названия вариации двоеточие, после значения вариации - запятая)

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

Рейтинг: 4.63

2025-09-01 / / 75 комментариев / YML for Yandex Market / , , , ,