Генерация фида товаров для Яндекс.Маркет (YML)

Генерация фида товаров для Яндекс.Маркет (YML)

Отметим: когда фид блокируется из-за неверного тега oldprice, кампания теряет до 70% трафика за сутки. Эту ситуацию мы наблюдали у клиента с каталогом на 15 000 позиций: Яндекс вернул ошибку «цена на сайте отличается от фида более чем на 1%» для половины офферов. Причина — несинхронизированное обновление цен в CRM и фиде. YML (Yandex Market Language) — строгий XML-диалект, и каждая ошибка останавливает всю кампанию.

Почему фид блокируют даже из-за одной ошибки?

Яндекс сверяет каждую позицию: цену на сайте и в фиде, доступность изображения, длину описания. Ошибка в одном оффере — и вся кампания останавливается. Например, разница в цене более 1% — товар не попадает в индекс. Или изображение не открывается — оффер исключается.

Как часто нужно обновлять фид?

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

Форматы передачи данных в Яндекс.Маркет

Яндекс поддерживает два способа:

1. YML-фид — файл по URL, который Яндекс скачивает по расписанию (минимум раз в 24 ч, максимум раз в час)
2. Price API — программный интерфейс для обновления только цен и наличия без полной перегенерации фида

Для большинства магазинов достаточно YML-фида. Price API подключается дополнительно, если цены меняются несколько раз в сутки.

Сравнение YML и Price API

Структура YML-документа

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2024-01-01 14:00">
  <shop>
    <name>Название магазина</name>
    <company>ООО Компания</company>
    <url>https://example.com</url>
    <currencies>
      <currency id="RUR" rate="1"/>
    </currencies>
    <categories>
      <category id="10">Смартфоны</category>
      <category id="11" parentId="10">Apple iPhone</category>
    </categories>
    <delivery-options>
      <option cost="299" days="1"/>
    </delivery-options>
    <offers>
      <offer id="12345" available="true">
        <url>https://example.com/products/iphone-15</url>
        <price>89990</price>
        <oldprice>99990</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>11</categoryId>
        <picture>https://cdn.example.com/iphone-15-1.jpg</picture>
        <picture>https://cdn.example.com/iphone-15-2.jpg</picture>
        <name>Смартфон Apple iPhone 15 128GB черный</name>
        <vendor>Apple</vendor>
        <vendorCode>MTP03LL/A</vendorCode>
        <barcode>0194253401353</barcode>
        <description>Смартфон Apple iPhone 15 с процессором A16...</description>
        <param name="Цвет">Чёрный</param>
        <param name="Встроенная память" unit="ГБ">128</param>
        <param name="Операционная система">iOS</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Специфика типов оферов

Яндекс различает несколько типов товарных предложений:

Как автоматизировать генерацию фида?

Используем PHP с XMLWriter — он пишет напрямую в файл, не держит весь XML в памяти. Это критично для каталогов на 100 000+ товаров.

class YandexMarketFeedGenerator
{
    public function handle(): void
    {
        $path = storage_path('app/public/feeds/yandex.xml');
        $writer = new \XMLWriter();
        $writer->openUri($path);
        $writer->setIndent(true);
        $writer->startDocument('1.0', 'UTF-8');
        $writer->writeDtd('yml_catalog', null, 'shops.dtd');
        $writer->startElement('yml_catalog');
        $writer->writeAttribute('date', now()->format('Y-m-d H:i'));
        $this->writeShopHeader($writer);
        $this->writeCurrencies($writer);
        $this->writeCategories($writer);
        $this->writeOffers($writer);
        $writer->endElement();
        $writer->endDocument();
        $writer->flush();
    }

    private function writeOffers(\XMLWriter $w): void
    {
        $w->startElement('offers');
        Product::with(['category', 'brand', 'images', 'attributes'])
            ->where('is_active', true)
            ->chunk(500, function ($products) use ($w) {
                foreach ($products as $p) {
                    $w->startElement('offer');
                    $w->writeAttribute('id', $p->sku);
                    $w->writeAttribute('available', $p->stock > 0 ? 'true' : 'false');
                    $w->writeElement('url', route('products.show', $p->slug));
                    $w->writeElement('price', (string) $p->price);
                    if ($p->compare_price > $p->price) {
                        $w->writeElement('oldprice', (string) $p->compare_price);
                    }
                    $w->writeElement('currencyId', 'RUR');
                    $w->writeElement('categoryId', $p->category_id);
                    $w->writeElement('name', $p->name);
                    $w->writeElement('vendor', $p->brand?->name ?? '');
                    $w->writeElement('barcode', $p->barcode ?? '');
                    foreach ($p->images as $img) {
                        $w->writeElement('picture', $img->cdn_url);
                    }
                    foreach ($p->attributes as $attr) {
                        $w->startElement('param');
                        $w->writeAttribute('name', $attr->name);
                        if ($attr->unit) {
                            $w->writeAttribute('unit', $attr->unit);
                        }
                        $w->text($attr->value);
                        $w->endElement();
                    }
                    $w->endElement();
                }
            });
        $w->endElement();
    }
}

В реальном проекте мы столкнулись с каталогом на 200 000 товаров, где предыдущий генератор использовал DOMDocument и ел по 2 ГБ оперативки. Переход на XMLWriter снизил потребление до 100 МБ и ускорил генерацию с 40 минут до 5.

Настройка обновления

Фид обновляется через Laravel Scheduler:

// app/Console/Kernel.php $schedule->job(GenerateYandexFeedJob::class)->hourly()->withoutOverlapping(); 

Файл фида отдаётся через выделенный роут или напрямую из public/feeds/. Если каталог превышает 500 МБ в XML, Яндекс рекомендует дробить фид на несколько файлов и регистрировать каждый отдельно в кабинете.

Что входит в работу по настройке фида?

Мы предоставляем:

• Аудит текущего фида: проверка валидации, поиск ошибок типов полей, оптимизация размера.
• Разработка генератора под ваш стек (Laravel, Symfony, WordPress, DRF).
• Интеграция с системой управления товарами (ERP, CRM).
• Тестирование на полном каталоге и запуск в песочнице Яндекса.
• Документация по поддержке и обучение ваших разработчиков.
• Мониторинг ошибок и уведомления при блокировке.

За 5 лет мы настроили более 50 фидов для Яндекс.Маркета, и каждый прошёл валидацию с первого раза. Свяжитесь с нами, чтобы проверить ваш фид.

Диагностика ошибок

Яндекс.Маркет возвращает детальный отчёт по каждому офферу. Наиболее распространённые проблемы:

• Цена равна нулю или отсутствует — товар исключается из индекса автоматически.
• Несоответствие цены на сайте — Яндекс сверяет цену в фиде с ценой на странице товара. Разница более 1% блокирует оффер.
• Изображение недоступно — проверяется при первичной загрузке и повторно при каждом обходе.
• Слишком длинное описание — допустимо 3000 символов для большинства категорий.

В одном проекте мы обнаружили, что 80% ошибок вызваны отсутствием barcode для категории «Бытовая химия». Добавили заполнение этого поля в ERP — ошибки исчезли.

«После настройки фида количество исключённых товаров снизилось с 2000 до 0 за первую неделю», — владелец интернет-магазина.

Сроки

Базовый генератор для стандартного каталога — 2–4 рабочих дня. Сложные категории (одежда с размерной сеткой, электроника с расширенными атрибутами) — 4–6 рабочих дней. Закажите консультацию — мы оценим ваш проект и дадим точный план.