Sembot — Dokumentacja

Appearance

Najczęstsze problemy z feedem ​

Spis treści ​

Feed nie synchronizuje się — lista przyczyn i kroków ​

Brak synchronizacji feeda to jeden z najczęstszych problemów zgłaszanych przez użytkowników. Poniżej znajdziesz możliwe przyczyny oraz kroki, które pozwolą zidentyfikować i rozwiązać problem.

Możliwe przyczyny ​

Problemy z dostępnością URL feeda

  • Adres URL feeda jest nieprawidłowy lub zmienił się po stronie sklepu
  • Serwer zwraca błąd HTTP (401 Unauthorized, 403 Forbidden, 404 Not Found, 500 Internal Server Error)
  • Certyfikat SSL wygasł lub jest nieprawidłowy (self-signed)
  • Serwer wymaga uwierzytelniania (Basic Auth, token w nagłówku), którego dane nie zostały zaktualizowane w Sembocie

Problemy z formatem lub rozmiarem pliku

  • Plik nie jest poprawnym XML lub CSV — błędy składniowe uniemożliwiają parsowanie
  • Nieprawidłowe kodowanie znaków (oczekiwane UTF-8, plik zapisany w innym kodowaniu)
  • Plik feeda jest zbyt duży i pobieranie przekracza dopuszczalny limit czasu
  • Plik jest pusty lub zawiera tylko nagłówek bez produktów

Problemy konfiguracyjne

  • Harmonogram synchronizacji jest wyłączony lub ustawiony na „manualnie"
  • W konfiguracji feeda wskazano nieistniejący lub zarchiwizowany profil mapowania

Kroki diagnostyczne ​

  1. Sprawdź URL feeda ręcznie — otwórz adres w przeglądarce lub narzędziu takim jak Postman. Odpowiedź powinna zwrócić poprawny plik XML/CSV z kodem HTTP 200.

  2. Przejdź do historii synchronizacji — w Sembocie otwórz Ustawienia feedów, kliknij ikonę trzech kropek przy feedzie i wybierz Historia. Sprawdź ostatni wpis: czy zakończył się błędem, a jeśli tak — jaki komunikat wyświetla się w szczegółach?

  3. Uruchom synchronizację ręcznie — w Ustawienia feedów kliknij przycisk Pobierz pliki źródłowe przy danym feedzie i obserwuj status. Błąd pojawia się zwykle w ciągu kilku sekund, jeśli problem dotyczy połączenia lub formatu.

  4. Zweryfikuj dane uwierzytelniające — jeśli feed wymaga loginu i hasła, upewnij się, że zostały poprawnie wprowadzone podczas dodawania feeda lub jego edycji w Ustawienia feedów.

  5. Sprawdź, czy sklep korzysta z Cloudflare lub podobnego narzędzia — jeśli tak, serwery Sembot mogą być blokowane przez reguły CDN. Dodaj nasze adresy IP do wyjątków po stronie Cloudflare: 52.28.49.250, 51.77.44.22, 51.77.44.187, 51.38.111.87, 51.38.107.36. Szczegółowe informacje na temat tej konfiguracji znajdziesz w dalszej części tego artykułu.

  6. Sprawdź logi po stronie serwera sklepu — jeśli powyższe kroki nie wskazują przyczyny, poproś administratora sklepu o logi dostępu. Zidentyfikuj, czy Sembot w ogóle wysyła żądania i czy serwer je przyjmuje.

Produkty znikają po synchronizacji ​

Sytuacja, w której produkty były widoczne przed synchronizacją, a po jej zakończeniu znikają z katalogu, zwykle wynika z jednej z poniższych przyczyn.

Możliwe przyczyny ​

Zmiany w źródłowym feedzie

  • Sklep zaktualizował feed i usunął z niego produkty (np. produkty wycofane ze sprzedaży)
  • Zmienił się identyfikator produktu (id) — Sembot traktuje zmieniony ID jako nowy produkt, a stary usuwa
  • Feed źródłowy był tymczasowo niedostępny podczas synchronizacji — Sembot odebrał pusty plik i wyczyścił katalog

Reguły filtrowania i transformacji

  • W konfiguracji feeda są aktywne reguły filtrowania, które wykluczają produkty (np. filtr po dostępności, cenie, kategorii)
  • Mapowanie atrybutów jest nieprawidłowe — wymagane pole (np. availability) jest puste lub ma niedozwoloną wartość, co powoduje odrzucenie produktu
  • Reguły transformacji zawierają warunek usuwający produkty niespełniające kryterium

Ustawienia dostępności

  • Produkty w feedzie mają ustawione availability: out_of_stock — Sembot może być skonfigurowany do pomijania takich produktów
  • Wartość excluded_destination w feedzie wyklucza produkty z Shopping Ads

Jak zdiagnozować ​

  1. Porównaj liczebność przed i po — zanotuj liczbę produktów przed synchronizacją. Po synchronizacji sprawdź, ile produktów jest widocznych w Sembocie.

  2. Tymczasowo wyłącz reguły filtrowania — w Ustawienia reguł dezaktywuj aktywne reguły i uruchom synchronizację ponownie. Jeśli produkty wróciły, problem leży w regułach.

  3. Sprawdź feed źródłowy — pobierz plik feeda bezpośrednio z URL i sprawdź, czy produkty, które znikły, w ogóle w nim figurują.

Feed działa lokalnie, ale nie w Sembocie ​

Sytuacja, w której feed otwiera się poprawnie w przeglądarce lub lokalnych narzędziach, ale Sembot nie może go pobrać, zwykle wynika z różnic w sposobie dostępu do serwera.

Możliwe przyczyny ​

Ograniczenia dostępu po IP

  • Serwer sklepu blokuje żądania spoza dozwolonej listy IP (whitelist)
  • Reguła firewall lub CDN (np. Cloudflare) blokuje ruch z serwerów Sembot
  • Serwer VPS / hosting ma aktywne reguły iptables ograniczające dostęp

Rozwiązanie: Dodaj adresy IP serwerów Sembot do whitelist po stronie serwera lub CDN. Nasze adresy IP to: 52.28.49.250, 51.77.44.22, 51.77.44.187, 51.38.111.87, 51.38.107.36.

Certyfikat SSL

  • Serwer używa certyfikatu self-signed lub wystawionego przez nieuznaną instytucję
  • Certyfikat wygasł, ale przeglądarka ma go w cache

Rozwiązanie: Zainstaluj certyfikat od zaufanego CA (np. Let's Encrypt). Sembot nie obsługuje certyfikatów self-signed ze względów bezpieczeństwa.

Różna treść dla różnych klientów (Geo-blocking lub A/B)

  • CDN serwuje różne wersje feedu w zależności od lokalizacji IP
  • Aktywny mechanizm A/B testów modyfikuje zawartość feeda

Rozwiązanie: Wyłącz geo-targeting i A/B testy dla URL feeda lub utwórz oddzielny, dedykowany URL dla Sembot, wolny od takich mechanizmów.

Limity rate limiting

  • Serwer ogranicza liczbę żądań w jednostce czasu i Sembot odpada na tym limicie

Rozwiązanie: Zwiększ limity dla IP Sembot lub skonfiguruj harmonogram synchronizacji tak, aby rzadziej odpytywał serwer.