Appearance
Błędy integracji — jak diagnozować
Spis treści
- Token wygasł — kroki naprawy
- Brak uprawnień — co sprawdzić
- Integracja połączona, ale dane nie płyną
- Logi połączenia — gdzie je znaleźć
Token wygasł — kroki naprawy
Token autoryzacyjny to klucz dostępu, który Sembot wykorzystuje do komunikacji z platformami reklamowymi (Google Ads, Microsoft Ads, Meta). Tokeny mają ograniczony czas ważności — gdy wygasną lub zostaną unieważnione, Sembot traci możliwość pobierania danych i wysyłania zmian do platformy.
Jak rozpoznać, że token wygasł
W zakładce Połączenia w menu bocznym przy danej integracji widoczny jest komunikat o błędzie lub ikona ostrzeżenia. Kampanie i dane z platformy przestają się aktualizować.
Kroki naprawy
Utwórz nowe połączenie — przejdź do Ustawienia workspace → Połączenia i dodaj nowe połączenie z daną platformą (Google Ads, Microsoft Ads, Meta, Shopify). Podczas autoryzacji zaloguj się na konto powiązane z kontem reklamowym lub sklepem i zatwierdź wszystkie wymagane uprawnienia.
Przypisz nowe połączenie do projektu — przejdź do zakładki Połączenia w menu bocznym projektu i zmień aktywne połączenie na nowo utworzone.
Sprawdź status — po zapisaniu zmian dane powinny zacząć się aktualizować. Pierwsze pobranie danych może potrwać kilka minut.
Tokeny Google Ads i Microsoft Ads są odświeżane automatycznie przez Sembot w trakcie normalnej pracy. Ręczna re-autoryzacja jest potrzebna tylko wtedy, gdy token został unieważniony — np. po zmianie hasła do konta Google, odebraniu dostępu aplikacji w ustawieniach konta reklamowego lub wygaśnięciu uprawnień po długim czasie nieaktywności.
Brak uprawnień — co sprawdzić
Jeśli użytkownik nie może połączyć Sembota z kontem reklamowym lub sklepem, przyczyną może być brak odpowiednich uprawnień po stronie platformy zewnętrznej. Sembot może łączyć się wyłącznie z kontami i sklepami, do których zalogowany użytkownik ma dostęp.
Jak zweryfikować uprawnienia
Zaloguj się bezpośrednio do platformy (Google Ads, Microsoft Ads, Meta Business Manager, panel Shopify) na konto lub sklep, z którym próbujesz się połączyć z Sembotem.
Sprawdź, czy masz dostęp do konta reklamowego — upewnij się, że konto reklamowe jest widoczne i dostępne. Brak dostępu oznacza, że administrator konta nie przyznał Ci uprawnień.
Skontaktuj się z administratorem konta reklamowego — jeśli nie masz dostępu, poproś administratora konta o przyznanie uprawnień (zalecana rola: administrator lub standardowy użytkownik z możliwością zarządzania kampaniami).
Wykonaj połączenie w Sembocie lub poproś administratora — gdy uprawnienia zostaną przyznane, możesz samodzielnie dodać połączenie w Ustawienia workspace → Połączenia. Alternatywnie możesz poprosić administratora konta reklamowego, aby to on wykonał połączenie z Sembotem — połączenie jest przypisane do użytkownika, który je autoryzował.
Shopify — połączenie można wykonać na trzy sposoby: przez OAuth (przekierowanie do panelu Shopify) lub przez Custom App (wymaga Client ID i Client Secret z panelu Shopify). Każda z tych metod wymaga dostępu właściciela sklepu lub tokenu z odpowiednimi uprawnieniami do odczytu produktów.
Wymagany poziom dostępu dla każdej platformy
| Platforma | Wymagany poziom dostępu |
|---|---|
| Google Ads | Dostęp do konta Google Ads (rola: administrator lub standardowy) |
| Google Merchant Center | Dostęp do konta GMC (rola: administrator lub standardowy) |
| Google Analytics 4 | Dostęp do właściwości GA4 (rola: co najmniej Czytelnik) |
| Google Search Console | Dostęp do właściwości GSC (rola: co najmniej Ograniczony) |
| Microsoft Ads | Dostęp do konta Microsoft Advertising |
| Meta (Facebook) | Rola administratora w Business Managerze z dostępem do konta reklamowego i katalogu produktów |
| Shopify | Właściciel sklepu lub Access Token z uprawnieniami do odczytu produktów i feedów (używany do feedów produktowych, nie kampanii) |
Integracja połączona, ale dane nie płyną
Zdarzają się sytuacje, gdy połączenie w Sembocie widnieje jako aktywne — bez żadnego ostrzeżenia o błędzie — a mimo to dane z platformy reklamowej przestają być pobierane lub kampanie nie synchronizują się. Jest to jeden z trudniejszych do zidentyfikowania problemów, ponieważ na pierwszy rzut oka integracja wygląda na poprawnie skonfigurowaną.
Możliwe przyczyny
Opóźnione wykrycie błędu połączenia
Sembot cyklicznie sprawdza poprawność każdego połączenia (tzw. health check). Jeśli w trakcie normalnej pracy token wygaśnie lub platforma chwilowo odmówi dostępu, Sembot może nie oznaczyć połączenia jako błędnego od razu — dopiero przy kolejnym teście. W efekcie połączenie przez pewien czas wyświetla się jako aktywne, mimo że faktycznie nie działa. W takim przypadku odczekaj kilka minut, odśwież widok połączeń i sprawdź, czy nie pojawiło się oznaczenie błędu.
Brak dostępu do konkretnych zasobów
Połączenie może być autoryzowane poprawnie, ale konto, którym przeprowadzono autoryzację, może nie mieć dostępu do konkretnego konta reklamowego, kampanii lub katalogu produktów. Przykładowo: użytkownik mógł autoryzować dostęp do Google Ads, ale nie do konta reklamowego klienta, które jest podkontem w ramach konta zarządzającego (MCC). W takim przypadku sprawdź, czy konto użyte do autoryzacji ma faktyczny dostęp do wszystkich kont reklamowych, które mają być widoczne w Sembocie.
Konto reklamowe zostało zawieszone lub dezaktywowane
Nawet jeśli połączenie w Sembocie jest aktywne, brak danych może wynikać z tego, że samo konto reklamowe zostało zawieszone bezpośrednio po stronie platformy — np. z powodu problemów z płatnościami, naruszenia regulaminu lub dezaktywacji przez administratora. Sprawdź status konta bezpośrednio w panelu Google Ads, Microsoft Ads lub Meta.
Opóźnienie po ponownej autoryzacji
Jeśli połączenie zostało niedawno odświeżone lub zastąpione nowym, Sembot potrzebuje chwili na wznowienie synchronizacji. Zazwyczaj trwa to kilka minut. Jeśli po 15–20 minutach dane nadal nie pojawiają się, spróbuj usunąć połączenie z projektu i przypisać je ponownie.
Przerwa techniczna po stronie platformy
Google Ads, Microsoft Ads i Meta mogą mieć chwilowe przerwy w działaniu API, które uniemożliwiają Sembotowi pobieranie danych. W takich przypadkach problem rozwiąże się samoistnie po ustąpieniu awarii po stronie platformy.
Kroki diagnostyczne
- Przejdź do Połączenia w menu bocznym i sprawdź, czy przy połączeniu nie pojawiło się oznaczenie błędu — niekiedy wykrycie błędu jest opóźnione o kilka minut.
- Zaloguj się bezpośrednio do platformy reklamowej i sprawdź, czy konto jest aktywne i dane są tam widoczne.
- Sprawdź, czy konto użyte do autoryzacji w Sembocie ma dostęp do wszystkich kont reklamowych, które powinny być synchronizowane.
- Jeśli problem dotyczy konkretnej kampanii, sprawdź jej status w zakładce Kampanie — kampania może mieć własny błąd synchronizacji niezwiązany z połączeniem.
- Jeśli żaden z powyższych kroków nie rozwiązuje problemu — utwórz nowe połączenie zgodnie z krokami opisanymi w sekcji Token wygasł — kroki naprawy.
Logi połączenia — gdzie je znaleźć
Sembot nie udostępnia dedykowanego widoku logów połączeń dla użytkowników w interfejsie aplikacji. Historia zdarzeń technicznych (np. błędów tokenów czy nieudanych wywołań API) jest zapisywana w wewnętrznych logach systemowych, do których dostęp mają wyłącznie administratorzy systemu.
W przypadku powtarzających się problemów z integracją, których nie udaje się rozwiązać krokami opisanymi w tym dokumencie, skontaktuj się z zespołem technicznym Sembota. Podaj następujące informacje, które pozwolą szybko zdiagnozować problem:
- Nazwę projektu i nazwę połączenia
- Platformę reklamową (Google Ads, Microsoft Ads, Meta)
- Przybliżony czas wystąpienia problemu
- Opis objawów — co konkretnie nie działa i od kiedy