Importowanie danych. Zalecamy podążanie za strukturą XML w celu uniknięcia problemów.

Transkrypt

1 Importowanie danych ShopAlike pobiera produkty ze strony Sklepu Partnerskiego poprzez plik w formacie CSV lub XML. W tym celu, Sklep Partnerski udostępnia bazę danych w formacie CSV lub XML, która zawiera adekwatną informację o produktach. Baza ta musi być udostępniona w sposób ciągły pod ustalonym i niezmiennym adresem URL. ShopAlike.pl pobiera dane w czasie wczesnych godzin porannych w celu posiadania jak najbardziej aktualnej bazy danych. Im bardziej dokładna i szczegółowa informacja zawarta w katalogu produktów, tym lepsze efekty promocji. Ogólne wymagania techniczne, zarówno w przypadku formatu XML jak i CSV: Plik musi być w ważnym formacie CSV lub XML. Zalecany format kodowania - UTF-8. Plik powinien być skompresowane gzip w celu skrócenia czasu pobierania. Plik powinien zawierać wyłącznie produkty będące na stanie w Sklepie Partnerskim. Jeśli po pobraniu zaktualizowanego pliku, informacja o danym produkcie nie będzie się w nim znajdowała, ShopAlike automatycznie zakłada, że produkt ten nie jest w sprzedaży. Możliwe jest, że przedmioty usunięte z pliku (na przykład jeśli są wyprzedane) zostają ponownie wprowadzone (z tym samym nr ID produktu) po kilku dniach, gdy jest on ponownie dostępny. Wymagania zdjęć produktów: Zdjęcia produktów powinny być w możliwie jak największej rozdzielczości. Minimalna rozdzielczość to 250x250 pixeli. Maksymalny możliwy rozmiar to 12 MP. W celu umożliwienia użytkownikom opcji przybliżenia, wymagamy, aby zdjęcia produktów były w rozdzielczości co najmniej 1024x1024 pixeli. Tło zdjęć powinno być białe lub przezroczyste. Akceptowane formaty plików graficznych: JPG, GIF lub PNG. Jeśli to możliwe, preferujemy otrzymanie większej ilości zdjęć jednego produktu. Zostaną one również wyświetlone na ShopAlike. Doświadczenie pokazuje, że dla sklepów posiadających więcej zdjęć jednego produktu, współczynnik konwersji jest znacznie wyższy. Częstotliwość aktualizawonia danych na platformie: Synchonizacja katalopgu produktów na platformie odbywa się conajmniej dwa razy na dobę. Baza danych powinna być aktualizowana codziennie w celu wyświetlania użytkownikom ShopAlike najaktualniejszej oferty. Dalsze wymagania dotyczące formatu plików oraz ich zawartości Uwaga: W razie jakichkolwiek pytań prosimy dotyczących przykładów plików CSV i XML prosimy o kontakt pod adresem partner@shopalike.pl Format CSV Kolumny przedzielone średnikami (;). Pierwsza linia pliku powinna zawsze zawierać tytuł każdej kolumny. Jeśli zawarty w pliku tekst (np. opis produktu) zawiera w treści znak separacji kolumn, cały tekst powinien być zawarty w cudzysłowach ( _ ). Format XML Zalecamy podążanie za strukturą XML w celu uniknięcia problemów.

