Sembot — Dokumentacja

Appearance

Feedy wyjściowe ​

Spis treści ​

Feed wyjściowy (plik wyjściowy) to plik generowany przez Sembot na podstawie produktów z projektu — przefiltrowanych, przetworzonych przez reguły optymalizacji i sformatowanych zgodnie z wymaganiami konkretnego kanału reklamowego. To właśnie ten plik pobiera Google Merchant Center, porównywarka cenowa lub dowolna inna platforma reklamowa.

Aby zarządzać plikami wyjściowymi, przejdź do Ustawienia feedów w lewym menu, a następnie przełącz się na zakładkę Pliki wyjściowe. Nowy plik wyjściowy tworzysz przyciskiem Dodaj nowy plik wyjściowy.

Kreator składa się z sześciu kroków: Kanał → Mapowanie → Produkty → Ustawienia → Akcje → Zapisz.

Krok 1 — Kanał ​

W pierwszym kroku wybierasz dla jakiego kanału reklamowego generowany będzie plik. Sembot oferuje dwa typy kanałów: predefiniowane oraz niestandardowe.

Kanały predefiniowane — Sembot zna strukturę wymaganą przez daną platformę i automatycznie konfiguruje schemat pliku. Wystarczy wybrać kanał, a mapowanie jest gotowe z możliwością ręcznego dostosowania.

KanałOznaczeniePrzeznaczenie
Google Merchant CenterAPI-GOOGLEFeedy produktowe dla Google Shopping i Google Ads
Facebook BusinessAPI-FACEBOOKKatalog produktów Meta (Facebook, Instagram)

Formaty niestandardowe — pusty szablon, w którym samodzielnie definiujesz strukturę pliku. Używany dla platform nieobsługiwanych natywnie przez Sembot: porównywarek cenowych, systemów ERP, Microsoft Advertising i własnych integracji.

FormatOznaczenieKiedy stosować
XMLBlank filePorównywarki (Ceneo, Skąpiec), Microsoft Advertising, własne integracje wymagające XML
CSVBlank fileSystemy ERP, arkusze kalkulacyjne, własne formaty tabelaryczne

Tworzenie feeda wyjściowego dla Google Shopping ​

Wybierz kanał Google Merchant Center (oznaczony jako API-GOOGLE). Jest to kanał predefiniowany — Sembot zna wymaganą strukturę pliku zgodną ze specyfikacją Google i mapuje do niej atrybuty produktów automatycznie. Alternatywnie możesz użyć formatu XML (Blank file), jeśli chcesz ręcznie zdefiniować schemat lub potrzebujesz niestandardowej struktury danych.

Krok 2 — Mapowanie ​

Dla Google Merchant Center mapowanie jest wstępnie skonfigurowane przez Sembot zgodnie ze specyfikacją Google. Widok jest wyświetlany jako podgląd tylko do odczytu. Jeśli chcesz dostosować mapowanie do swojego feedu, użyj przycisku Customize schema — umożliwia ręczne edytowanie przypisań pól.

Krok 3 — Produkty ​

Wskaż które produkty mają znaleźć się w pliku:

  • Wybierz produkty, które powinny znaleźć się w pliku wyjściowym — tabela ze wszystkimi produktami projektu. Używaj filtrów żeby zawęzić zestaw (np. tylko produkty z konkretnej kategorii, marki, o cenie powyżej określonej wartości).
  • Weź pod uwagę widoczność produktów — checkbox aktywny gdy ręcznie ukryłeś wybrane produkty (ustawiając atrybut visibility na hidden w sekcji produktów). Zaznaczenie powoduje, że ukryte produkty nie trafią do pliku wyjściowego.

Krok 4 — Ustawienia ​

W kroku Ustawienia dostępne jest jedno pole:

PoleOpis
NazwaEtykieta widoczna wyłącznie w Sembocie — pomaga rozpoznać plik wyjściowy na liście, gdy projekt ma ich wiele (np. Google Shopping PL — odzież)

Krok 5 — Akcje ​

Opcjonalny krok — pozwala dodać reguły optymalizacji działające wyłącznie na poziomie tego pliku wyjściowego, nie wpływające na pozostałe pliki. Przykład: dodaj parametry UTM do linków produktów tylko w tym feedzie.

Przepływ jest tu pokazany jako:

Produkty w Sembocie
        ↓
    [Akcje]
        ↓
Produkty w tym pliku wyjściowym

