Format katalogu dla sklepów

Format katalogu opisuje, jak przygotować plik CSV albo feed XML, żeby oferty Twojego sklepu pojawiły się w Thrift. Wystarczą trzy kolumny: tytuł, cena i adres rzeczy w Twoim sklepie.

Plik CSV w formacie Thrift

Pierwszy wiersz zawiera nagłówki kolumn. Separatorem jest średnik albo przecinek, a kodowanie to UTF-8. Plik może mieć do 8 MB. Rozpoznajemy też angielskie nazwy kolumn: title, price, link, image_link, size, condition, brand, description, availability i product_type.

Nie zgadujemy brakujących danych. Jeśli w pliku nie ma rozmiaru, oferta pokaże się bez rozmiaru. Im pełniejsze dane, tym łatwiej kupującym filtrować oferty.

KolumnaWymaganaOpisPrzykład
tytultakNazwa oferty widoczna w kataloguSweter wełniany Benetton
cenatakCena w złotych, z przecinkiem lub kropką89,90
urltakAdres tej rzeczy w Twoim sklepie, w domenie sklepu z profiluhttps://twojsklep.pl/sweter-12
idnieStały identyfikator sztuki w sklepie. Bez niego używamy adresu ofertySW-12
zdjecienieAdres https zdjęciahttps://twojsklep.pl/foto/12.jpg
rozmiarnieRozmiar z metkiM
stannieStan rzeczy według sklepubardzo dobry
kategorianieRodzaj ubraniaswetry
dzialniedamskie, meskie, dodatki lub dzieciecedamskie
markanieMarka z metkiBenetton
opisnieOpis i wymiarySzerokość pod pachami 52 cm
dostepnoscnieOferta oznaczona jako niedostępna albo out of stock nie jest publikowanadostepny

Przykład pliku CSV

Poniżej najprostszy plik z jedną ofertą. Pierwszy wiersz to nagłówki, drugi to oferta.

tytul;cena;url;id;zdjecie;rozmiar;stan;dzial;marka
Sweter wełniany;89,90;https://twojsklep.pl/sweter-12;SW-12;https://twojsklep.pl/foto/12.jpg;M;bardzo dobry;damskie;Benetton

Feed Google Merchant

Przyjmujemy feed w formacie RSS 2.0 albo Atom z polami g:id, g:title, g:link, g:image_link, g:price albo g:sale_price, g:size, g:condition, g:brand, g:gender, g:product_type i g:availability. Takie feedy generują zwykle wtyczki i moduły w Shoper, IdoSell, WooCommerce, Shopify i PrestaShop.

Podajesz publiczny adres feedu, https albo http na standardowym porcie. Plik może mieć do 8 MB.

Feed Ceneo

Feed Ceneo ma element główny offers z elementami o, które mają atrybuty id, url, price, avail i stock. Wewnątrz czytamy name, cat, imgs z elementem main, desc oraz attrs, w tym Rozmiar, Stan i Producent. Tak samo jak w pozostałych formatach brak danych zostaje brakiem.

Jak działa odświeżanie, pełny katalog i dopisywanie

Feed odświeżamy co 15 minut. Jeśli feed jest pełnym katalogiem, oferty, których w nim już nie ma, zdejmujemy z publikacji, więc sprzedana rzecz znika sama. Plik CSV możesz traktować jako pełny katalog albo jako dopisanie nowych ofert, co wybierasz przy wgrywaniu.

Błędny plik nie kasuje istniejącego katalogu. Jeśli odczyt się nie uda, poprzednia wersja pozostaje, a w panelu pojawia się informacja o stanie feedu.

Co blokuje publikację oferty

Zanim opublikujesz katalog, wypróbuj demo. Pokaże, które oferty przejdą i co trzeba poprawić.

  • brak tytułu, ceny albo adresu rzeczy,
  • adres rzeczy poza domeną sklepu podaną w profilu,
  • oferta oznaczona jako niedostępna,
  • cena niezgodna z formatem, na przykład tekst zamiast liczby,
  • przekroczony limit nowych ofert w danym miesiącu (nadmiar czeka, a pieniędzy nie pobieramy dodatkowo),
  • niezapłacony abonament albo nieaktualny katalog: feed odczytany później niż 48 godzin temu albo katalog bez feedu niepotwierdzony od 7 dni.

Najczęstsze pytania

Czy muszę mieć feed, żeby dołączyć?

Nie. Możesz wgrać plik CSV w formacie Thrift. Feed Google Merchant lub Ceneo jest wygodniejszy, bo odświeża się co 15 minut.

Co jeśli w pliku nie ma rozmiaru?

Oferta zostanie opublikowana bez rozmiaru. Nie dopisujemy brakujących danych.

Co się stanie, jeśli wgram błędny plik?

Dotychczasowy katalog zostaje bez zmian, a w panelu zobaczysz, co trzeba poprawić.

Masz sklep second hand albo butik vintage?

Pokaż swój katalog kupującym w Thrift. Stały abonament, bez prowizji od sprzedaży i bez opłat za kliknięcia.