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.
| Kolumna | Wymagana | Opis | Przykład |
|---|---|---|---|
| tytul | tak | Nazwa oferty widoczna w katalogu | Sweter wełniany Benetton |
| cena | tak | Cena w złotych, z przecinkiem lub kropką | 89,90 |
| url | tak | Adres tej rzeczy w Twoim sklepie, w domenie sklepu z profilu | https://twojsklep.pl/sweter-12 |
| id | nie | Stały identyfikator sztuki w sklepie. Bez niego używamy adresu oferty | SW-12 |
| zdjecie | nie | Adres https zdjęcia | https://twojsklep.pl/foto/12.jpg |
| rozmiar | nie | Rozmiar z metki | M |
| stan | nie | Stan rzeczy według sklepu | bardzo dobry |
| kategoria | nie | Rodzaj ubrania | swetry |
| dzial | nie | damskie, meskie, dodatki lub dzieciece | damskie |
| marka | nie | Marka z metki | Benetton |
| opis | nie | Opis i wymiary | Szerokość pod pachami 52 cm |
| dostepnosc | nie | Oferta oznaczona jako niedostępna albo out of stock nie jest publikowana | dostepny |
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.