Pomoc i rozwiązywanie problemów

Napisz na hello@seean.io, podając domenę witryny, dotknięty ekran, wybrany okres i to, czego się spodziewałeś.

Skorzystaj z FAQ w typowych pytaniach o produkt, z dostępności funkcji, aby sprawdzić obsługiwane integracje, oraz z rozliczeń i zużycia w sprawie limitów i dostępu do faktur.

Nie docierają odsłony

1. Potwierdź, że wdrożona strona zawiera poprawny token witryny i adres API z Ustawień.
2. Sprawdź, czy przeglądarka może wczytać /k.js i wysłać żądanie zbierania.
3. Sprawdź mechanizmy zgody, preferencje prywatności przeglądarki, blokady i skonfigurowane wykluczenia.
4. Sprawdź, czy okres próbny wygasł lub zużycie osiągnęło limit.
5. Otwórz Settings → Installation → Setup health (Ustawienia → Instalacja → Stan konfiguracji), które pokazuje ostatnio odebraną odsłonę i oferuje Check installation (Sprawdź instalację).

Nie wymieniaj tokenu jako pierwszego kroku rozwiązywania problemów: wymiana unieważnia istniejące instalacje.

Sprawdzanie opublikowanej konfiguracji

Seean sprawdza automatycznie opublikowaną stronę główną każdej jeszcze niezweryfikowanej witryny, bez otwierania panelu przez kogokolwiek: co minutę w pierwszym dniu witryny, co 5 minut przez resztę pierwszego tygodnia, co 30 minut przez resztę pierwszego miesiąca i co 6 godzin później. Zmiana domeny lub wymiana tokenu witryny uruchamia ten harmonogram od nowa, od tempa pierwszego dnia. Pierwsze sprawdzenie, które znajdzie kod, token i zezwalającą politykę bezpieczeństwa, natychmiast weryfikuje witrynę; wizyta nie jest potrzebna. Zweryfikowane witryny i witryny już odbierające zdarzenia nie są dalej odpytywane; zresetowanie statystyk niezweryfikowanej witryny przywraca ją do tego harmonogramu.

Baner instalacji w pustym Przeglądzie również uruchamia jedno sprawdzenie po otwarciu. Właściciele i administratorzy witryny mogą też użyć Settings → Installation → Setup health → Check installation. Odczytuje ono opublikowaną stronę główną i sprawdza wygenerowany adres skryptu śledzącego, odwołanie do tokenu witryny oraz politykę bezpieczeństwa (nagłówek HTTP i każdy tag <meta http-equiv="Content-Security-Policy"> w sekcji head strony). Wyniki pojawiają się na ekranie bez przeładowania. Jeśli połączenie z Seean zostanie przerwane, ekran ostrzega, że odebrane dane mogą być nieaktualne, i wyłącza nowe sprawdzenia do czasu ponownego połączenia:

• Security policy blocks Seean wymienia blokującą dyrektywę skryptu lub połączenia oraz źródła do dodania. Połącz je z istniejącą polityką i opublikuj zmianę; zachowaj pozostałe uprawnienia aplikacji.
• Seean is installed oznacza, że adres skryptu śledzącego i token witryny pojawiają się w źródle strony, a polityka bezpieczeństwa (nagłówek i tag meta) zezwala na skrypt i żądania zbierania. Wizyta nie jest wymagana. Witryna jest natychmiast oznaczana jako zainstalowana: baner instalacji w Przeglądzie zamyka się, Your sites pokazuje Installed, a Stan konfiguracji pokazuje Installation verified z czasem sprawdzenia. Raporty wypełniają się w miarę napływu odwiedzających; blokady lub wybory dotyczące zgody mogą nadal uniemożliwiać zliczenie poszczególnych odwiedzających.
• Tracker reference found — confirm in a browser oznacza, że adres i token są obecne, ale polityka używa reguł nonce, hash lub strict-dynamic, których sprawdzenie nie może ocenić, albo sekcja head strony jest zbyt długa do odczytu (zobacz limity poniżej). Wcześniejsza weryfikacja jest zachowywana; wykonaj weryfikację w przeglądarce.
• Setup could not be confirmed może oznaczać brak lub inny kod, wczytywanie po stronie klienta lub wczytywanie zależne od zgody. Wykonaj weryfikację w przeglądarce, zanim uznasz, że skryptu brakuje.
• Could not inspect wyjaśnia niedostępną stronę, błąd HTTP, zbyt dużą odpowiedź lub nieobsługiwany adres. Spróbuj ponownie po naprawieniu opublikowanej strony lub użyj weryfikacji w przeglądarce.
• Last pageview received pokazuje najnowszą zachowaną odsłonę tej witryny, niezależnie od wybranego okresu raportu. Stary znacznik czasu jest dowodem wcześniejszego zbierania, a nie dowodem, że bieżąca instalacja działa. Bez odsłon Installation verified pokazuje ostatnie udane sprawdzenie, a Not installed yet oznacza, że żadne sprawdzenie nie zweryfikowało opublikowanej strony.