2 Stosując się do poniższych instrukcji, możemy mieć pewność, że wszelkie informacje o produktach zostaną umieszczone w odpowiednich kolumnach. Zalecamy, wypełnić jak najwięcej pól w celu optymalizacji integracji produktów ze stroną ShopAlike, co pomoże w osiągnięciu wyższego współczynnika konwersji. Kolor, materiał oraz rozmiar są szczególnie ważnymi informacjami, ich obecność pozwoli użytkownikom na pełne użycie filtrów dostepnych na stronie ShopAlike. Produkty pojawią się w odpowiednich filtrach wyszukań tylko wtedy kiedy będą posiadały wymienione powyżej atrybuty. Struktura kolumn/ atrybutów w katalogu produktów Kolumna SKU (ID produktu) EAN Product name (Nazwa produktu) Main category (Kategoria Główna) Subcategory (Podkategoria) Subcategory 2 (Podkategoria 2) Gender (Płeć/Rodzaj) Opis Pole to jest obowiązkowe dla każdego produktu i nie wolno go modyfikować. Numer SKU może zawierać dowolne znaki alfanumeryczne, a jego długość nie może przekraczać 255 znaków. Numer artykułu nie powinien być także używany dla innego produktu w późniejszym czasie. Jeśli muszą Państwo zmienić numery artykułów dla swojego sklepu, prosimy wziąć pod uwagę fakt, że historia przeklików zostanie utracona. Pole opcjonalne. Europejski Numer Produktu (European Article Number - Europejski numer produktu 13 cyfrowy numer, którego klient może użyć żeby wyszukać konkretny produkt) Pole obowiązkowe. Prosimy unikać wewnątrz nazwy informacji, które należą do innych kolumn, jak np. kolor, materiał lub rozmiar. Nazwa produktu powinna być konkretna. Nie mogą być to np. tylko liczby. Pole obowiązkowe. Prosimy o jak najdokładniejszą informację. Jeśli to możliwe, struktura kategorii powinna być zbliżona do struktury kategorii w ShopAlike. Prosimy nie podawać pełnej ścieżki kategorii, jak również nie korzystać z podwójnych określeń, jak "Moda i Obuwie". Przykłady: "Ubrania", "Buty", "Kosmetyki". Pole zalecane. Prosimy o jak najdokładniejszą informację oraz nie stosowanie podwójnych określeń. Jeśli to możliwe, struktura kategorii powinna być zbliżona do struktury kategorii w ShopAlike. Prosimy nie wpisywać kompletnej ścieżki kategorii w tej kolumnie ani nie używać podwójnych kategorii. W przypadku kiedy kategoria główna to "Buty", prosimy nie dodawać np. "Sandały i Klapki" w polu podkategorii. Prawidłowy zapis podkategorii to "Sandały" lub "Klapki". Prosimy upewnić się że kategoria jest związania z produktem, używanie słów kluczowych typu "outlet", "wyprzedaże", "nowości" jest niedozwolone w tym polu. Opcjonalne pole na drugą subkategorię. Prosimy o podanie możliwie najgłębszej kategorii. Jeśli druga podkategoria nie zostanie podana w katalogu, produkty zostaną posortowane zgodnie z kategorią wyżej. Przykład: "Koszulki z długim rękawem" Pole wysoce zalecane, zwłaszcza w kategoriach odzieżowych, butach, dodatakch i biżuterii. Możliwe oznaczenia: - Kobiety, Mężczyźni, Unisex - Chłopcy, Dziewczynki, Dzieci, Niemowlęta Dozwolone jest tylko jedno pole tego typu na produkt. Jeżeli produkt ma pojawiać się zarówno w kategoriach dla chłopców, jak i dziewczynek, powinien być opisany jako Chłopcy & Dziewczynki. Samo ""Dzieci"" nie wystarczy.

