Appearance
Dodawanie feeda wejściowego
Spis treści
Aby dodać nowy plik źródłowy, przejdź do Ustawienia feedów w lewym menu, a następnie kliknij przycisk Dodaj nowy plik źródłowy. Otworzy się dwuetapowy kreator:
- Krok 1 — Dane wejściowe: podajesz skąd Sembot ma pobierać plik
- Krok 2 — Mapowanie pól: wskazujesz jak kolumny z pliku mają być interpretowane przez Sembot
Krok 1 — Dane wejściowe
Nazwa źródła
Pierwsze pole to Nazwa źródła — etykieta widoczna na liście plików źródłowych. Pomaga rozpoznać pliki gdy projekt ma ich wiele (np. Feed główny PL, Feed promocyjny, Feed uzupełniający EN). Nazwa jest wyłącznie wewnętrzna i nie trafia do kanałów reklamowych.
Import z URL (HTTP, FTP)
Najczęstsza metoda. W polu Adres do pliku URL wklejasz bezpośredni link do pliku feedu — Sembot będzie go pobierał automatycznie zgodnie z ustawionym harmonogramem.
Obsługiwane protokoły:
- HTTP / HTTPS — standardowy adres www do pliku (np.
https://sklep.pl/feed.xml) - FTP — adres serwera FTP (np.
ftp://ftp.sklep.pl/feedy/produkty.csv)
Ważne — adresy IP do białej listy: Niektóre platformy (np. IdoSell) blokują pobieranie przez zewnętrzne serwery. Jeśli plik nie jest dostępny publicznie, należy dodać adresy IP Sembota do wyjątków na serwerze lub w panelu platformy e-commerce:
52.28.49.250,51.77.44.22,51.77.44.187,51.38.111.87,51.38.107.36W razie problemów formularz wyświetla ten komunikat automatycznie.
Jeśli dostęp do pliku jest chroniony hasłem, rozwiń sekcję Zaawansowane i uzupełnij pola Login (dostęp do pliku) oraz Hasło (dostęp do pliku). Dane te są szyfrowane i służą wyłącznie do autoryzacji podczas pobierania.
Import z pliku (CSV, XML)
Sembot obsługuje trzy formaty plików źródłowych:
| Format | Kiedy stosować |
|---|---|
| XML | Najczęstszy format feedów produktowych — eksportowany przez większość platform e-commerce (Shoper, IdoSell, WooCommerce, Magento) |
| CSV | Plik tekstowy z danymi rozdzielonymi separatorem — popularny przy eksportach z systemów ERP lub arkuszy kalkulacyjnych |
| Arkusz Google | Publiczny arkusz Google Sheets z danymi produktowymi — tylko arkusze dostępne publicznie (bez logowania) |
Formatu JSON Sembot nie obsługuje jako bezpośredniego pliku źródłowego. Jeśli dane są dostępne tylko przez API JSON, użyj opcji Połączenie przez API opisanej poniżej.
Wybór formatu pliku
Pole Typ pliku w sekcji Zaawansowane (domyślnie ukrytej) pozwala wybrać format:
- Autodetekcja (domyślnie) — Sembot sam rozpozna format na podstawie struktury pliku. W większości przypadków to wystarczy.
- XML — wymuś parsowanie jako XML
- CSV — wymuś parsowanie jako CSV
- Arkusz Google — dla publicznych arkuszy Google Sheets
Opcje formatu CSV
Gdy format pliku to CSV (lub Autodetekcja przy pliku CSV), dostępne są dwa dodatkowe pola:
Separator kolumn CSV — znak rozdzielający kolumny w pliku:
| Opcja | Symbol | Kiedy używać |
|---|---|---|
| Tabulator | TAB | Eksporty z Excela, systemów ERP |
| Średnik | ; | Pliki polskie i europejskie |
| Przecinek | , | Pliki anglojęzyczne i US |
| Pipe | | | Niestandardowe formaty |
CSV wyróżnik wartości — znak otaczający wartości zawierające separator lub znaki specjalne:
"(cudzysłów) — domyślny, najczęściej spotykany'(apostrof) — rzadziej używany
Połączenie przez API
Zamiast podawać URL, możesz wybrać gotowe Połączenie skonfigurowane wcześniej w sekcji Integracje. Kliknij pole Wybierz źródło połączenia — pojawi się lista aktywnych połączeń przypiętych do projektu (np. Shopify, własne API sklepu).
Ta opcja jest alternatywą dla URL — jedno pole wyklucza drugie. Separator między opcjami w formularzu jest oznaczony jako LUB.
Połączenie przez API jest przydatne gdy:
- Platforma e-commerce nie generuje statycznego pliku feedu, ale udostępnia dane przez własne API
- Chcesz użyć uwierzytelnionego połączenia OAuth skonfigurowanego w Integracjach (zamiast loginu i hasła w URL)
- Pobierasz dane z platformy, dla której Sembot ma dedykowaną integrację
Jeśli na liście nie ma potrzebnego połączenia, najpierw skonfiguruj je w Ustawienia workspace → Połączenia, a następnie wróć do dodawania feeda.
Feed uzupełniający
Checkbox Feed uzupełniający oznacza, że dodawany plik nie jest głównym źródłem danych, lecz rozszerza lub nadpisuje wybrane atrybuty feeda głównego. Typowe zastosowania:
- Osobny plik z opisami marketingowymi (gdy opisy w sklepie są zbyt techniczne)
- Plik z dodatkowymi zdjęciami produktów
- Arkusz z cenami promocyjnymi lub sezonowymi nadpisującymi ceny z głównego feeda
Przy nieoznaczonym checkboxie feed traktowany jest jako Główny.
Przejście do mapowania
Po uzupełnieniu formularza kliknij Ustaw mapowanie — Sembot pobierze plik w tle i przejdzie do kroku drugiego. Pobranie może chwilę potrwać przy dużych plikach.
Krok 2 — Mapowanie pól
Mapowanie to etap, w którym wskazujesz Sembotowi jak interpretować kolumny z Twojego pliku. Sembot odczytał już strukturę pliku i wyświetla tabelę z wykrytymi kolumnami.
Jak działa mapowanie
Każdy wiersz tabeli to jedno powiązanie: kolumna z Twojego pliku → atrybut w Sembocie.
Tabela ma cztery kolumny:
| Kolumna | Co pokazuje |
|---|---|
| Oryginalne atrybuty źródła | Nazwy kolumn wykryte w Twoim pliku (np. product_name, ean, price) |
| → | Kierunek mapowania |
| Atrybuty Sembota | Standardowe atrybuty Sembota, na które mapujesz dane (np. Tytuł, EAN, Cena) |
| Przykładowe wartości | Pierwsza wartość z danej kolumny z pobranego pliku — podgląd rzeczywistych danych |
Podgląd danych przed zapisem
Kolumna Przykładowe wartości pełni rolę podglądu — zanim zapiszesz mapowanie, widzisz co faktycznie kryje się w każdej kolumnie Twojego pliku. Dzięki temu możesz zweryfikować, czy kolumna price zawiera liczby, ean zawiera 13-cyfrowe kody, a image_link zawiera poprawne adresy URL.
To jedyny moment w procesie, gdy możesz ocenić jakość danych źródłowych przed ich zapisaniem w Sembocie.
Zmapowane i niezmapowane atrybuty
Sembot automatycznie próbuje dopasować kolumny ze źródła do własnych atrybutów na podstawie nazw. Wyniki pokazuje w dwóch sekcjach:
Zmapowane atrybuty — kolumny, które Sembot rozpoznał i dopasował automatycznie. Możesz je zmienić rozwijając listę przy danym atrybucie.
Niezmapowane atrybuty (widoczne tylko przy edycji istniejącego feeda) — kolumny z pliku, które nie zostały jeszcze przypisane do żadnego atrybutu Sembota. Obok nazwy widoczna jest ikona ostrzeżenia. Kliknięcie ikony + przy niezmapowanym atrybucie przenosi go do sekcji zmapowanych.
Komunikat przy niezmapowanych atrybutach: "Te atrybuty nie zostały jeszcze zmapowane. Kliknij ikonę plusa, aby dodać je do mapowania."
Tworzenie własnych atrybutów
Jeśli Twój plik zawiera niestandardowe kolumny, których nie ma na liście atrybutów Sembota (np. kolekcja, material_podeszwy), możesz je dodać jako własne atrybuty. W polu wyboru atrybutu Sembota pojawi się opcja Utwórz Sembotowe pole atrybutu — po jej wybraniu nowy atrybut zostanie zarejestrowany i będzie dostępny m.in. w regułach produktowych.
Analogicznie, jeśli kolumna w pliku ma niestandardową nazwę trudną do zidentyfikowania, możesz użyć opcji Utwórz oryginalne pole atrybutu.
Zapis mapowania
Po skonfigurowaniu wszystkich powiązań kliknij Zapisz nowy kanał wejściowy. Sembot zatwierdzi mapowanie i rozpocznie pierwsze przetwarzanie danych.
Strona potwierdzenia
Po zapisaniu mapowania Sembot wyświetla stronę potwierdzenia z informacją:
"Dodawanie feeda zakończone sukcesem. Twój plik feeda jest teraz pobierany. Proces ten może zająć kilka minut."
Z tego ekranu możesz przejść do kolejnych kroków:
| Przycisk | Co robi |
|---|---|
| Powrót do strony feeda | Wraca do listy plików źródłowych projektu |
| Dodaj kolejny feed wyjściowy | Przechodzi do kreatora pliku wyjściowego (np. dla Google Shopping) |
| Dodaj nowy feed wejściowy | Zaczyna od nowa proces dodawania kolejnego pliku źródłowego |
| Lista projektów | Przechodzi do listy wszystkich projektów |
| Utwórz kampanię | Przechodzi do tworzenia kampanii reklamowej |
| Połącz konto Google | Przechodzi do konfiguracji połączenia z Google Ads |