Як підключити магазин до Ceneo через XML-файл — інструкція

Прайс-агрегатор Ceneo зчитує ваші товари з одного XML-файлу — якщо фід налаштовано неправильно, пропозиції не зʼявляться або будуть відхилені. Ця інструкція показує, як підготувати, підключити і перевірити фід крок за кроком.

Як підключити магазин до Ceneo через XML-файл — коротко

Щоб підключити магазин до прайс-агрегатора Ceneo, ви не завантажуєте товари вручну. Ви надаєте одну URL-адресу, що веде до XML-файлу (товарного фіду), який Ceneo періодично зчитує та на його основі створює й оновлює ваші пропозиції. Уся інтеграція зводиться до чотирьох речей: згенерувати коректний фід у панелі магазину, заповнити обовʼязкові поля (насамперед EAN, виробник і код виробника), змапувати категорії магазину на категорії Ceneo, а також вставити адресу фіду в панелі Ceneo та вибрати модель розрахунків.

Нижче ви знайдете детальну структуру файлу, покрокове налаштування, контрольний список для перевірки фіду перед відправленням, а також перелік найчастіших помилок, через які пропозиції відхиляють або вони взагалі не зʼявляються в порівнювачі.

Що таке XML-фід Ceneo і як він виглядає всередині

Фід — це звичайний текстовий файл у форматі XML, який автоматично генерує програмне забезпечення магазину і який доступний за постійною, публічною URL-адресою (найчастіше щось на кшталт twojsklep.pl/ceneo.xml). Ceneo зчитує його через регулярні проміжки часу, тому кожна зміна ціни чи складського залишку має потрапляти у фід — її не вписують вручну на боці порівнювача. Це ключове припущення: фід є єдиним каналом комунікації між вашим магазином і Ceneo.

Структура спирається на один батьківський елемент <offers>, усередині якого кожен товар — це окремий вузол <o> (від англійського offer). Спрощений каркас однієї пропозиції виглядає так:

• <offers version=”1″> — головний елемент усього файлу,
• <o id=”123″ url=”…” price=”149.00″ avail=”1″ stock=”8″> — окрема пропозиція разом з атрибутами,
• <cat>Електроніка/Аудіо/Навушники</cat> — шлях категорії,
• <name>Бездротові навушники XYZ</name> — назва товару,
• <imgs><main url=”…”/></imgs> — фотографії,
• <desc>…</desc> — опис в обмеженому HTML,
• <attrs><a name=”EAN”>5901234567890</a></attrs> — атрибути, зокрема EAN, виробник, код виробника.

Атрибути, розміщені безпосередньо в тезі <o>, описують логістику пропозиції (ціну, доступність, залишок), а дочірні елементи описують сам товар (назва, категорія, фотографії, опис, параметри). У таблиці нижче зібрано найважливіші атрибути пропозиції.

Покрокове налаштування XML-фіду

Крок 1. Згенеруйте фід у панелі магазину

Більшість e-commerce-платформ (зокрема Shoper, PrestaShop, WooCommerce, Comarch e-Sklep) мають готовий модуль «Порівнювачі цін» або «Інтеграції → Ceneo», який генерує фід за схемою Ceneo автоматично. Ви вмикаєте модуль, а система повертає вам готову URL-адресу файлу. Вам не потрібно писати XML вручну — а якщо ваша платформа не має нативного експорту, фід будують спеціальні плагіни або інтегратори маркетплейсів. На платформах з відкритим кодом (як WooCommerce) варто перевірити, чи плагін генерує фід статично (файл оновлюється кожні X годин), чи динамічно (при кожному зчитуванні) — це впливає на актуальність цін і залишків.

Крок 2. Заповніть обовʼязкові поля (EAN, виробник, код виробника)

Це найчастіше джерело проблем. Ceneo зіставляє вашу пропозицію з наявною карткою товару переважно за кодом EAN (8- або 13-значний штрихкод), а також за парою виробник + код виробника. Якщо ви продаєте книжки, відповідником EAN є 13-значний ISBN, а для ліків і безрецептурних (OTC) добавок — 7-значний код ліків. Без цих даних пропозиція або не буде зіставлена з правильною карткою, або взагалі не пройде валідацію. У панелі магазину заповніть ці поля в картці кожного товару (найчастіше поле «Ідентифікатор виробника / EAN» та «Виробник»).

Крок 3. Змапуйте категорії магазину на категорії Ceneo