3 Rodzaj "Unisex" dozwolony jest tylko dla kategorii "Moda" i nie występuje w "Odzieży dziecięcej". Color (Kolor) Brand (Marka) Material (Materiał) Opis produktu (Product description) Price (Cena) Rodzaje wykorzystywane są także do podziału mebli dziecięcych i dekoracji do pokoju dziecięcego. Pole wysoce zalecane, zwłaszcza w kategoriach odzieżowych, butach, dodatakch i biżuterii. Prosimy podawać dominujący kolor produktu. Dozwolone jest tylko jedno pole tego typu na produkt. Produkty wielokolorowe powinny być opisane jako "wielokolorowy". Prosimy unikać niejednoznacznych określeń, takich jak błoto, arbuz, ostryga, buk, orzech, szampan... Pole wysoce zalecane dla wszelkich markowych produktów. Określa oficjalną nazwę marki lub producenta. Pole wysoce zalecane, zwłaszcza w kategoriach odzieżowych, butach, dodatakch i biżuterii. Określa główny materiał, z jakiego wykonano produkt lub proporcję użytych materiałów. Przykład: "80% Bawełna, 20% Jedwab" lub "Złoto". Prosimy nie wprowadzać tutaj treści należącej do opisu produktu, a jedynie konkretną informację. Pole wysoce zalecane. Dokładny opis produktu. Prosimy o jak najdokładniejsze informacje. Opis nie może zawierać znaczników HTML. Prosimy o wykorzystanie tylko jednej kolumny - bez rozdzielania na opis krótki oraz rozszerzony. Opisy produktów w ShopAlike nie są parsowane przez Google i nie tworzą duplikatów treści dla sklepu! Pole obowiązkowe. Aktualna cena produktu / cena detaliczna. Zalecany format: cyfra dziesiętna, oddzielona przecinkiem, pozbawiona informacji o walucie. Niedozwolone są ceny ujemne oraz ceny z więcej niż dwoma miejscami po przecinku. Old Price (Stara cena) Currency (Waluta) Base price (Cena jednostkowa) Optymalnie waluta powinna być umieszczona w osobnej kolumnie. Jeżeli informacja o walucie znajduje się w tej samej kolumnie co cena, powinna być wprowadzona bez spacji. Przykład: "20,00zł" lub "20.00PLN". Pole obowiązkowe, jeżeli na ShopAlike mają pojawić się informacje o przecenach w sklepie. Wysokość przeceny zostanie automatycznie wyliczona przez ShopAlike na podstawie różnicy starej i nowej ceny. Przeceny mniejsze niż o 5% oraz podwyżki cen nie będą widoczne na ShopAlike. Pole obowiązkowe. Oznaczenie waluty. Przykłady możliwych oznaczeń: "zł", "PLN", "Euro", "EUR", " " Oferujemy możliwość zamiany walut w katalogu, np. EUR na PLN. Pole obowiązkowe dla niektórych kosmetyków i karm dla zwierząt i dla innych produktów, gdzie cena jest zależna od pojemności/wagi (np. kg, m2, litry). Cena za jednostkę (za 1 kg, 1 litr, 100ml, itp.). Dozwolona forma opisowa.

4 Shipping costs (Koszt wysyłki) Prosimy korzystać z tej kolumny zamiast podawania ceny jednostkowej w opisie produktu. Pole wysoce zalecane. Tylko konkretna informacja, np. "gratis od 10 zł", "od 15 zł", "0-20 zł". UWAGA: w tym polu może znaleźć się maksymalnie 30 znaków! Jeżeli wysyłka jest zawsze darmowa, wystarczy wpisać "0 zł" lub "gratis". Delivery time (Czas dostawy) Sizes (Rozmiary) Pole wysoce zalecane. Informacja o szacowanym czasie dostawy produktu. Prosimy nie umieszczać w katalogu produktów niedostępnych. Jeśli produkt jest wyprzedany prosimy o skasowanie go z katalogu produktów. Prosimy o krótką i zwięzłą informację, na przykład: "1-2 dni robocze", "wysyłka w ciągu 24h" Rodzaj: alfanumeryczny Każdy produkt rozmiar i dostepny w różnych rozmiarach potrzebuje dodatkowej linii / oferta dla każdego rozmiaru. Opcja 1 Preferowany zapis produktu z informacją na temat rozmiaru i z różnymi dostępnymi rozmiarami, to osobna linijka dla każdego dostępnego rozmiaru, z unikalnym SKU. Dzięki temu nasz system będzie miał możliwość zgrupowania tych produktów, a tym samym odesłania użytkownika do pożądanego rozmiaru. Opcja 2 Jeśli powyżej opisana opcja nie jest technicznie możliwa do zastosowania, mogą Państwo również dodać wszystkie rozmiary produktu w jednej linijce, w ramach jednego parametru, odzielając je przecinkiem lub średnikiem. Jednakże, w przypadku tej opcji odesłanie użytkownika do pożądanego rozmiaru oraz grupowanie produktów nie będzie możliwe. Przykłady: Opcja 1 SKU Nazwa Produktu Cena Rozmiar Cocktail Dress XS Cocktail Dress S Cocktail Dress M Cocktail Dress L Alien Perfume ml Alien Perfume ml W przypadku zastosowania tej opcji, będą mogli Państwo zobaczyć produkt ze wszystkimi jego dostępnymi rozmiarami zgrupowanymi na jednej stronie. Dla każdego rozmiaru przypisany będzie link prowadzącu do Państwa sklepu.

