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

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

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

Чому товари блокуються на Яндекс.Маркеті?

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

Яндекс.Маркет повертає детальний звіт по кожному оферу. Найпоширеніші проблеми пов'язані з ціною: якщо вона дорівнює нулю або відсутня, товар автоматично виключається з індексу. Також Яндекс звіряє ціну у фіді з ціною на сторінці товару — різниця більш ніж 1% блокує офер. Зображення перевіряються при первинному завантаженні та повторно при кожному обході, тому недоступне зображення — часта причина виключення. Довжина опису не повинна перевищувати 3000 символів для більшості категорій. В одному проєкті ми виявили, що 80% помилок викликані відсутністю barcode для категорії «Побутова хімія». Додали заповнення цього поля в ERP — помилки зникли.

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

Оновлення фіду: YML проти Price API

Мінімальна періодичність оновлення — раз на 24 години, але ми рекомендуємо оновлювати раз на годину, якщо ціни змінюються часто. Для оперативної зміни цін підключають Price API, який оновлює лише ціни та залишки без повної перегенерації. YML-фід простіше в налаштуванні, але менш гнучкий: наприклад, генерація YML для каталогу з 100 000 товарів займає ~5 хвилин, тоді як оновлення через API — менше хвилини, що у 5 разів швидше.

Яндекс підтримує два способи:

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

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

Порівняння YML та Price API

YML-фід значно простіше налаштувати, ніж Price API, але при великих каталогах (понад 100 000 товарів) швидкість генерації YML може бути в 10 разів повільнішою за оновлення через API.

Як автоматизувати генерацію та оновлення фіду?

1. Створіть XML-документ з кореневим елементом yml_catalog і атрибутом date.
2. Додайте блок shop з назвою, компанією, URL, валютами та категоріями.
3. Для кожного товару створіть offer із правильним типом (наприклад, vendor.model для електроніки) та обов'язковими полями.
4. Перевірте валідність через інструмент Яндекс.Маркету або власний валідатор.
5. Налаштуйте автоматичне оновлення за допомогою крону (наприклад, раз на годину).

Використовуємо PHP з XMLWriter — він пише безпосередньо у файл, не тримає весь XML в пам'яті, що забезпечує потоковий запис (streaming) та лінійну складність O(n). Це критично для каталогів на 100 000+ товарів. Для оптимізації продуктивності ми також застосовуємо Eager Loading в ORM та Lazy Collections для обробки даних без завантаження всіх записів одночасно.

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 — тобто у 8 разів швидше.

Фід оновлюється через Laravel Scheduler:

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

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

Який обсяг робіт та терміни?

Ми надаємо:

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

Ключові метрики:

• 5+ років досвіду на ринку
• 50+ успішних проєктів з Яндекс.Маркетом
• 100% фідів пройшли валідацію з першого разу

Базовий генератор для стандартного каталогу — 2–4 робочі дні. Складні категорії (одяг з розмірною сіткою, електроніка з розширеними атрибутами) — 4–6 робочих днів. Вартість налаштування починається від $200, а економія від вчасно виправленого фіду може сягати $1500 на місяць відновленого трафіку. Замовте безкоштовну консультацію — ми оцінимо ваш проєкт і дамо точний план.

Що входить в роботу?

1. Документація — повний опис структури фіду, інструкція з підтримки.
2. Доступи — налаштування доступу до сервера та системи керування товарами.
3. Навчання — двохгодинна онлайн-сесія для ваших розробників.
4. Технічна підтримка — 30 днів безкоштовної підтримки після запуску.
5. Моніторинг — налаштування сповіщень про помилки через Slack або email.
6. Звітність — щотижневий звіт з показниками валідації та кількістю активних оферів.

Розробка інтернет-магазинів

Ми знаємо: інтернет-магазин — це не просто «сайт з кошиком». Це розподілена система управління товарами, інвентарем, замовленнями, платежами, доставкою, поверненнями та комунікацією з клієнтами. Кожен блок має нетривіальну реалізацію, і більшість проблем в e-commerce виникає на стику цих підсистем. Наш досвід — понад 50 реалізованих проектів — показує, що правильна архітектура на старті економить до 40% бюджету на доробках.

Чому продуктивність каталогу деградує при зростанні SKU?