Jeśli nie chcesz dodawać akcji, kliknij Następny krok, a następnie Zapisz plik wyjściowy — plik zostanie wygenerowany.

Niestandardowy feed wyjściowy (własny format) ​

Jeśli chcesz wygenerować plik w formacie niestandardowym — dla porównywarki cenowej, systemu ERP, własnej integracji lub platformy nieobsługiwanej natywnie przez Sembot — wybierz kanał XML lub CSV (oznaczone jako Blank file).

Format XML ​

Plik w formacie XML ze strukturą definiowaną ręcznie. Używany dla:

  • Ceneo, Skąpiec i innych polskich porównywarek cenowych
  • Microsoft Advertising / Bing Shopping
  • Własnych systemów wymagających XML

Format CSV ​

Plik tekstowy z danymi rozdzielonymi separatorem. Używany dla:

  • Platform e-commerce wymagających importu CSV
  • Systemów ERP
  • Własnych arkuszy kalkulacyjnych i analiz

Krok 2 — Mapowanie (niestandardowe) ​

Dla formatów XML i CSV mapowanie jest w pełni edytowalne — sam definiujesz strukturę pliku wyjściowego. Kreator pozwala:

  • Dodawać kolumny / węzły XML
  • Przypisywać do nich atrybuty produktów z Sembota
  • Definiować nazwy pól zgodne z wymaganiami docelowej platformy

Kroki 3, 4, 5 — identyczne ​

Wybór produktów, nazwa pliku i opcjonalne akcje konfiguruje się tak samo jak dla kanałów predefiniowanych.

Podgląd wygenerowanego pliku ​

Sembot nie posiada wbudowanego podglądu pliku w interfejsie (podglądu treści XML/CSV). Plik jest generowany automatycznie na serwerze — natychmiast po pierwszym zapisaniu feeda wyjściowego i przy każdym kolejnym cyklu przetwarzania pliku wejściowego.

Jak uzyskać adres URL pliku ​

Po zapisaniu pliku wyjściowego wróć do zakładki Pliki wyjściowe w sekcji Ustawienia feedów. W tabeli każdy plik wyjściowy ma kolumnę URL zawierającą bezpośredni adres do wygenerowanego pliku. Ten adres URL:

  • Kopiujesz i wklejasz do Google Merchant Center jako źródło danych
  • Podajesz w dowolnej innej platformie wymagającej adresu do pobrania pliku produktowego

Adres jest stały — nie zmienia się przy kolejnych aktualizacjach pliku. Każda aktualizacja nadpisuje plik pod tym samym adresem.

Ręczne wymuszenie aktualizacji ​

Jeśli chcesz wygenerować nowy plik bez czekania na harmonogram, kliknij przycisk Zaktualizuj pliki wyjściowe (dostępny na stronie Ustawienia feedów). Sembot wygeneruje wszystkie aktywne pliki wyjściowe projektu. Podczas generowania wyświetlany jest komunikat: "Pliki wyjściowe są w trakcie generowania".

Weryfikacja pliku ​

Żeby sprawdzić zawartość pliku, wklej adres URL w przeglądarce lub pobierz plik i otwórz go w edytorze tekstowym / arkuszu kalkulacyjnym. Możesz też wkleić URL bezpośrednio do narzędzia weryfikacji feedu Google Merchant Center (Feed Diagnostics), które wskaże ewentualne błędy wymagane przez Google.

Historia generowania ​

Przy każdym pliku wyjściowym dostępna jest historia zadań generowania — pokazuje datę, liczbę produktów i status każdego cyklu (oczekuje, w toku, zakończone, błąd). Dostęp przez menu kontekstowe przy wierszu pliku wyjściowego.

Statusy pliku wyjściowego ​

StatusZnaczenie
AktywnyPlik jest generowany w każdym cyklu przetwarzania
NieaktywnyPlik nie jest generowany; adres URL nadal istnieje, ale plik nie jest aktualizowany

Przełącznik aktywności (Czy aktywny) dostępny jest bezpośrednio przy każdym pliku wyjściowym na liście. Dezaktywacja przydaje się gdy chcesz tymczasowo wstrzymać feed bez jego usuwania — np. podczas testowania nowej struktury reguł.

Przed usunięciem pliku wyjściowego Sembot wyświetla potwierdzenie: "Czy na pewno chcesz usunąć plik wyjściowy?" — operacja jest nieodwracalna, a kanał reklamowy przestanie otrzymywać aktualizacje produktów.