5 Opcja 2 SKU Nazwa Produktu Cena Rozmiar Cocktail Dress XS,S,M,L Alien Perfume ml Alien Perfume ml W przypadku tej opcji wszystkie rozmiary dostępne dla danego produktu będą wymienione pod napisem Dostępne rozmiary na stronie szczegółowej produktu. Ponadto produkt będzie miał tylko jeden przypisany link prowadzący do Państwa sklepu. *Jeżeli rozmiary nie mogą zostać podane osobno to: - dostępne rozmiary mogą zostać rozdzielone przecinkiem lub średnkiem, np.: "XS,S,M,L" - połówki rozmiarów mogą być oddzielone kropką lub przecinkiem, np.: 41.5 lub 41,5 - prosimy nie używać zakresów liczbowych lub innych, podobnych form i nie wymieniać dostępnych rozmiarów rozdzielonych w tym samym atrybucie, np.: 38-46, 1/3,45,46 -prosimy nie używać tych samych znaków do rodzielenia połówek rozmiarów od innych rozmiarów. Dozwolone formaty: Rozmiary (buty i skarpety): 39, 39.5,40,40.5,41,42 Rozmiary (odzież): uniwersalny, onesize, one size, 36, 38, 40, S, M, L, XL, W32,L32,L34 Rozmiary (meble): D:30 W:60 S:50 lub 200x60x220 lub 80x200, 140x200, 200x220 lub szerokość 220, głębokość 80, wysokość 200 lub D: 200cm; W:190cm lub D50xW90xS150 Rozmiary (rowery): 24 cale, 26 cali