Найчастіша технічна проблема e-commerce — деградація сторінок категорій при збільшенні асортименту. Сторінка працює добре на 500 товарах і починає гальмувати на 10 000. Причини майже завжди одні й ті ж.

N+1 на атрибутах. Завантажуєте список товарів — 50 елементів. Для кожного потрібні категорія, головне фото, ціна з урахуванням знижки, наявність на складі, рейтинг. Без правильного eager loading це 250+ запитів на сторінку. В Laravel вирішується через with(['category', 'mainImage', 'currentPrice', 'stockStatus']) та withAvg('reviews', 'rating'). Але варто з'явитися персональним цінам (b2b) або складським залишкам по регіонах — і одного with() недостатньо. Потрібні Query Object або виділений ReadModel.

Фасетна фільтрація без індексів. Фільтр за кольором + розміром + брендом + діапазоном цін на таблиці в 500 000 записів без складених індексів — це seq scan при кожному запиті. PostgreSQL з правильними індексами тримає фасетну фільтрацію до кількох мільйонів товарів. Для великих каталогів — Elasticsearch або OpenSearch з агрегаціями: вони рахують кількість товарів на фільтр (facet counts) значно швидше.

Пагінація через OFFSET. LIMIT 50 OFFSET 10000 на великій таблиці — погана ідея: PostgreSQL все одно читає перші 10 050 рядків. Keyset pagination (cursor-based) через WHERE id > $last_id ORDER BY id LIMIT 50 працює за постійний час незалежно від сторінки. Як зазначено в документації PostgreSQL, cursor-based pagination гарантує O(log n) при будь-якому зміщенні, що особливо важливо для каталогів із сотнями тисяч товарів.

Конкретний кейс: каталог будівельних матеріалів, 180 000 SKU, фасетна фільтрація по 12 атрибутах. Після переходу з OFFSET-пагінації на курсорну та додавання partial index по (category_id, is_active, price) час відповіді сторінки каталогу знизився з 4,2 с до 280 мс. Економія на серверних ресурсах склала близько 30 000 ₽ на місяць. В іншому проекті (ювелірний маркетплейс) впровадження агрегацій через Elasticsearch скоротило час фільтрації з 8 до 200 мс та заощадило 50 000 ₽ на місяць на інфраструктурі — ще один приклад, як правильна архітектура знижує TCO.

Що таке race condition у кошику та як його уникнути?

Checkout — місце, де гроші або потрапляють на рахунок, або ні. Технічні проблеми тут коштують дорого.

Race condition при резервуванні товару. Два покупці одночасно додають останній екземпляр у кошик і обоє натискають «Оплатити». Без песимістичного блокування або атомарного UPDATE з перевіркою залишку обидва замовлення проходять, інвентар іде в мінус. В PostgreSQL:

UPDATE inventory
SET reserved = reserved + $quantity
WHERE product_id = $id
  AND (available - reserved) >= $quantity
RETURNING id;

Якщо RETURNING повернув 0 рядків — товару немає, показуємо помилку до списання грошей.

Ідемпотентність платіжних вебхуків. payment.succeeded від Stripe або ЮКассы може прийти двічі через мережеві збої або retry-логіку на стороні шлюзу. Без перевірки WHERE NOT EXISTS (SELECT 1 FROM processed_events WHERE event_id = $id) — дублювання замовлення або подвійне зарахування. Webhook idempotency — обов'язковий патерн для будь-якого платіжного інтегратора. Ми включаємо тест на ідемпотентність у стандартний чек-лист кожного проекту.

Checkout у кілька кроків. Multi-step checkout (адреса → доставка → оплата → підтвердження) vs single-page checkout. Дослідження показують, що single-page з прогрес-індикатором конвертує на 15–20% краще на мобільних. Стан між кроками — або localStorage + server-side сесія, або повністю server-side з проміжним збереженням. Ми гарантуємо, що кожне замовлення проходить аудит на ідемпотентність та блокування — це входить у стандартний чек-лист тестування.

Як інтегрувати 1С з інтернет-магазином?

1С — окрема глава. Три поширених способи інтеграції:

1. CommerceML через HTTP — 1С вивантажує XML за розкладом, сайт імпортує. Працює для невеликих каталогів, є затримка синхронізації.
2. REST API / OData від 1С — двостороння синхронізація в реальному часі. Вимагає налаштування на стороні 1С, примхлива до версій конфігурацій.
3. Проміжна шина (RabbitMQ / Kafka) — 1С публікує події, сайт підписується. Найнадійніший підхід для високонавантажених систем, але найдорожчий у розробці.