Późniejsze sprawdzenie, które stwierdzi brak kodu lub tokenu albo politykę blokującą Seean, usuwa weryfikację, a baner wraca, gdy witryna nie ma danych. Zmiana domeny witryny, wymiana jej tokenu lub zmiana nazwy hosta modułu zbierającego używanej przez wygenerowany kod również usuwa weryfikację i uruchamia ponownie automatyczne sprawdzenia. Zmiany modułu zbierającego obejmują włączenie/wyłączenie zbierania z własnej domeny oraz aktywację, utratę lub odłączenie niestandardowej domeny zbierania; zmiana zapasowej nazwy hosta, gdy aktywna domena niestandardowa nadal serwuje kod, nie resetuje weryfikacji. Opublikuj bieżący kod i jego źródła polityki bezpieczeństwa przed ponownym sprawdzeniem. Istniejące dane analityczne są zachowywane. Sprawdzenie, które nie może odczytać strony, pozostawia poprzedni wynik bez zmian.

Ręczny lub automatyczny wynik dla wcześniejszej konfiguracji instalacji nie może zweryfikować nowej ani usunąć jej zakolejkowanego sprawdzenia. Jeśli ręczne sprawdzenie zgłasza Installation settings or a newer check changed during this check, przejrzyj bieżący wygenerowany kod i spróbuj ponownie; Seean nie oznacza przestarzałego wyniku jako zainstalowany.

Ręczne sprawdzenia są ograniczone do dwóch na minutę na zalogowanego użytkownika we wszystkich jego witrynach; sprawdzenia automatyczne nie wliczają się do tego limitu. Moduł sprawdzający odczytuje wyłącznie publiczną stronę główną HTTPS skonfigurowanej domeny, z maksymalnie trzema przekierowaniami w obrębie tej domeny i jej adresu www, łącznym limitem czasu 12 sekund i limitem odpowiedzi 2 MiB. Adresy prywatne, witryny z adresem IP w postaci literału, niestandardowe porty, witryny wyłącznie IPv6 oraz skompresowane odpowiedzi ignorujące żądanie nieskompresowanego HTML nie są sprawdzane.

To sprawdzenie źródła/nagłówków po stronie serwera: nie wykonuje JavaScriptu, nie omija zgody ani blokad przeglądarki, nie bada innych tras i nie dowodzi działania polityk nonce/hash/strict-dynamic. Sekcja head dłuższa niż 16 KB, która nadal ma tag meta http-equiv poza tym punktem, lub polityki w tagach meta dłuższe niż 16 KB nie mogą zostać potwierdzone tym sprawdzeniem i wymagają weryfikacji w przeglądarce. Różne odpowiedzi CDN i polityki na innych stronach wymagają weryfikacji w przeglądarce. Sprawdza nazwę hosta, której wygenerowany kod obecnie używa — Twoją własną domenę zbierania, gdy jest aktywna, w przeciwnym razie adres zbierania z własnej domeny lub app.seean.io; starszy standardowy kod może nadal działać po włączeniu zbierania z własnej domeny. Samo sprawdzenie nie wysyła zdarzeń analitycznych i nie przechowuje pobranego HTML; zachowywane są tylko czas weryfikacji, czas ostatniego zastosowanego sprawdzenia i czas następnego automatycznego sprawdzenia. Przeglądający nie mogą uruchamiać sprawdzeń instalacji.

Weryfikacja instalacji

1. Otwórz opublikowaną witrynę w zwykłej karcie przeglądarki. W razie potrzeby przejdź proces zgody na analitykę w witrynie. Szanuj wybory prywatności swoich odwiedzających.
2. W narzędziach deweloperskich przeglądarki otwórz Network. Przeładuj stronę i poszukaj https://app.seean.io/k.js. Powinien wczytać się poprawnie, być może z pamięci podręcznej przeglądarki.
3. Poszukaj żądania POST do https://app.seean.io/api/collect, jeśli używasz standardowego kodu produkcyjnego. Jego treść JSON zawiera Twój publiczny token w t i ścieżkę strony w p. Sama odpowiedź 204 nie jest dowodem zapisania danych: wykluczone żądania również mogą zakończyć się bez odpowiedzi błędu.
4. W Seean otwórz Events, wybierz zakres obejmujący teraźniejszość i odśwież listę. Dopasuj ścieżkę strony i czas. Sprawdź też Settings → Installation → Setup health, aby zobaczyć czas ostatniej odebranej odsłony.
5. Przejdź do innej ścieżki, a następnie użyj Wstecz i Dalej. Potwierdź każdą zamierzoną odsłonę w Events. Parametry zapytania i fragmenty nie są odrębnymi ścieżkami stron; nowa kampania lub sesja może nadal ponownie zliczyć tę samą ścieżkę. Kolejne powiadomienia dla niezmienionej ścieżki w tej samej sesji są deduplikowane; opuszczenie ścieżki i powrót może wygenerować kolejną odsłonę.

