Генерация фида товаров для Яндекс.Маркет (YML)
Отметим: когда фид блокируется из-за неверного тега oldprice, кампания теряет до 70% трафика за сутки. Эту ситуацию мы наблюдали у клиента с каталогом на 15 000 позиций: Яндекс вернул ошибку «цена на сайте отличается от фида более чем на 1%» для половины офферов. Причина — несинхронизированное обновление цен в CRM и фиде. YML (Yandex Market Language) — строгий XML-диалект, и каждая ошибка останавливает всю кампанию.
Почему фид блокируют даже из-за одной ошибки?
Яндекс сверяет каждую позицию: цену на сайте и в фиде, доступность изображения, длину описания. Ошибка в одном оффере — и вся кампания останавливается. Например, разница в цене более 1% — товар не попадает в индекс. Или изображение не открывается — оффер исключается.
Как часто нужно обновлять фид?
Минимальная периодичность — раз в 24 часа, но мы рекомендуем обновлять раз в час, если цены меняются часто. Для оперативного изменения цен подключают Price API, который обновляет только цены и остатки без полной перегенерации. YML-фид проще в настройке, но менее гибкий.
Форматы передачи данных в Яндекс.Маркет
Яндекс поддерживает два способа:
- YML-фид — файл по URL, который Яндекс скачивает по расписанию (минимум раз в 24 ч, максимум раз в час)
- Price API — программный интерфейс для обновления только цен и наличия без полной перегенерации фида
Для большинства магазинов достаточно YML-фида. Price API подключается дополнительно, если цены меняются несколько раз в сутки.
Сравнение YML и Price API
| Характеристика | YML-фид | Price API |
|---|---|---|
| Частота обновления | 1–24 ч | Мгновенно |
| Объём данных | Весь каталог | Только цены/остатки |
| Сложность настройки | Низкая | Средняя |
| Риск ошибок | Выше (валидация всего фида) | Ниже (только отдельные поля) |
Структура 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> Специфика типов оферов
Яндекс различает несколько типов товарных предложений:
| Тип | Когда использовать | Ключевые доп. поля |
|---|---|---|
vendor.model |
электроника, бытовая техника | typePrefix, vendor, model |
book |
книги | author, publisher, ISBN, year |
audiobook |
аудиокниги | author, publisher, performed-by |
artist.title |
музыка, видео, игры | artist, title, year, media |
tour |
туры | worldRegion, hotel-stars, room, dataTour |
event-ticket |
билеты | place, hall, date, is-premiere |
| простой | всё остальное | только базовые поля |
Как автоматизировать генерацию фида?
Используем 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 рабочих дней. Закажите бесплатную консультацию — мы оценим ваш проект и дадим точный план.