6 Heel height (Wysokość obcasa) Picture URL (Link do zdjęcia) Zalecane dla obuwia. Dokładna wysokość obcasa wyrażona w cm. Przykład: 3,5 cm Pole obowiązkowe. Główny obrazek/zdjęcie produktu. Optymalnie bez modela - sam produkt. Rzeczywiste i wyraźne zdjęcie produktu. Prosimy unikać wszelkich obrazków zastępczych, tablic rozmiarów itp... Minimalny rozmiar (dla działania funkcji przybliżenia): 1024x1024 pixeli. Aux Picture URL 1-3 (Dodatkowe zdjęcie 1-3) Deep URL (Link do strony produktu) CPC (Stawka przekliku) Coupons (Kupony) Pattern (Wzór) Looks (Style) Prosimy unikać duplikatów obrazków w obrębie oferty. Każdy produkt musi posiadać dokładny link do zdjęcia. Dodatkowe zdjęcia produktu. Łącznie można podać 4 dodatkowe zdjęcia - każde w osobnej kolumnie. Ważne: W przypadku braku dodatkowych zdjęć prosimy zostawić to pole puste. W tym polu dozwolone są tylko linki do zdjęć. Pole obowiązkowe. Link do strony ze szczegółami produktu w sklepie internetowym. Prosimy unikać znaków specjalnych w treści linka. Jeśli chcą Państwo sterować stawkami CPC, prosimy wprowadzać je w tej kolumnie. Jeśli chcą Państwo ustalić inne CPC dla konkretnego produktu prosimy o podanie stawki w tym polu (stawkę podajemy używając kropki "." Przykład: 0.20) O zmianie CPC powinien zostać poinformowany zespół ShopAlike.pl, który upewni się że to pole zostało zmapowane prawidłowo. Nie jest to proces automatyczny. W tym polu można wprowadzić dwie rodzaju kuponów/voucherów: 1. Kupon zniżkowy: Prosimy podać prawidłowy kod zniżki dla produktu. Tylko 1 kupon na produkt. 2. Bon prezentowy (bon pieniężny od sklepu): Informację o kuponie należy wprowadzić tak jak normalny produkt. Wartość kuponu, zdjęcie, opis, nazwa. Ważne: Dla bonów prezentowych o różnych wartościach prosimy o podanie różnych grafik. Kupony powinny być ważne conajmniej przez tydzień. Nie akceptujemy kuponów takich jak "darmowa dostawa", "2 w cenie 1", "kupon dla nowych klientów". Jeśli mają Państwo zamiar dodać kupony, prosimy o poinformowanie o tym zespołu ShopAlike.pl, który upewni się że to pole zostało zmapowane prawidłowo. Nie jest to proces automatyczny. Pole opcjonalne. Możliwe wzory: gładki, indiański, kolorowy, pikowany, pleciony, przezroczysty, w grochy, w kratkę, w kropki, w kwiaty, w moro, w panterkę, w paski, w rybie łuski, w siatkę, w tygrysią skórę, w zebrę, w żyrafę, z haftem, z motywem, znoszony. Pole opcjonalne. Możliwe style: kolonialny, nowoczesny, z połyskiem, casual, orientalny, elegancki, emo, gothic, na imprezę, pin up, retro, safari, skaterski, sportowy, vintage, wojskowy.

7 Wysoce wskazane dla kategorii mody. Dla lepszej widoczności Państwa produktów w naszych specjalnych filtrach rozmiarów i styli, należy użyć następujących atrybutów dla przedmiotów: Atrybut Gdzie? Opis Rozmiar miseczki/biustonosza Pole: rozmiar 70A,70B,70C lub 34A, 34B Rozmiar paska Pole: rozmiar 65, 70, 75 (w cm) Rozmiar kapelusza Pole: rozmiar 52,53,54,54 Rozmiar rękawiczek Pole: rozmiar 7,7.5,8,8.5 Rozmiar skarpetek Pole: rozmiar 36-38;38-40;41-42 lub 36,37,38 Czarne rajstopy 50/ czarne rajstopy DEN 50. czarne DEN (grubość rajstop etc.) Pole: nazwa rajstopy 50 DEN Pole: nazwa Sukienka z długimi rękawami, koszulka z rękawami nad Długoś rękawa lub opis łokieć, płaszcz z rękawami 3/4 Pole: nazwa Długość sukienki/spódnicy lub opis długa sukienka, mini spódniczka, sukienka do kolan Pole: nazwa T-shirt z dekoltem w serek, sukienka z dekoltem carmen, Rodzaj dekoltu lub opis bluzka z dekoltem w łódkę Pole: nazwa Wodoodporne lub opis kurtki wodoodporne Pole: nazwa Wiatroszczelne lub opis kurtki wiatroszczelne Pole: nazwa Oddychające lub opis kurtki oddychające

