Генерация фида товаров для Яндекс.Маркет (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 рабочих дней. Закажите бесплатную консультацию — мы оценим ваш проект и дадим точный план.