Служби доставки — СДЕК, Boxberry, Пошта Росії, DHL: всі надають REST API для розрахунку вартості та створення накладних. Агрегатори (Shiptor, Shipnow) дозволяють працювати з кількома службами через єдиний API.

Платіжні шлюзи

Для кожного шлюзу обов'язкова перевірка підпису вебхука — без цього будь-хто може відправити фейковий payment.succeeded.

CMS vs власна розробка

WooCommerce — виправданий для магазинів до ~5 000 SKU з типовою бізнес-логікою. Швидкий старт, величезна екосистема плагінів. Проблеми починаються при нестандартних цінових правилах, складних варіантах товарів або навантаженні від 10 000+ замовлень на місяць. Економія на ліцензії WooCommerce (безкоштовно) обертається витратами на плагіни та хостинг; для каталогу 50 000 SKU місячна вартість підтримки може перевищити 100 000 ₽.

OpenCart, Prestashop — аналогічна історія. Хороші для старту, обмежені при зростанні.

Власна розробка на Laravel — для:

• Нестандартної бізнес-логіки (підписки, оренда, b2b-прайси, конфігуратор);
• Високих вимог до продуктивності;
• Складних інтеграцій (кілька складів, ERP, маркетплейси);
• Унікального UX checkout.

Як ми розробляємо інтернет-магазин: покроковий процес

1. Аналітика та проектування. Збираємо вимоги, уточнюємо бізнес-процеси, моделюємо доменну логіку. На виході — технічне завдання та архітектурна схема.
2. Backend та API. Реалізуємо ядро (товари, кошик, замовлення), інтеграції з 1С/складами/платіжками. Використовуємо Laravel 11 з Repository pattern, чергами для асинхронних операцій.
3. Frontend та checkout. Налаштовуємо React 18 / Next.js 14 з оптимізованим рендерингом (SSR/SSG для каталогу), єдиний single-page checkout.
4. Тестування. Перевіряємо race condition, ідемпотентність вебхуків, навантажувальне тестування (k6), security-аудит.
5. Деплой та моніторинг. Розгортаємо на Vercel / Docker / виділеному сервері, підключаємо Sentry та Uptime.

SEO для e-commerce

Canonical та дублювання. Фасетна фільтрація генерує тисячі URL (?color=red&size=M&sort=price). Без canonical або noindex на фільтрованих сторінках краулінговий бюджет витрачається на дублі, а основні сторінки індексуються гірше.

Structured data. Product schema з offers, aggregateRating, availability — це rich snippets у видачі: зірочки рейтингу, ціна, наявність. Впливає на CTR.

Core Web Vitals на сторінках товарів. Hero image товару — це LCP element. fetchpriority="high" на першому зображенні, правильні srcset з WebP, width та height атрибути для запобігання CLS.

Що входить у результат роботи

Після завершення проекту ви отримуєте:

• Вихідний код та повну документацію (API, архітектура, інфраструктура);
• Доступи до репозиторію, хостингу, моніторингу (Sentry, Uptime);
• Навчання команди роботі з адмін-панеллю та кастомізаціями;
• Гарантійну підтримку 3 місяці (виправлення помилок, консультації);
• Детальний звіт по навантажувальному тестуванню та оптимізації.

Орієнтири за термінами

Вартість розраховується після аналізу вимог: кількість інтеграцій, складність ціноутворення, обсяг каталогу та унікальність UX — основні фактори. Оцінимо ваш проект безкоштовно — замовте консультацію.

Чек-лист перед запуском

• Race condition при оплаті останнього товару — покритий тестом
• Ідемпотентність вебхуків платіжного шлюзу
• Rate limiting на ендпоїнтах кошика та checkout
• Canonical на фільтрованих сторінках каталогу
• Фіскалізація чеків (ФЗ-54 для РФ або аналог)
• Стрес-тест checkout під навантаженням (k6 або Locust)
• Моніторинг помилок (Sentry) та алерти на payment errors
• Backup бази даних з перевіреним restore-процесом

Гарантуємо — кожен проект проходить цей чек-лист перед релізом. Зв'яжіться з нами — підберемо оптимальну архітектуру під ваш бюджет та терміни.