Кожен товар має потрапити до конкретної категорії в дереві Ceneo. Програмне забезпечення магазину зазвичай надає інструмент мапування, у якому ви привʼязуєте свої категорії до відповідників у Ceneo. Правильне мапування пришвидшує прийняття пропозицій і мінімізує ризик помилкового призначення. Уникайте загальних і маркетингових категорій на кшталт «Розпродаж», «Акція» чи «Новинки» — Ceneo їх відхиляє, бо вони не описують реальну товарну категорію.

Крок 4. Підключіть адресу фіду в панелі Ceneo

Увійдіть до партнерської панелі на biznes.ceneo.pl, додайте магазин і вставте URL-адресу фіду, згенеровану на кроці 1. Ceneo зчитає файл, проведе технічну валідацію (відповідність схемі) і покаже звіт: скільки пропозицій завантажено, а скільки відхилено і з якої причини. Цей звіт — ваш головний діагностичний інструмент, до якого ви повертаєтеся після кожної більшої зміни у фіді.

Перший імпорт і модерація нових пропозицій зазвичай займають певний час — не думайте, що товари зʼявляться в порівнювачі одразу після підключення фіду. Після кожної великої зміни у файлі (напр. перемапування категорій) зачекайте на наступний цикл зчитування і знову перевірте звіт, перш ніж вважати зміну успішною. Варто також додати до url-адрес параметри UTM, щоб у статистиці магазину відрізнити трафік з Ceneo від інших джерел.

Крок 5. Виберіть модель розрахунків

Ceneo розраховується з магазинами переважно за моделлю CPC (cost per click) — ви платите за кожен перехід користувача з порівнювача до вашого магазину. Вартість кліку залежить насамперед від категорії товару і становить орієнтовно від бл. 0,39 zł до 1,03 zł (актуальні ставки дивіться у прайслисті Ceneo — вони можуть змінюватися). Розрахунок працює за передплаченою моделлю (prepaid): ви поповнюєте розрахунковий рахунок магазину, а кошти списуються разом із трафіком; невикористаний залишок повертають при закритті рахунку. Мінімальна сума поповнення — орієнтовно бл. 375 zł — теж варто уточнити біля джерела.

Структура файлу — дочірні елементи пропозиції

Окрім атрибутів у тезі <o>, кожна пропозиція містить елементи, що описують товар. Нижче — найважливіші з них разом з лімітами та примітками.

Фотографії мають зображати товар на світлому, найкраще білому тлі, без водяних знаків, логотипів магазину та рекламних приписок. Опис має містити конкретну інформацію про товар — без посилань на власний магазин, контактних даних чи рекламних гасел.

Варіанти товарів і групування пропозицій

Якщо ви продаєте товари в багатьох варіантах (розмір, колір, обʼєм), кожен варіант розглядайте як окрему пропозицію <o> з власним, унікальним id та — якщо варіанти мають різні штрихкоди — власним EAN. Атрибут url має вести саме до конкретного варіанта, а не до загальної сторінки товару, щоб після кліку клієнт потрапив на конкретну позицію з правильною ціною та доступністю. Розбіжність між варіантом у фіді та цільовою сторінкою — часта причина скарг і зниження якості пропозицій.

Параметри, що розрізняють варіанти, передавайте в секції <attrs> як окремі атрибути <a name=”…”>, а не як приписки в назві товару. Завдяки цьому Ceneo правильно зіставить пропозицію з карткою, а фільтри в порівнювачі спрацюють на вашу користь. Поле name тримайте чистим і відповідним до каталогової номенклатури — без розміру, кольору чи маркетингових гасел, втиснутих у заголовок.

Як перевірити фід перед відправленням — контрольний список

Перш ніж підключати фід у панелі Ceneo, пройдіться цим списком. Виявлення помилок на цьому етапі економить дні очікування на повторну модерацію.

