Plik XML dla Ceneo – jak przygotować feed produktowy krok po kroku

Mateusz Piotrowicz
Mateusz Piotrowicz
Technical & Logistics Expert
Plik XML dla Ceneo – jak przygotować feed produktowy krok po kroku
Plik XML Ceneo to feed produktowy, z którego porównywarka pobiera Twoje oferty: nazwy, ceny, zdjęcia, kategorie, kody EAN i dostępność. Od jego jakości zależy, ile produktów w ogóle pojawi się w serwisie, czy połączą się z właściwymi kartami produktów i czy klient zobaczy aktualną cenę. Źle przygotowany plik to najczęstsza przyczyna problemów sklepów na starcie – od odrzuconych ofert po zawieszenie prezentacji.
W tym poradniku pokazujemy krok po kroku, jak przygotować plik XML dla Ceneo: jakie elementy są obowiązkowe, jak wybrać sposób generowania pliku, jak zmapować kategorie i atrybuty, gdzie opublikować plik i jak dbać o jego aktualność. Opieramy się na oficjalnej instrukcji Ceneo i na tym, co widzimy przy wdrożeniach w sklepach na różnych platformach.
Czym jest plik XML Ceneo i do czego służy
Ceneo nie pobiera danych bezpośrednio z bazy sklepu ani nie przepisuje ich ręcznie. Zamiast tego regularnie odczytuje plik w formacie XML, który sklep udostępnia pod stałym adresem. W pliku każda oferta jest opisana w ustalonej strukturze: ma identyfikator, adres strony, cenę, dostępność, kategorię, nazwę, zdjęcia, opis i atrybuty. Na tej podstawie Ceneo prezentuje ofertę i łączy ją z kartą produktu, na której klient porównuje sklepy.
Regulamin współpracy z serwisem Ceneo określa, że dane ofertowe są pobierane automatycznie nie rzadziej niż raz na dobę, a oferta jest prezentowana dopiero po powiązaniu jej z produktem w bazie Ceneo. Oznacza to dwie rzeczy: zmiany w pliku nie pojawiają się w serwisie natychmiast, a sam plik musi zawierać dane, które pozwolą dopasować ofertę do karty produktu. Jeśli chcesz najpierw zrozumieć ogólną rolę feedu, przeczytaj tekst o tym, czym jest feed produktowy na Ceneo.
Wykres – sześć kroków przygotowania pliku XML dla Ceneo. [#chart:ce10]
Krok 1. Uporządkuj katalog, zanim wygenerujesz plik
Plik XML jest tylko odbiciem danych ze sklepu. Jeśli w katalogu brakuje kodów EAN, marki są wpisane na kilka sposobów, a stany magazynowe są nieaktualne, żaden generator tego nie naprawi. Dlatego pracę nad feedem zaczynamy od przeglądu katalogu.
Unikalne identyfikatory – każdy produkt i wariant ma własne ID, które się nie zmienia. Instrukcja Ceneo podkreśla, że identyfikatora raz użytej oferty nie wolno nigdy wykorzystać ponownie dla innego produktu.
Kody EAN – 8 lub 13 cyfr, bez spacji i dopisków. To najważniejszy atrybut przy łączeniu ofert z kartami produktów.
Marka i kod producenta – wpisane jednolicie, tak jak na opakowaniu, bez skrótów i literówek.
Ceny brutto i dostępność – zgodne z tym, co klient widzi na stronie sklepu.
Zdjęcia – w możliwie wysokiej rozdzielczości, bez logo sklepu i znaków wodnych.
W sklepach, które prowadzą katalog w systemie do obsługi sprzedaży, porządek warto zrobić właśnie tam – na przykład w Base. Jak uporządkować kody, opisujemy w artykule o EAN i SKU w BaseLinkerze.
Krok 2. Wybierz sposób generowania pliku
Plik możesz przygotować na kilka sposobów. Wybór zależy od platformy sklepu, liczby produktów i tego, czy sprzedajesz wielokanałowo.
Sposób | Dla kogo | Na co uważać |
Wbudowana integracja platformy (np. IdoSell, Shoper) | Sklepy na platformach SaaS | Mapowanie kategorii i pola EAN trzeba skonfigurować samodzielnie |
Oficjalna wtyczka Ceneo (WooCommerce, PrestaShop, Magento) | Sklepy na platformach open source | Wersja platformy, wydajność przy dużym katalogu |
Aplikacja zewnętrzna (np. dla Shopify) | Platformy bez natywnej integracji | Limity produktów w planie i koszt abonamentu |
System do obsługi sprzedaży (np. Base) | Sprzedaż wielokanałowa, jeden katalog | Jeden plik na konto, poprawne mapowanie pól |
Własny skrypt programisty | Nietypowe sklepy, duże katalogi | Zgodność ze specyfikacją i utrzymanie po zmianach |
Konfigurację dla poszczególnych platform omawiamy w osobnych tekstach serii, a dla Shopera mamy już gotowy opis integracji Shopera z Ceneo. Jeśli katalog prowadzisz w Base, sprawdź artykuł o eksporcie produktów z BaseLinkera – opisujemy w nim, jak działają pliki XML i CSV generowane z systemu.
[#tip] Jeśli masz wybór, korzystaj z rozwiązania, które generuje plik w strukturze Ceneo. Instrukcja dopuszcza też inne struktury, ale wtedy trzeba je uzgodnić z działem wsparcia sklepów, a każda zmiana formatu wymaga ponownej weryfikacji.
Krok 3. Poznaj strukturę pliku XML Ceneo
Instrukcja tworzenia pliku XML opisuje strukturę, w której główny element offers zawiera listę ofert. Każda oferta to element o z atrybutami i elementami podrzędnymi. Poniżej zestawienie najważniejszych pól z limitami, które podaje Ceneo.
Pole | Co zawiera | Wymagania z instrukcji |
id | Identyfikator oferty | Unikalny, do 100 znaków, nigdy nie używany ponownie |
url | Adres karty produktu w sklepie | Do 1000 znaków, strona z aktywnym koszykiem |
price | Cena brutto | Separator dziesiętny – kropka |
avail | Czas wysyłki | Wartości 1, 3, 7, 14, 90, 99 lub 110 |
cat | Kategoria w sklepie | Pełna ścieżka, do 255 znaków |
name | Nazwa produktu | Do 150 znaków, bez dopisków handlowych |
imgs | Zdjęcie główne i dodatkowe | Do 20 zdjęć, adres do 2048 znaków |
desc | Opis produktu | Do 100 tys. znaków, podstawowe znaczniki HTML |
attrs | Atrybuty, m.in. Marka, Kod producenta, EAN | Nazwy atrybutów zgodne z instrukcją |
Opcjonalnie oferta może mieć też atrybuty weight (waga w kilogramach), stock (stan magazynowy jako liczba całkowita) i basket, który oznacza dostępność w usłudze Kup Teraz. Instrukcja zaleca kodowanie UTF-8, a opis najlepiej umieszczać w sekcji CDATA, żeby znaczniki HTML nie psuły struktury pliku.
Plik XML Ceneo to feed produktowy, z którego porównywarka pobiera Twoje oferty: nazwy, ceny, zdjęcia, kategorie, kody EAN i dostępność. Od jego jakości zależy, ile produktów w ogóle pojawi się w serwisie, czy połączą się z właściwymi kartami produktów i czy klient zobaczy aktualną cenę. Źle przygotowany plik to najczęstsza przyczyna problemów sklepów na starcie – od odrzuconych ofert po zawieszenie prezentacji.
W tym poradniku pokazujemy krok po kroku, jak przygotować plik XML dla Ceneo: jakie elementy są obowiązkowe, jak wybrać sposób generowania pliku, jak zmapować kategorie i atrybuty, gdzie opublikować plik i jak dbać o jego aktualność. Opieramy się na oficjalnej instrukcji Ceneo i na tym, co widzimy przy wdrożeniach w sklepach na różnych platformach.
Czym jest plik XML Ceneo i do czego służy
Ceneo nie pobiera danych bezpośrednio z bazy sklepu ani nie przepisuje ich ręcznie. Zamiast tego regularnie odczytuje plik w formacie XML, który sklep udostępnia pod stałym adresem. W pliku każda oferta jest opisana w ustalonej strukturze: ma identyfikator, adres strony, cenę, dostępność, kategorię, nazwę, zdjęcia, opis i atrybuty. Na tej podstawie Ceneo prezentuje ofertę i łączy ją z kartą produktu, na której klient porównuje sklepy.
Regulamin współpracy z serwisem Ceneo określa, że dane ofertowe są pobierane automatycznie nie rzadziej niż raz na dobę, a oferta jest prezentowana dopiero po powiązaniu jej z produktem w bazie Ceneo. Oznacza to dwie rzeczy: zmiany w pliku nie pojawiają się w serwisie natychmiast, a sam plik musi zawierać dane, które pozwolą dopasować ofertę do karty produktu. Jeśli chcesz najpierw zrozumieć ogólną rolę feedu, przeczytaj tekst o tym, czym jest feed produktowy na Ceneo.
Wykres – sześć kroków przygotowania pliku XML dla Ceneo. [#chart:ce10]
Krok 1. Uporządkuj katalog, zanim wygenerujesz plik
Plik XML jest tylko odbiciem danych ze sklepu. Jeśli w katalogu brakuje kodów EAN, marki są wpisane na kilka sposobów, a stany magazynowe są nieaktualne, żaden generator tego nie naprawi. Dlatego pracę nad feedem zaczynamy od przeglądu katalogu.
Unikalne identyfikatory – każdy produkt i wariant ma własne ID, które się nie zmienia. Instrukcja Ceneo podkreśla, że identyfikatora raz użytej oferty nie wolno nigdy wykorzystać ponownie dla innego produktu.
Kody EAN – 8 lub 13 cyfr, bez spacji i dopisków. To najważniejszy atrybut przy łączeniu ofert z kartami produktów.
Marka i kod producenta – wpisane jednolicie, tak jak na opakowaniu, bez skrótów i literówek.
Ceny brutto i dostępność – zgodne z tym, co klient widzi na stronie sklepu.
Zdjęcia – w możliwie wysokiej rozdzielczości, bez logo sklepu i znaków wodnych.
W sklepach, które prowadzą katalog w systemie do obsługi sprzedaży, porządek warto zrobić właśnie tam – na przykład w Base. Jak uporządkować kody, opisujemy w artykule o EAN i SKU w BaseLinkerze.
Krok 2. Wybierz sposób generowania pliku
Plik możesz przygotować na kilka sposobów. Wybór zależy od platformy sklepu, liczby produktów i tego, czy sprzedajesz wielokanałowo.
Sposób | Dla kogo | Na co uważać |
Wbudowana integracja platformy (np. IdoSell, Shoper) | Sklepy na platformach SaaS | Mapowanie kategorii i pola EAN trzeba skonfigurować samodzielnie |
Oficjalna wtyczka Ceneo (WooCommerce, PrestaShop, Magento) | Sklepy na platformach open source | Wersja platformy, wydajność przy dużym katalogu |
Aplikacja zewnętrzna (np. dla Shopify) | Platformy bez natywnej integracji | Limity produktów w planie i koszt abonamentu |
System do obsługi sprzedaży (np. Base) | Sprzedaż wielokanałowa, jeden katalog | Jeden plik na konto, poprawne mapowanie pól |
Własny skrypt programisty | Nietypowe sklepy, duże katalogi | Zgodność ze specyfikacją i utrzymanie po zmianach |
Konfigurację dla poszczególnych platform omawiamy w osobnych tekstach serii, a dla Shopera mamy już gotowy opis integracji Shopera z Ceneo. Jeśli katalog prowadzisz w Base, sprawdź artykuł o eksporcie produktów z BaseLinkera – opisujemy w nim, jak działają pliki XML i CSV generowane z systemu.
[#tip] Jeśli masz wybór, korzystaj z rozwiązania, które generuje plik w strukturze Ceneo. Instrukcja dopuszcza też inne struktury, ale wtedy trzeba je uzgodnić z działem wsparcia sklepów, a każda zmiana formatu wymaga ponownej weryfikacji.
Krok 3. Poznaj strukturę pliku XML Ceneo
Instrukcja tworzenia pliku XML opisuje strukturę, w której główny element offers zawiera listę ofert. Każda oferta to element o z atrybutami i elementami podrzędnymi. Poniżej zestawienie najważniejszych pól z limitami, które podaje Ceneo.
Pole | Co zawiera | Wymagania z instrukcji |
id | Identyfikator oferty | Unikalny, do 100 znaków, nigdy nie używany ponownie |
url | Adres karty produktu w sklepie | Do 1000 znaków, strona z aktywnym koszykiem |
price | Cena brutto | Separator dziesiętny – kropka |
avail | Czas wysyłki | Wartości 1, 3, 7, 14, 90, 99 lub 110 |
cat | Kategoria w sklepie | Pełna ścieżka, do 255 znaków |
name | Nazwa produktu | Do 150 znaków, bez dopisków handlowych |
imgs | Zdjęcie główne i dodatkowe | Do 20 zdjęć, adres do 2048 znaków |
desc | Opis produktu | Do 100 tys. znaków, podstawowe znaczniki HTML |
attrs | Atrybuty, m.in. Marka, Kod producenta, EAN | Nazwy atrybutów zgodne z instrukcją |
Opcjonalnie oferta może mieć też atrybuty weight (waga w kilogramach), stock (stan magazynowy jako liczba całkowita) i basket, który oznacza dostępność w usłudze Kup Teraz. Instrukcja zaleca kodowanie UTF-8, a opis najlepiej umieszczać w sekcji CDATA, żeby znaczniki HTML nie psuły struktury pliku.
- Analiza ofert i dopasowania produktów
- Kontrola stawek CPC i budżetu kampanii
- Konkretne wskazówki, jak zwiększyć sprzedaż
Krok 4. Zmapuj kategorie
Kategoria w pliku to ścieżka z Twojego sklepu, ale powinna być możliwie szczegółowa i opisowa. Instrukcja Ceneo podaje przykład pełnej ścieżki w rodzaju Dom i ogród/Ogród/Nawadnianie/Pompy ogrodowe i odradza używanie kategorii marketingowych, takich jak Wyprzedaż, Promocja czy Nowości, bo nie mówią nic o produkcie. Na tej podstawie Ceneo przypisuje ofertę do własnej kategorii, a regulamin przewiduje, że serwis może zmienić kategorię, jeśli uzna, że jest nieprawidłowa.
Wtyczki do WooCommerce i PrestaShop oraz integracje platform SaaS pozwalają mapować kategorie sklepu na kategorie Ceneo. Warto z tego korzystać, bo kategoria wpływa nie tylko na to, gdzie oferta się pojawi, ale też na stawkę za kliknięcie, która w cenniku jest przypisana do kategorii. Więcej o tym, jak działają stawki, przeczytasz w tekście o stawkach CPC na Ceneo.
Krok 5. Uzupełnij atrybuty integracyjne
Atrybuty integracyjne to dane, po których Ceneo łączy Twoją ofertę z kartą produktu. Instrukcja wymienia wśród nich Markę, Kod producenta i EAN, a w niektórych branżach także ISBN (książki) czy kod leku (leki bez recepty). Bez nich oferta może trafić do weryfikacji ręcznej albo w ogóle nie zostać powiązana z produktem – a wtedy nie będzie prezentowana.
Wykres – pola, które powinna mieć każda oferta w pliku. [#chart:ce10b]
W części kategorii są też atrybuty kluczowe, oznaczone w specyfikacji jako wymagane – na przykład rozmiar w modzie. Jeśli produkt ma warianty w tej samej cenie, instrukcja pozwala podać wartości w jednym atrybucie, rozdzielone średnikiem. Warianty w różnych cenach powinny być osobnymi ofertami.
Dane wymagane przy koszyku Ceneo
Jeśli chcesz sprzedawać w usłudze Kup Teraz, plik musi zawierać także informacje wynikające z rozporządzenia GPSR: dane producenta odpowiedzialnego, podmiotu odpowiedzialnego w UE i – w stosownych przypadkach – informacje o bezpieczeństwie produktu. Jak działa sam koszyk, opisaliśmy w artykule Kup na Ceneo – sprzedaż bez przekierowania, a o uzupełnianiu danych GPSR w systemie do obsługi sprzedaży – w tekście o GPSR w BaseLinkerze.
Nazwa, opis i zdjęcia
Nazwa w pliku powinna składać się z marki, modelu i najważniejszych cech produktu, np. pojemności czy koloru. Instrukcja ogranicza ją do 150 znaków i wyklucza dopiski handlowe, takie jak promocja, darmowa dostawa czy nazwa sklepu. Opis ma dotyczyć wyłącznie produktu – bez linków, danych kontaktowych i informacji o sklepie. Możesz w nim używać podstawowych znaczników HTML, takich jak akapity, nagłówki, listy i pogrubienia.
Zdjęcia to element, który klient widzi jako pierwszy. Instrukcja zaleca jak największą rozdzielczość, sam produkt na białym tle, wypełniający kadr, bez znaków wodnych i napisów. Nie powiększaj sztucznie małych grafik i nie podawaj miniatur. Zdjęcia dodatkowe mogą pokazywać produkt w użyciu lub z innej perspektywy. Regulamin dodatkowo zabrania umieszczania na zdjęciach logo sklepu.
Krok 6. Ustaw dostępność zgodnie z rzeczywistością
Atrybut avail mówi klientowi, kiedy wyślesz produkt. To jeden z elementów, które klient widzi w porównaniu, a regulamin wymienia dostępność oferty w sklepie wśród czynników sortowania ofert na karcie produktu.
Wartość avail | Znaczenie według instrukcji Ceneo |
1 | Wysyłka w ciągu 24 godzin |
3 | Wysyłka do 3 dni |
7 | Wysyłka do tygodnia |
14 | Wysyłka do 14 dni |
90 | Towar na zamówienie |
99 | Brak informacji – klient zobaczy komunikat, żeby sprawdzić w sklepie |
110 | Przedsprzedaż |
[#uwaga] Nie ustawiaj wartości 1 dla całego katalogu tylko dlatego, że lepiej wygląda. Instrukcja wymaga, żeby dane w pliku odpowiadały tym na stronie sklepu, a rozbieżności mogą skończyć się ukryciem ofert. Do tego opóźnione wysyłki obniżają oceny w ankietach Zaufanych Opinii.
Publikacja pliku i podpięcie go w panelu
Gotowy plik musi być dostępny pod stałym adresem, bez hasła i innych ograniczeń. Instrukcja zaznacza, że Ceneo nie aktualizuje danych z plików przesłanych mailem. Adres pliku podajesz w formularzu zgłoszeniowym, a później możesz go zmienić w panelu sklepu – zmianę lokalizacji pliku regulamin każe uzgodnić z Ceneo, żeby nie przerwać prezentacji ofert.
Wygeneruj plik i otwórz jego adres w przeglądarce – powinien się wyświetlić bez logowania.
Sprawdź, czy plik jest poprawnym dokumentem XML, np. w walidatorze lub edytorze kodu.
Wklej adres w formularzu zgłoszeniowym albo w ustawieniach przetwarzania ofert w panelu.
Po pierwszym pobraniu sprawdź w panelu, ile ofert zostało przyjętych, a ile odrzuconych i dlaczego.
Popraw dane dla odrzuconych ofert i poczekaj na kolejne pobranie pliku.
Cały proces rejestracji, w którym podajesz link do pliku, opisaliśmy w poradniku jak dodać sklep do Ceneo.
Aktualizacja pliku i tryb przyrostowy
Plik musi być aktualny. Regulamin zakłada aktualizację danych w ciągu doby i wymienia nieaktualne ceny lub dostępność wśród powodów zawieszenia ofert. W praktyce oznacza to, że generator pliku powinien odświeżać dane automatycznie, najlepiej kilka razy dziennie. Według pomocy platformy IdoSell Ceneo pobiera plik co 6 godzin, ale harmonogram może zależeć od ustawień konta, dlatego sprawdź go w swoim panelu.
Przy bardzo dużych katalogach instrukcja przewiduje tryb przyrostowy: zamiast całego pliku wysyłasz tylko zmiany. Ofertę ukrywasz, przesyłając jej aktualizację z ceną równą 0, a przywracasz, wysyłając pełną definicję. To wygodne, ale wymaga dokładnej obsługi po stronie skryptu, dlatego w większości sklepów wystarczy pełny plik generowany regularnie.
[#przyklad] Sklep z wyposażeniem łazienek wysyłał do Ceneo 3 200 produktów, ale w serwisie widział niewiele ponad połowę. Po analizie okazało się, że ok. 900 produktów nie miało EAN, a w ok. 400 marka była wpisana w kilku wersjach. Po uzupełnieniu kodów, ujednoliceniu marek i zmapowaniu kategorii liczba połączonych ofert wyraźnie wzrosła już po kolejnych pobraniach pliku. Liczby są przykładowe, ale schemat problemu jest bardzo typowy.
Plik XML dla Ceneo a feedy dla innych kanałów
Jeśli prowadzisz też kampanie w Google lub reklamy katalogowe w Meta, masz już doświadczenie z feedami. Logika jest podobna, ale struktura i nazwy pól różnią się w każdym kanale. Ceneo wymaga własnej specyfikacji, więc nie wystarczy podać mu pliku przygotowanego dla Google Merchant Center.
W Ceneo kluczowe są atrybuty integracyjne i dopasowanie do kart produktów w bazie porównywarki.
W Google Merchant Center liczą się m.in. identyfikatory GTIN, kategorie Google i zasady dotyczące produktów – opisujemy to w tekście o feedzie do Google Merchant Center z Base.
W Meta feed zasila katalog produktów do reklam dynamicznych – wymagania omawiamy w artykule o feedzie produktowym dla Meta.
Wspólny mianownik to porządek w katalogu. Jeśli raz uporządkujesz EAN, marki, kategorie i zdjęcia, każdy kolejny feed przygotujesz znacznie szybciej.
Najczęstsze błędy przy pierwszym pliku
Przy pierwszym wdrożeniu powtarzają się te same problemy. Większość z nich da się wychwycić jeszcze przed zgłoszeniem sklepu, jeśli przejrzysz plik według krótkiej listy.
Plik zawiera produkty niedostępne lub nieaktywne w sklepie, których nie da się zamówić.
Ceny w pliku są netto albo nie uwzględniają aktualnej promocji widocznej na stronie.
Kategoria to Wyprzedaż lub Nowości zamiast ścieżki opisującej produkt.
Kod EAN zawiera spacje, myślniki albo ma nieprawidłową liczbę cyfr.
Adres pliku zmienia się po każdej aktualizacji wtyczki lub wymaga logowania.
Identyfikatory ofert zmieniają się po migracji sklepu, przez co Ceneo widzi je jako nowe oferty.
Ostatni punkt jest szczególnie groźny. Regulamin wymienia samodzielną zmianę identyfikatorów ofert wśród powodów zawieszenia, a nowe identyfikatory oznaczają utratę historii ofert. Jeśli planujesz migrację sklepu, zadbaj o zachowanie dotychczasowych ID w pliku.
Najczęściej zadawane pytania
Czy mogę wysłać do Ceneo plik CSV zamiast XML?
Ceneo pracuje na plikach XML. Instrukcja dopuszcza struktury inne niż wzorcowa, ale trzeba je uzgodnić z działem wsparcia sklepów. Najprościej przygotować plik od razu w strukturze Ceneo.
Jak często Ceneo pobiera plik XML?
Regulamin mówi o pobieraniu danych nie rzadziej niż raz na dobę. W praktyce częstotliwość może być wyższa – według pomocy IdoSell plik jest pobierany co 6 godzin. Aktualny harmonogram sprawdzisz w panelu sklepu.
Dlaczego część ofert z pliku nie pojawia się na Ceneo?
Najczęściej brakuje atrybutów integracyjnych, przez co oferta nie łączy się z kartą produktu, albo dane w pliku nie zgadzają się ze stroną sklepu. Powody odrzucenia sprawdzisz w panelu w raporcie przetwarzania ofert.
Czy plik XML może być chroniony hasłem?
Nie. Instrukcja wymaga, żeby plik był dostępny bez ograniczeń pod stałym adresem. Ceneo nie aktualizuje też danych z plików przesyłanych mailem.
Czy w pliku mogę dodać do nazwy hasło promocyjne?
Nie powinieneś. Nazwa ma opisywać produkt i nie może zawierać dopisków handlowych, takich jak promocja czy darmowa dostawa. Takie dopiski utrudniają łączenie ofert i mogą prowadzić do ich odrzucenia.
Czy jeden plik wystarczy do porównywarki i do Kup na Ceneo?
Tak. Oferty w koszyku Ceneo pochodzą z tego samego pliku, który zasila porównywarkę. Wystarczy oznaczyć je atrybutem basket i uzupełnić dodatkowe dane, m.in. wagi i informacje wymagane przez GPSR.
Podsumowanie
Dobry plik XML Ceneo to uporządkowany katalog, właściwy sposób generowania, pełne ścieżki kategorii, atrybuty integracyjne, realna dostępność i stały adres bez hasła. Taki feed sprawia, że oferty łączą się z kartami produktów, a ceny i dostępność są zawsze aktualne. Jeśli dopiero poznajesz kanał, zacznij od artykułu o tym, jak działa sprzedaż na Ceneo.
Wdrażamy i obsługujemy kampanie i sprzedaż na Ceneo – przygotowujemy i porządkujemy pliki XML, mapujemy kategorie, uzupełniamy atrybuty i pilnujemy, żeby oferty łączyły się z kartami produktów. Sprawdź szczegóły usługi sprzedaż na Ceneo.
Krok 4. Zmapuj kategorie
Kategoria w pliku to ścieżka z Twojego sklepu, ale powinna być możliwie szczegółowa i opisowa. Instrukcja Ceneo podaje przykład pełnej ścieżki w rodzaju Dom i ogród/Ogród/Nawadnianie/Pompy ogrodowe i odradza używanie kategorii marketingowych, takich jak Wyprzedaż, Promocja czy Nowości, bo nie mówią nic o produkcie. Na tej podstawie Ceneo przypisuje ofertę do własnej kategorii, a regulamin przewiduje, że serwis może zmienić kategorię, jeśli uzna, że jest nieprawidłowa.
Wtyczki do WooCommerce i PrestaShop oraz integracje platform SaaS pozwalają mapować kategorie sklepu na kategorie Ceneo. Warto z tego korzystać, bo kategoria wpływa nie tylko na to, gdzie oferta się pojawi, ale też na stawkę za kliknięcie, która w cenniku jest przypisana do kategorii. Więcej o tym, jak działają stawki, przeczytasz w tekście o stawkach CPC na Ceneo.
Krok 5. Uzupełnij atrybuty integracyjne
Atrybuty integracyjne to dane, po których Ceneo łączy Twoją ofertę z kartą produktu. Instrukcja wymienia wśród nich Markę, Kod producenta i EAN, a w niektórych branżach także ISBN (książki) czy kod leku (leki bez recepty). Bez nich oferta może trafić do weryfikacji ręcznej albo w ogóle nie zostać powiązana z produktem – a wtedy nie będzie prezentowana.
Wykres – pola, które powinna mieć każda oferta w pliku. [#chart:ce10b]
W części kategorii są też atrybuty kluczowe, oznaczone w specyfikacji jako wymagane – na przykład rozmiar w modzie. Jeśli produkt ma warianty w tej samej cenie, instrukcja pozwala podać wartości w jednym atrybucie, rozdzielone średnikiem. Warianty w różnych cenach powinny być osobnymi ofertami.
Dane wymagane przy koszyku Ceneo
Jeśli chcesz sprzedawać w usłudze Kup Teraz, plik musi zawierać także informacje wynikające z rozporządzenia GPSR: dane producenta odpowiedzialnego, podmiotu odpowiedzialnego w UE i – w stosownych przypadkach – informacje o bezpieczeństwie produktu. Jak działa sam koszyk, opisaliśmy w artykule Kup na Ceneo – sprzedaż bez przekierowania, a o uzupełnianiu danych GPSR w systemie do obsługi sprzedaży – w tekście o GPSR w BaseLinkerze.
Nazwa, opis i zdjęcia
Nazwa w pliku powinna składać się z marki, modelu i najważniejszych cech produktu, np. pojemności czy koloru. Instrukcja ogranicza ją do 150 znaków i wyklucza dopiski handlowe, takie jak promocja, darmowa dostawa czy nazwa sklepu. Opis ma dotyczyć wyłącznie produktu – bez linków, danych kontaktowych i informacji o sklepie. Możesz w nim używać podstawowych znaczników HTML, takich jak akapity, nagłówki, listy i pogrubienia.
Zdjęcia to element, który klient widzi jako pierwszy. Instrukcja zaleca jak największą rozdzielczość, sam produkt na białym tle, wypełniający kadr, bez znaków wodnych i napisów. Nie powiększaj sztucznie małych grafik i nie podawaj miniatur. Zdjęcia dodatkowe mogą pokazywać produkt w użyciu lub z innej perspektywy. Regulamin dodatkowo zabrania umieszczania na zdjęciach logo sklepu.
Krok 6. Ustaw dostępność zgodnie z rzeczywistością
Atrybut avail mówi klientowi, kiedy wyślesz produkt. To jeden z elementów, które klient widzi w porównaniu, a regulamin wymienia dostępność oferty w sklepie wśród czynników sortowania ofert na karcie produktu.
Wartość avail | Znaczenie według instrukcji Ceneo |
1 | Wysyłka w ciągu 24 godzin |
3 | Wysyłka do 3 dni |
7 | Wysyłka do tygodnia |
14 | Wysyłka do 14 dni |
90 | Towar na zamówienie |
99 | Brak informacji – klient zobaczy komunikat, żeby sprawdzić w sklepie |
110 | Przedsprzedaż |
[#uwaga] Nie ustawiaj wartości 1 dla całego katalogu tylko dlatego, że lepiej wygląda. Instrukcja wymaga, żeby dane w pliku odpowiadały tym na stronie sklepu, a rozbieżności mogą skończyć się ukryciem ofert. Do tego opóźnione wysyłki obniżają oceny w ankietach Zaufanych Opinii.
Publikacja pliku i podpięcie go w panelu
Gotowy plik musi być dostępny pod stałym adresem, bez hasła i innych ograniczeń. Instrukcja zaznacza, że Ceneo nie aktualizuje danych z plików przesłanych mailem. Adres pliku podajesz w formularzu zgłoszeniowym, a później możesz go zmienić w panelu sklepu – zmianę lokalizacji pliku regulamin każe uzgodnić z Ceneo, żeby nie przerwać prezentacji ofert.
Wygeneruj plik i otwórz jego adres w przeglądarce – powinien się wyświetlić bez logowania.
Sprawdź, czy plik jest poprawnym dokumentem XML, np. w walidatorze lub edytorze kodu.
Wklej adres w formularzu zgłoszeniowym albo w ustawieniach przetwarzania ofert w panelu.
Po pierwszym pobraniu sprawdź w panelu, ile ofert zostało przyjętych, a ile odrzuconych i dlaczego.
Popraw dane dla odrzuconych ofert i poczekaj na kolejne pobranie pliku.
Cały proces rejestracji, w którym podajesz link do pliku, opisaliśmy w poradniku jak dodać sklep do Ceneo.
Aktualizacja pliku i tryb przyrostowy
Plik musi być aktualny. Regulamin zakłada aktualizację danych w ciągu doby i wymienia nieaktualne ceny lub dostępność wśród powodów zawieszenia ofert. W praktyce oznacza to, że generator pliku powinien odświeżać dane automatycznie, najlepiej kilka razy dziennie. Według pomocy platformy IdoSell Ceneo pobiera plik co 6 godzin, ale harmonogram może zależeć od ustawień konta, dlatego sprawdź go w swoim panelu.
Przy bardzo dużych katalogach instrukcja przewiduje tryb przyrostowy: zamiast całego pliku wysyłasz tylko zmiany. Ofertę ukrywasz, przesyłając jej aktualizację z ceną równą 0, a przywracasz, wysyłając pełną definicję. To wygodne, ale wymaga dokładnej obsługi po stronie skryptu, dlatego w większości sklepów wystarczy pełny plik generowany regularnie.
[#przyklad] Sklep z wyposażeniem łazienek wysyłał do Ceneo 3 200 produktów, ale w serwisie widział niewiele ponad połowę. Po analizie okazało się, że ok. 900 produktów nie miało EAN, a w ok. 400 marka była wpisana w kilku wersjach. Po uzupełnieniu kodów, ujednoliceniu marek i zmapowaniu kategorii liczba połączonych ofert wyraźnie wzrosła już po kolejnych pobraniach pliku. Liczby są przykładowe, ale schemat problemu jest bardzo typowy.
Plik XML dla Ceneo a feedy dla innych kanałów
Jeśli prowadzisz też kampanie w Google lub reklamy katalogowe w Meta, masz już doświadczenie z feedami. Logika jest podobna, ale struktura i nazwy pól różnią się w każdym kanale. Ceneo wymaga własnej specyfikacji, więc nie wystarczy podać mu pliku przygotowanego dla Google Merchant Center.
W Ceneo kluczowe są atrybuty integracyjne i dopasowanie do kart produktów w bazie porównywarki.
W Google Merchant Center liczą się m.in. identyfikatory GTIN, kategorie Google i zasady dotyczące produktów – opisujemy to w tekście o feedzie do Google Merchant Center z Base.
W Meta feed zasila katalog produktów do reklam dynamicznych – wymagania omawiamy w artykule o feedzie produktowym dla Meta.
Wspólny mianownik to porządek w katalogu. Jeśli raz uporządkujesz EAN, marki, kategorie i zdjęcia, każdy kolejny feed przygotujesz znacznie szybciej.
Najczęstsze błędy przy pierwszym pliku
Przy pierwszym wdrożeniu powtarzają się te same problemy. Większość z nich da się wychwycić jeszcze przed zgłoszeniem sklepu, jeśli przejrzysz plik według krótkiej listy.
Plik zawiera produkty niedostępne lub nieaktywne w sklepie, których nie da się zamówić.
Ceny w pliku są netto albo nie uwzględniają aktualnej promocji widocznej na stronie.
Kategoria to Wyprzedaż lub Nowości zamiast ścieżki opisującej produkt.
Kod EAN zawiera spacje, myślniki albo ma nieprawidłową liczbę cyfr.
Adres pliku zmienia się po każdej aktualizacji wtyczki lub wymaga logowania.
Identyfikatory ofert zmieniają się po migracji sklepu, przez co Ceneo widzi je jako nowe oferty.
Ostatni punkt jest szczególnie groźny. Regulamin wymienia samodzielną zmianę identyfikatorów ofert wśród powodów zawieszenia, a nowe identyfikatory oznaczają utratę historii ofert. Jeśli planujesz migrację sklepu, zadbaj o zachowanie dotychczasowych ID w pliku.
Najczęściej zadawane pytania
Czy mogę wysłać do Ceneo plik CSV zamiast XML?
Ceneo pracuje na plikach XML. Instrukcja dopuszcza struktury inne niż wzorcowa, ale trzeba je uzgodnić z działem wsparcia sklepów. Najprościej przygotować plik od razu w strukturze Ceneo.
Jak często Ceneo pobiera plik XML?
Regulamin mówi o pobieraniu danych nie rzadziej niż raz na dobę. W praktyce częstotliwość może być wyższa – według pomocy IdoSell plik jest pobierany co 6 godzin. Aktualny harmonogram sprawdzisz w panelu sklepu.
Dlaczego część ofert z pliku nie pojawia się na Ceneo?
Najczęściej brakuje atrybutów integracyjnych, przez co oferta nie łączy się z kartą produktu, albo dane w pliku nie zgadzają się ze stroną sklepu. Powody odrzucenia sprawdzisz w panelu w raporcie przetwarzania ofert.
Czy plik XML może być chroniony hasłem?
Nie. Instrukcja wymaga, żeby plik był dostępny bez ograniczeń pod stałym adresem. Ceneo nie aktualizuje też danych z plików przesyłanych mailem.
Czy w pliku mogę dodać do nazwy hasło promocyjne?
Nie powinieneś. Nazwa ma opisywać produkt i nie może zawierać dopisków handlowych, takich jak promocja czy darmowa dostawa. Takie dopiski utrudniają łączenie ofert i mogą prowadzić do ich odrzucenia.
Czy jeden plik wystarczy do porównywarki i do Kup na Ceneo?
Tak. Oferty w koszyku Ceneo pochodzą z tego samego pliku, który zasila porównywarkę. Wystarczy oznaczyć je atrybutem basket i uzupełnić dodatkowe dane, m.in. wagi i informacje wymagane przez GPSR.
Podsumowanie
Dobry plik XML Ceneo to uporządkowany katalog, właściwy sposób generowania, pełne ścieżki kategorii, atrybuty integracyjne, realna dostępność i stały adres bez hasła. Taki feed sprawia, że oferty łączą się z kartami produktów, a ceny i dostępność są zawsze aktualne. Jeśli dopiero poznajesz kanał, zacznij od artykułu o tym, jak działa sprzedaż na Ceneo.
Wdrażamy i obsługujemy kampanie i sprzedaż na Ceneo – przygotowujemy i porządkujemy pliki XML, mapujemy kategorie, uzupełniamy atrybuty i pilnujemy, żeby oferty łączyły się z kartami produktów. Sprawdź szczegóły usługi sprzedaż na Ceneo.


Mateusz Piotrowicz
Technical & Logistics Expert
Optymalizuje logistykę, magazyn i wysyłki sprzedawców. Skupia się na kosztach i terminowości dostaw.
Optymalizuje logistykę, magazyn i wysyłki sprzedawców. Skupia się na kosztach i terminowości dostaw.
Sprzedaż na Ceneo
Mateusz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie – bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy – przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."