Как подключить магазин к 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 вручную не нужно — а если у вашей платформы нет нативного экспорта, фид создают специальные плагины или интеграторы маркетплейсов. На open source платформах (таких как 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 скачивает мой фид?

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