1. Кодування і коректність XML. Файл має бути в UTF-8, а структура має правильно «закриватися» (кожен тег закритий). Відкрийте фід у браузері або XML-валідаторі — якщо файл не парситься, Ceneo відхилить усе.
2. Адреса фіду публічна і стабільна. URL має відкриватися без входу в систему і не повертати помилку 500/404. Перевірте його в режимі інкогніто.
3. EAN / код виробника в кожній пропозиції. Перегляньте, чи поля не порожні і мають правильну кількість цифр (EAN: 8 або 13).
4. Ціни збігаються з магазином. Ціна у фіді має бути ідентичною ціні на сторінці товару — розбіжності призводять до призупинення пропозиції.
5. Доступність відповідає дійсності. Не встановлюйте avail=”1″ для товарів, яких немає в наявності.
6. Категорії конкретні, не маркетингові. Жодних «Розпродажів» і «Новинок».
7. Фотографії працюють і чисті. Відкрийте кілька URL фотографій — вони мають завантажуватися і не мати водяних знаків.
8. Унікальні id. Жодні дві пропозиції не можуть мати однаковий id.

Якщо ви не в змозі самостійно підготувати файл у потрібній схемі, Ceneo дозволяє надіслати будь-який наявний файл на адресу технічної підтримки (wsparciesklepu@ceneo.pl) для перевірки коректності даних.

Найчастіші причини відхилення пропозиції на Ceneo

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

Оновлення фіду та підтримання якості пропозицій

Підключення фіду — це початок, а не кінець. Ceneo зчитує файл циклічно, тож кожна розбіжність між фідом і реальним станом магазину позначається на якості пропозицій і витратах. Найчастіша проблема — неактуальні ціни й залишки: якщо фід оновлюється рідше, ніж ви змінюєте ціни, клієнт клікає пропозицію (за яку ви платите за моделлю CPC), а в магазині бачить іншу ціну або відсутність товару.

Тому ціни й складські залишки варто тримати в одному джерелі істини та синхронізувати автоматично, а не редагувати вручну в багатьох місцях. Це той самий механізм, який захищає від оверселінгу при багатоканальному продажі — що більше каналів (Ceneo, Allegro, власний магазин), то більший ризик продати те, чого вже немає. Варто спланувати синхронізацію складських залишків як процес, а не одноразове налаштування, і так підібрати частоту оновлення фіду, щоб вона відповідала темпу змін у вашому асортименті.

На практиці, коли кількість каналів зростає, доцільно централізувати синхронізацію залишків в одній панелі, яка стежить за узгодженістю цін і доступності між фідом Ceneo та рештою каналів. Інструменти класу multichannel CRM — до яких належатиме й Nimo, що розробляється, — у перспективі мають обʼєднувати ці джерела, щоб фід завжди відображав реальний стан складу. До того часу правило просте: одне джерело даних про ціну і залишок, а фід генерується на його основі.

Найчастіші запитання

Чи потрібно для інтеграції з Ceneo вручну писати XML-файл?

Ні. На практиці фід генерує програмне забезпечення магазину або плагін — ви лише вмикаєте модуль Ceneo, заповнюєте дані товарів (EAN, виробник, категорії) і передаєте готову URL-адресу до панелі Ceneo. Ручне редагування XML потрібне лише в нетипових, нестандартних конфігураціях.

Чому мої товари не зʼявляються на Ceneo попри коректний фід?

Найчастіше причина — відсутність EAN або коду виробника (немає зіставлення з карткою товару), надто загальна категорія чи публічно недоступна адреса фіду. Перевірте звіт валідації в панелі Ceneo — він показує кількість відхилених пропозицій разом із причиною. Врахуйте також час на модерацію на боці порівнювача.

Яких значень може набувати поле avail (доступність)?

Це числа, що позначають час відправлення — зокрема 1 (в наявності одразу / до 24 год), 3, 7, 14 днів, а також спеціальні значення для випадку відсутності інформації про доступність. Точний, актуальний перелік допустимих значень ви знайдете в офіційній специфікації Ceneo — сприймайте конкретні числа як орієнтовні та перевіряйте біля джерела.

Скільки коштує присутність у Ceneo?

Ceneo зазвичай розраховується з магазинами за моделлю CPC — ви платите за клік, що веде до вашого магазину. Вартість залежить від категорії і становить орієнтовно від бл. 0,39 zł до 1,03 zł за клік, у передплаченій моделі. Актуальні ставки й мінімальні суми поповнення дивіться у прайслисті Ceneo, бо вони можуть змінюватися.

Як часто Ceneo зчитує мій фід?

Фід зчитується циклічно, а частота залежить від налаштувань і платформи. Ключове — щоб фід оновлювався не рідше, ніж змінюються ваші ціни й залишки, інакше клієнт (за клік якого ви платите) потрапить на неактуальну пропозицію. За великої ротації асортименту варто подбати про якомога частіше або динамічне оновлення файлу.