8 Przykład struktury katalogu produktów: <?xml version="1.0" encoding="utf-8"?> <offers> <offer> <itemid>sku</itemid> <deeplink> <name>dokładna nazwa produktu</name> <TopCategory>Kategoria główna</topcategory> <category1>podkategoria</category1> <category_2>szczegółowa kategoria produktu</category_2> <gender>mężczyzna/kobieta/unisex/dziecko/dziewczynka/chłopiec</gender> <color>kolor</color> <brand>marka</brand> <material>materiał</material> <description>opis produktu</description> <price>cena</price> <oldprice>stara cena</oldprice> <currency>waluta</currency> <deliverytime>czas dostawy</deliverytime> <shippingcosts>koszt dostawy</shippingcosts> <size>40 (wystarczy umieścić jeden rozmiar, aby wykorzystać opcję image grouping*)</size> <image> <image2> <image3> <image4> <image5> </offer> </offers> *Image Grouping (jeden rozmiar i różny SKU/ID dla każdej oferty) <?xml version="1.0" encoding="utf-8"?> <offers> <offer> <itemid>1</itemid> <size>34</size> <image> </offer> <offer> <itemid>2</itemid> <size>36</size> <image> </offer> </offers>

9 PODSTAWY Separator kolumn Prosimy korzystać z kreski ( ) oraz unikać znaków:,", $ Jeżeli symbol separacji zostanie użyty w tekście (np. opisie produktu), należy objąć całość tekstu w delimitery (na przykład cudzysłów). Ta sama procedura dotyczy znaku przejścia do nowej linii. Delimiter oraz separator muszą się różnić! Kodowanie znaków Dostępność Zdjęcia oraz linki Zmiany w katalogu Link do katalogu produktów Zabronione produkty Unikanie znaczników HTML Jeżeli jako delimiter wybrano cudzysłów ("), prosimy nie korzystać z tego znaku jako symbolu dla cali. Zalecane UTF-8 Prosimy o umieszczanie w pliku ofertowym TYLKO dostęnych produktów. Jeżeli jakiś produkt został wyprzedany, bądź też z jakiegoś powodu jest niedostępny, prosimy usunąć go z katalogu. Wszystkie zdjęcia oraz linki do stron produktów muszą być prawidłowo skojarzone. Jeśli korzystają Państwo z obrazka zastępczego (np. dla produktów bez zdjęcia), powinien on znajdować się zawsze pod tym samym linkiem. Generalnie prosimy o unikanie w katalogu duplikatów obrazków, nie licząc obrazków zastępczych. Prosimy o niezwłoczne informowanie o dużych zmianach w katalogu produktów, a szczególnie o usuwaniu produktów z katalogu. W miarę możliwości chcemy uniknąć dużych spadków w ilości produktów na naszej platformie. Katalog produktów powinien być regularnie aktualizowany, jednak link do katalogu powinien pozostać niezmienny. Ważne: prosimy o niezwłoczne poinformowanie nas w sytuacji, kiedy zmieni się adres katalogu produktów, ponieważ konieczne będzie ręczne wprowadzenie tej zmiany do systemu. Płyty CD, płyty DVD, gry wideo, książki, soczewki kontaktowe, artykuły spożywczne, alkohole, leki i suplementy, broń oraz imitacje broni, akcesoria erotyczne, komputery, lodówki oraz duże AGD. Prosimy unikać w katalogu produktów znaczników HTML, np. w opisach produktów, nazwach kategorii, produktów itp...

10 Przykład jak infromacje zawarte w feedzie wyświetlane są na platformie ShopAlike 1. W liście produktów w kategorii Buty Buty sportowe- Buty do biegania Wyświetlenie obniżki % - dla produktów pobjętych promocją. Procent obniżki jest obliczny przez nasz system automatycznie bazując na danych starej i obecnej ceny. Obrazek produktu pobrany z pola image URL Nazwa produktu Nazwa sklepu Koszt dostawy, pobrany z pola Shipping cost Na szczegółowej stronie produktu, po kliknięciu na «i» (Informacje), patrz wyżej Opis produktu Dodatkowe zdjęcia produktu Marka oraz nazwa produktu Informacje o sklepie, dostępne rozmiary, metody płatności, czas dostawy Cena i koszty wysyłki