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

Mateusz Piotrowicz

Mateusz Piotrowicz

Technical & Logistics Expert

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.

Darmowy audyt Ceneo
Skorzystaj z darmowego audytu konta Ceneo
  • 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.

  1. Wygeneruj plik i otwórz jego adres w przeglądarce – powinien się wyświetlić bez logowania.

  2. Sprawdź, czy plik jest poprawnym dokumentem XML, np. w walidatorze lub edytorze kodu.

  3. Wklej adres w formularzu zgłoszeniowym albo w ustawieniach przetwarzania ofert w panelu.

  4. Po pierwszym pobraniu sprawdź w panelu, ile ofert zostało przyjętych, a ile odrzuconych i dlaczego.

  5. 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.

  1. Wygeneruj plik i otwórz jego adres w przeglądarce – powinien się wyświetlić bez logowania.

  2. Sprawdź, czy plik jest poprawnym dokumentem XML, np. w walidatorze lub edytorze kodu.

  3. Wklej adres w formularzu zgłoszeniowym albo w ustawieniach przetwarzania ofert w panelu.

  4. Po pierwszym pobraniu sprawdź w panelu, ile ofert zostało przyjętych, a ile odrzuconych i dlaczego.

  5. 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.

Czy ten artykuł był pomocny? Oceń go
Bądź pierwszą osobą, która oceni

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.

★★★★★
Współpracowałeś z Vinson?
Twoja opinia pomoże innym sprzedawcom wybrać sprawdzoną agencję. Zajmie Ci to minutę.
Oceń nas na Trustpilot →
Potrzebujesz pomocy z tym tematem?

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ń
4,9/5 ze 140 opiniiWdrażamy i obsługujemy Ceneo
Mateusz Piotrowicz – Technical & Logistics Expert
Mateusz PiotrowiczTechnical & Logistics Expert

Przeczytaj także

Więcej porad z naszej bazy wiedzy – przesuń, aby zobaczyć kolejne artykuły.

1 / 1

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."

ZADZWOŃ

574 944 685

ADRES

Kazimierza Wielkiego 7/7

32-700 Bochnia