Dodaj skrypt śledzący
Zainstaluj tag skryptu swojej witryny i sprawdź, czy zdarzenia docierają. Przed włączeniem zbierania danych przejrzyj swoje wymagania dotyczące zgody.
1. Skopiuj swój kod
Zaloguj się, otwórz witrynę i przejdź do Settings → Installation → Scripts (Ustawienia → Instalacja → Skrypty). Twój kod wygląda tak, z Twoim własnym tokenem witryny. Pokazany tutaj styl Minimal (Minimalny) odczytuje opcje z Installation → Dashboard; styl Explicit (Jawny) zapisuje te same opcje jako atrybuty skryptu (zobacz Opcje skryptu).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Pozostaw adresy skryptu i API na https://app.seean.io, jak pokazano powyżej, chyba że w Installation włączono zbieranie z własnej domeny; wtedy dla obu używana jest wygenerowana nazwa hosta <slug>-collect.seean.io lub aktywna niestandardowa domena zbierania należąca do Ciebie. Istniejący kod używający tych adresów nie wymaga zmian, gdy Seean aktualizuje swoją infrastrukturę.
2. Wklej go przed </head>
Użyj wspólnego dokumentu HTML lub głównego układu dla każdej strony, którą chcesz mierzyć. Postępuj zgodnie z przewodnikiem dla swojej platformy, aby poprawnie umieścić kod. Zainstaluj skrypt śledzący raz: użycie zarówno układu, jak i menedżera tagów może liczyć wizyty podwójnie.
Skrypt śledzący obserwuje obsługiwaną nawigację History API, np. / → /pricing. Parametry zapytania nie są częścią ścieżki strony; fragmenty po # są ignorowane, chyba że ustawisz data-hash="true". Zmieniona otagowana kampania lub wygasła sesja może nadal rozpocząć nową sesję i ponownie zliczyć tę samą ścieżkę. Wczytuj skrypt śledzący jako klasyczny skrypt zewnętrzny; nie importuj go do pakietu aplikacji ani nie dodawaj type="module".
3. Zweryfikuj
Otwórz opublikowaną witrynę w zwykłej karcie przeglądarki, a następnie sprawdź Settings → Installation → Setup health (Stan konfiguracji) dla odpowiedniej witryny. Last pageview received (Ostatnia odebrana odsłona) pokazuje czas najnowszej zachowanej odsłony; przed pierwszą odsłoną Installation verified (Instalacja zweryfikowana) pokazuje, kiedy opublikowana strona ostatnio przeszła sprawdzenie. Użyj Check installation (Sprawdź instalację), aby zbadać opublikowaną stronę główną pod kątem skryptu śledzącego, tokenu i polityki bezpieczeństwa. Seean sprawdza też opublikowaną stronę główną automatycznie w tle (co minutę w pierwszym dniu witryny), więc instalacja zostaje zweryfikowana od razu po opublikowaniu kodu, nawet gdy panel jest zamknięty. Baner w Przeglądzie znika wtedy bez czekania na wizytę.
Odwołanie w źródle lub stara wizyta nie dowodzą, że najnowsze wdrożenie działa. Dopasuj nową ścieżkę strony i czas w widoku Events, korzystając z kontroli instalacji. Przewodnik po diagnostyce konfiguracji wyjaśnia wyniki, uprawnienia i ograniczenia.
Opcje skryptu
Installation → Dashboard przechowuje opcje śledzenia witryny: kampanie UTM (wł.), ścieżki z fragmentem # (wył.), Web Vitals (wł.), konwersje automatyczne (wł. dla nowych i nigdy nieskonfigurowanych witryn), dziennik debugowania (wył.) i nazwy hostów międzydomenowych. Save tracking options (Zapisz opcje śledzenia) je zapisuje; minimalny kod stosuje je przy następnym wczytaniu strony. Styl kodu Explicit zapisuje te same wybory jako atrybuty:
| Atrybut | Domyślnie | Działanie |
|---|---|---|
data-conversions="true" |
wył. w surowym HTML | Wczytuje raz na dokument włączone automatyczne szablony konwersji. Wygenerowane jawne kody zawierają go, gdy włączone są konwersje automatyczne. |
data-hash="true" |
wył. | Liczy zmiany location.hash jako odsłony i raportuje ścieżkę z fragmentem, np. /docs#install. |
data-utm="off" |
wł. | Przestaje odczytywać utm_source, utm_medium i utm_campaign; otagowany link nie rozpoczyna już nowej sesji. |
data-vitals="off" |
wł. | Całkowicie pomija pomiar Web Vitals (brak obserwatorów wydajności). |
data-debug="true" |
wył. | console.debug każdego ładunku przed wysłaniem. Bezpieczne, gdy konsola jest niedostępna. |
data-domains="a.com,b.com" |
wył. | Przekazywanie międzydomenowe: linki do wymienionych hostów (i ich subdomen) przenoszą identyfikator odwiedzającego, a strona docelowa przyjmuje przychodzący identyfikator. |
Gdy którykolwiek z tych atrybutów jest obecny, opcje panelu są ignorowane dla tej strony. Szczegóły i wartości domyślne: Skrypt i opcje śledzenia.
Co wysyła skrypt śledzący
| Pole | Czym jest |
|---|---|
| path | ścieżka strony, bez parametrów zapytania (z fragmentem, gdy data-hash jest włączone) |
| hostname | mierzona witryna |
| referrer | adres URL odsyłający przeglądarki; moduł zbierający zachowuje tylko jego nazwę hosta |
| timezone | zapasowe źródło kraju, gdy brzeg sieci nie podaje żadnego |
| visitorId, sessionId | domyślne tożsamości są wyprowadzane na serwerze dla witryny i dnia UTC; opcjonalne przekazywanie międzydomenowe przenosi tożsamość w pamięci sesji z tego samego dnia |
| campaign | źródło, medium, kampania, słowo kluczowe i treść UTM, gdy są obecne, chyba że data-utm="off" |
| click id | nazwa parametru identyfikatora kliknięcia reklamy obecnego w adresie URL strony docelowej (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid); wartość nigdy nie jest odczytywana. Wyłączone przy data-utm="off" |
| title | document.title, pierwsze 200 znaków |
| uid | Twój własny identyfikator użytkownika po seean.identify(id), zapisywany tylko wtedy, gdy dla witryny włączono Identify users |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP i TTFB; późniejsze pomiary mogą aktualizować próbkę. Wyłączone przy data-vitals="off" |
Moduł zbierający odczytuje kraj, region i miasto z nagłówków brzegu sieci żądania, używa user agenta do kategorii przeglądarki, systemu operacyjnego i urządzenia, rejestruje pierwszy tag Accept-Language przeglądarki jako język odwiedzającego i może użyć regionu tego języka jako zapasowego źródła kraju. Adres IP jest porównywany wyłącznie z regułami wykluczeń i nigdy nie jest zapisywany. Parametry zapytania inne niż pola UTM i nazwa identyfikatora kliknięcia nigdy nie są zbierane.
Domyślne śledzenie używa dziennego hasza serwerowego w zakresie witryny, bez plików cookie i trwałej pamięci pomiarowej w przeglądarce. Opcjonalne przekazywanie międzydomenowe używa sessionStorage z tego samego dnia. Zbieranie zatrzymuje się przy Do Not Track, Global Privacy Control lub rezygnacji w przeglądarce opisanej w Wykluczeniach. Tam, gdzie obowiązuje zgoda lub rezygnacja, steruj wczytywaniem skryptu przez mechanizm zgody swojej witryny. Zobacz techniczną prywatność oraz pamięć i zgodę.
Programowanie lokalne
Skrypt śledzący ignoruje localhost i 127.0.0.1, chyba że dodasz data-local do tagu skryptu. Użyj osobnej witryny/tokenu Seean dla ruchu testowego i skopiuj adres API z kodu tej witryny. Zautomatyzowane przeglądarki, Do Not Track, Global Privacy Control i rezygnacja w przeglądarce mogą nadal zatrzymywać zbieranie; data-local nie wyłącza tych kontroli.
Usuwanie lub aktualizacja instalacji
Usuń skrypt z układu lub menedżera tagów i opublikuj zmianę, aby zatrzymać przyszłe zbieranie z tej instalacji. Istniejące raporty pozostają. Wymiana tokenu śledzenia witryny natychmiast unieważnia jej stare kody; zaktualizuj każdą instalację nowym tokenem. Zobacz ustawienia witryny.
Coś jest niejasne? Skontaktuj się z pomocą.