Podczas testów używaj osobnej witryny/tokenu, aby Twoje kontrole nie zawyżały raportów klienta. Udane pobranie skryptu, działający podgląd strony lub stare dane w Stanie konfiguracji nie dowodzą, że nowa instalacja działa.

Skrypt się wczytuje, ale nie pojawia się żądanie zbierania

Sprawdź rezygnację w przeglądarce, Do Not Track, Global Privacy Control lub zautomatyzowaną przeglądarkę. window.seean może istnieć z nieaktywnymi metodami, gdy zbieranie jest wyłączone, więc sprawdzenie samego obiektu nie wystarcza. Wczytuj kod jako klasyczny skrypt zewnętrzny, z data-site i data-api na tym samym elemencie.

Jeśli witryna używa Content Security Policy, zezwól na https://app.seean.io w obowiązującej polityce skryptów oraz w connect-src. Jeśli definiujesz script-src-elem, także musi zezwalać na skrypt śledzący. Połącz te źródła z istniejącą polityką; nie zastępuj jej reszty ani nie włączaj wszystkich źródeł. Wbudowane programy wczytujące używane przez menedżera tagów mogą dodatkowo wymagać istniejącej polityki nonce/hash. Zobacz opcje skryptu.

Żądania kończą się błędem lub liczby są podwojone

Nieznany/wymieniony token może dać 404; limit rozliczeniowy lub nieaktywny plan może zatrzymać zbieranie. Sprawdź rozliczenia i token we wdrożonym HTML. Zablokowane żądanie lub błąd CSP jest widoczny w narzędziach deweloperskich przeglądarki. Postępuj zgodnie z wykluczeniami, gdy żądania się powodzą, ale brakuje oczekiwanych danych.

Przeszukaj zarówno pliki projektu, jak i kontenery menedżera tagów pod kątem k.js. Zachowaj jedną instalację i pozwól jej obserwować obsługiwaną nawigację. Dodanie wyzwalacza History Change, który przeładowuje cały skrypt śledzący, lub ręczne wysyłanie pageview przy każdej nawigacji może podwajać liczby.

Testy lokalne lub automatyczne

Localhost i 127.0.0.1 wymagają data-local. Automatyzacja przeglądarki lub ustawienia prywatności mogą celowo zatrzymać zbieranie. Test interfejsu w przeglądarce nie jest dowodem, że prawdziwa odsłona została przyjęta.

Raporty wyglądają inaczej

Dopasuj witrynę, zakres dat, filtry i obliczony okres. Widok Na żywo używa okien dwu- i trzydziestominutowych; Przegląd zwykle obejmuje dłuższy interwał. Szacunki krajów i importy zapytań Google mają własne ograniczenia.

Analiza nie została uruchomiona

Każda strona analityczna uruchamia jedno obliczenie dla swojego okresu. Komunikat nad stroną wyjaśnia odmowę: Your current analyses are still running czeka na trwające; Too many analyses were started for this website. Try again in N seconds oznacza, że budżet uruchomień (120 na minutę we wszystkich witrynach właściciela konta i członków zespołu; seria dwudziestu i trzydzieści na minutę na witrynę współdzielone przez linki udostępniania, widżety i odwiedzających demo, którzy nie są członkami demo) został wyczerpany, a strona ponawia raz samodzielnie po oczekiwaniu. Could not start this analysis. Please retry to nieoczekiwane niepowodzenie; konsola przeglądarki rejestruje identyfikator żądania serwera dla pomocy technicznej. Retry analysis uruchamia natychmiast ponownie.

Analityka w tle i podziały na żądanie współdzielą ograniczony budżet wykonania: dwa obliczenia w całej usłudze, najwyżej jedno na właściciela witryny. Obejmuje to widok Na żywo i lekki licznik online. Obliczenie w tle czeka, gdy budżet jest zajęty; rozwinięty podział może zamiast tego pokazać Analytics is busy. Retry the breakdown shortly. Użyj Retry breakdown po zakończeniu innego obliczenia. Ogranicza to konkurującą pracę analityczną, ale nie gwarantuje stałej latencji zbierania ani nieograniczonej pojemności. Wczytywane lub nieudane obliczenie nie jest liczbą zerową.

Gdy obliczenie się kończy, następne kwalifikowane oczekujące obliczenie natychmiast otrzymuje swoje miejsce. Otwarcie kilku witryn na jednym koncie nie dodaje stałego opóźnienia ponownej próby po każdym ukończonym obliczeniu. Trwające obliczenie na tym koncie nadal musi się najpierw zakończyć; przygotowywanie zaakceptowanych danych źródłowych, awarie magazynu i migawki odzyskiwania mogą opóźnić gotowość raportu.

Bezpieczny kontakt

W razie potrzeby dołącz zrzuty ekranu błędów. Nie wysyłaj haseł, kodów weryfikacyjnych, sekretów przychodów ani wyeksportowanych danych odwiedzających, chyba że uzgodniono konkretny bezpieczny proces pomocy. Pytania o rozliczenia i konto można opisać bez ujawniania tych wartości.

Coś jest niejasne? Skontaktuj się z pomocą.