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, przetransformowanych przez reguły i sformatowanych zgodnie z wymaganiami konkretnego kanału reklamowego. To właśnie ten plik pobiera Google Merchant Center, Meta czy porównywarka cenowa.

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 pięciu kroków: Kanał → Mapowanie → Produkty → Ustawienia → Akcje.

Krok 1 — Kanał ​

W pierwszym kroku wybierasz dla jakiego kanału reklamowego generowany będzie plik. Sembot oferuje kanały predefiniowane (ze strukturą dopasowaną do wymagań platformy) oraz formaty niestandardowe.

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 i mapuje do niej atrybuty produktów automatycznie.

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 ​

PoleOpis
NazwaEtykieta ułatwiająca rozpoznanie pliku wyjściowego (np. Google Shopping PL — odzież)
Wybierz krajKraj docelowy kampanii — wpływa na walutę i rynek w pliku
ChannelKanał Google (Shopping, Display itp.) — wybierany z dostępnych opcji połączenia
ConnectionPołączenie z kontem Google Merchant Center — wybierz z listy aktywnych integracji w formacie: nazwa konta (ID konta) — nazwa połączenia

Jeśli na liście połączeń nie ma konta Google Merchant Center, najpierw skonfiguruj integrację w Ustawienia workspace → Połączenia.

Krok 5 — Akcje ​

Opcjonalny krok — pozwala dodać reguły transformacji 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 Zapisz plik wyjściowy — plik zostanie wygenerowany.

Feed dla Meta (Facebook Catalog) ​

Wybierz kanał Facebook Business (oznaczony jako API-FACEBOOK). Jest to kanał predefiniowany z gotową strukturą XML zgodną z wymaganiami Meta Catalog.

Kroki 2, 3, 5 — identyczne jak dla Google ​

Mapowanie jest predefiniowane, produkty wybierasz tak samo, akcje opcjonalne.

Krok 4 — Ustawienia ​

PoleOpis
NazwaEtykieta ułatwiająca rozpoznanie pliku
ConnectionPołączenie z kontem Facebook Business — wybierz z listy w formacie: nazwa firmy (ID firmy) — nazwa połączenia

Dla kanału Meta nie ma pola wyboru kraju — rynek określa się po stronie Meta Business Manager przy konfiguracji katalogu.

Jeśli na liście nie ma połączenia z Meta, skonfiguruj integrację w Ustawienia workspace → Połączenia, wybierając typ Facebook Ads.

Feed dla Microsoft / Bing ​

Microsoft Advertising (Bing Shopping) nie posiada dedykowanego predefiniowanego kanału w Sembocie. Feed dla tego kanału tworzy się jako niestandardowy plik wyjściowy w formacie XML, odwzorowując strukturę wymaganą przez Microsoft Merchant Center.

Postępuj zgodnie z sekcją poniżej (Niestandardowy feed wyjściowy), wybierając format XML. Struktura pliku dla Microsoft Shopping jest zbliżona do formatu Google Shopping (standard RSS 2.0 z przestrzenią nazw g:), dlatego możesz wzorować się na specyfikacji Microsoft Merchant Center przy definiowaniu schematu.

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:

  • Microsoft Advertising / Bing Shopping
  • Ceneo, Allegro, Skąpiec i inne polskie porównywarki
  • 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 ​

Produkt, nazwa pliku i opcjonalne akcje konfiguruje się tak samo jak dla kanałów predefiniowanych. Pole Nazwa w ustawieniach pomaga rozpoznać pliki wyjściowe, szczególnie gdy projekt ma ich wiele.

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
  • Wklejasz do Meta Business Manager jako link do katalogu
  • 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.