Dokumentacja
Wszystko, czego potrzebujesz, aby zintegrować i skonfigurować StatOn w swojej witrynie.
Pierwsze kroki
Dodaj wm.js jeden raz przed znacznikiem zamykającym </body> i zacznij zbierać dane analityczne w kilka minut.
Instalacja
Utwórz bezpłatne konto w StatOn
Skopiuj swój unikalny skrypt śledzący z panelu
Wklej skrypt przed znacznikiem zamykającym </body> w swojej witrynie
Dane analityczne pojawią się w panelu w ciągu kilku sekund
Skrypt śledzący
Skrypt ładuje się z atrybutem defer, korzysta z klucza witryny i został zaprojektowany z myślą o niewielkim obciążeniu. Sprawdź jego działanie w środowisku produkcyjnym za pomocą własnych testów wydajności.
<script defer src="https://web.staton.app/wm.js"
data-site-key="YOUR_SITE_KEY"></script>
API zgód
Jeśli korzystasz z banera cookie lub platformy CMP, połącz je ze StatOn, wywołując StatOn.setConsent(...) po dokonaniu wyboru przez odwiedzającego.
window.StatOn?.setConsent({ analytics: true, personal: false });
window.StatOn?.setConsent({ analytics: true, personal: true });
window.StatOn?.setConsent({ analytics: false, personal: false });
Uwagi
Wywołuj setConsent(...) wyłącznie po działaniu użytkownika w banerze lub platformie CMP.
W trybie Balanced anonimowa analityka może działać przed wyrażeniem zgody. W trybie Strict EU śledzenie rozpoczyna się dopiero po wyrażeniu zgody na analitykę.
Jeśli odwiedzający później zmieni decyzję, ponownie wywołaj setConsent(...) z nowymi wartościami.
API zdarzeń
Wysyłaj własne zdarzenia przez klienckie API StatOn i klasyfikuj je w ustawieniach witryny.
window.StatOn?.trackEvent({
type: "EVENT_ID"
});
Parametry
type — typ lub identyfikator zdarzenia z ustawień witryny
Typ zdarzenia i jego klasyfikację jako celu określa się w ustawieniach witryny.
Jak korzystać ze zdarzeń
Zdarzenia służą do rejestrowania ważnych działań odwiedzających, takich jak kliknięcia, rejestracje, wysłane formularze, prośby o prezentację produktu czy kolejne kroki składania zamówienia.
1. Wybierz działanie
Wybierz rzeczywiste działanie użytkownika, które warto mierzyć: kliknięcie rejestracji, wysłanie formularza kontaktowego, prośbę o prezentację lub rozpoczęcie składania zamówienia.
2. Nadaj mu czytelną nazwę
Użyj stałego typu lub identyfikatora zdarzenia z ustawień witryny, aby zdarzenie odpowiadało definicji skonfigurowanej w panelu.
3. Zdecyduj, czy to konwersja
W ustawieniach witryny określ, czy zdarzenie ma pozostać zwykłym zdarzeniem, czy ma być traktowane jako cel.
Kiedy używać zdarzeń
- Mierz istotne działania użytkownika, których nie widać w samych odsłonach.
- Używaj konwersji do działań, które Twój zespół uznaje za cel.
- Zwykłe zdarzenia wykorzystuj do interakcji pomocniczych i drobnych kroków.
Gdzie są widoczne zdarzenia
- W dzienniku odwiedzin i szczegółach odwiedzającego.
- W podsumowaniach panelu i widżetach najczęstszych zdarzeń.
- W raportach, jeśli Twój plan je obejmuje.
window.StatOn?.trackEvent({
type: "EVENT_ID"
});
window.StatOn?.trackEvent({
type: "EVENT_ID"
});
Przykład: kliknięcie przycisku
Wyślij zdarzenie, gdy odwiedzający kliknie ważny przycisk wezwania do działania (CTA).
button.addEventListener("click", () => {
window.StatOn?.trackEvent({
type: "EVENT_ID"
});
});
Przykład: atrybut HTML
Użyj atrybutów danych, aby oznaczyć element bez pisania dodatkowego JavaScriptu. W atrybucie podaj identyfikator zdarzenia z ustawień witryny.
<button
data-staton-event="EVENT_ID"
>
Poproś o prezentację
</button>
<button
data-staton-conversion="EVENT_ID"
>
Zarejestruj się
</button>
Zalecany sposób pracy
Wybierz stałą wartość type, np. signup, form_submit, demo_request lub checkout_start.
Używaj typu lub identyfikatora zdarzenia z ustawień witryny, aby zbierane dane odpowiadały definicji utworzonej w panelu.
Ustaw typ celu zdarzenia w ustawieniach witryny, jeśli ma ono być traktowane jako konwersja lub mikrokonwersja w podsumowaniach i raportach.
Zdefiniuj typy zdarzeń w ustawieniach Events, aby aplikacja mogła spójnie je nazywać i porządkować.
Najpierw utwórz definicję zdarzenia w ustawieniach witryny, a następnie używaj tego samego typu lub identyfikatora w kodzie i znacznikach HTML.
W atrybutach data-staton-event i data-staton-conversion używaj identyfikatora zdarzenia wygenerowanego w ustawieniach witryny, a nie jego nazwy wyświetlanej.
Tryby prywatności
StatOn oferuje trzy tryby prywatności. Możesz je zmieniać w dowolnym momencie w ustawieniach panelu.
Cookieless — bez plików cookie i śledzenia IP; prostsza konfiguracja zgód w zależności od obowiązków prawnych.
Balanced — domyślnie bez plików cookie, z dodatkowymi danymi po uzyskaniu zgody odwiedzającego.
Strict EU — bez zbierania danych analitycznych do czasu uzyskania wyraźnej zgody.
Obszary produktu
Po instalacji możesz korzystać z kilku głównych obszarów StatOn, zależnie od planu i konfiguracji witryny.
- Panel z bieżącym ruchem, popularnymi stronami, źródłami i najważniejszymi wskaźnikami
- Dziennik odwiedzin ze stronami docelowymi, urządzeniami, krajami, zaangażowaniem i historią zdarzeń
- Własne zdarzenia i śledzenie konwersji przez klienckie API StatOn
- Raporty, lejki i widoki retencji, gdy Twój plan obejmuje raporty
- Zarządzanie wieloma witrynami, ustawienia śledzenia dla każdej witryny i jawna kontrola dostępu pomocy technicznej
Konfiguracja
Wszystkie ustawienia znajdziesz w panelu w sekcji Settings → Tracking. Możesz skonfigurować:
- Wybór trybu prywatności
- Połączenie banera zgody lub platformy CMP przez StatOn.setConsent(...)
- Zbieranie danych osobowych: IP, User-Agent i geolokalizacji
- Śledzenie UTM, źródeł odesłań, głębokości przewijania, aktywnego czasu, kliknięć wynikających z frustracji oraz danych technicznych i wydajnościowych
- Ścieżki zainteresowania, definicje własnych zdarzeń i klucz zdarzeń serwerowych
- Dostęp pomocy technicznej, okres przechowywania danych i ustawienia zbierania danych dla witryny
Opcje śledzenia
Konfiguracja śledzenia określa, co zbiera skrypt i jakie typy danych są dozwolone dla danej witryny.
Ruch i atrybucja
- Tagi UTM i przypisywanie źródeł ruchu
- Śledzenie źródeł odesłań
- Własne zdarzenia i zdarzenia konwersji
Zaangażowanie i diagnostyka
- Głębokość przewijania
- Aktywny czas na stronie
- Kliknięcia wynikające z frustracji (rage clicks)
- Dane techniczne i wydajnościowe
Zbieranie danych osobowych
- Zbieranie adresów IP
- Zbieranie danych User-Agent
- Zbieranie danych geolokalizacyjnych
Dodatkowe ustawienia witryny
- Klucz zdarzeń serwerowych do przyjmowania zdarzeń z zaufanych źródeł
- Ścieżki zainteresowania w lejkach raportów
- Okres przechowywania danych oraz włączanie i wyłączanie ich zbierania
Ustawienia raportów i lejków
Jeśli Twój plan obejmuje raporty, możesz korzystać z dodatkowych narzędzi poza panelem bieżących danych i dziennikiem odwiedzin.
- Widoki ruchu, źródeł, konwersji i retencji są dostępne w sekcji Reports, jeśli obejmuje je Twój plan
- Ścieżki zainteresowania określają, które prefiksy adresów stron zaliczają się do etapu „Interest” w raportach lejkowych
- Segmenty i sugestie raportów pomagają porządkować zapisane filtry raportowania
- Obecnie raporty można eksportować z aplikacji do plików PDF
Dostęp pomocy technicznej
Dostęp pomocy technicznej jest domyślnie wyłączony. Właściciel witryny może tymczasowo go przyznać w ustawieniach, gdy potrzebuje pomocy w rozwiązaniu problemu.
- Tylko właściciel witryny może przyznać lub cofnąć dostęp pomocy technicznej.
- Przyznanie i cofnięcie dostępu to jawne działania wymagające potwierdzenia w aplikacji.
- Przyznawaj dostęp tylko wtedy, gdy Twój zespół potrzebuje pomocy w zbadaniu konkretnego problemu z witryną.
Eksport danych
Obecnie raporty można eksportować z aplikacji do plików PDF. Inne formaty eksportu nie zostały jeszcze zapowiedziane.
Potrzebujesz pomocy?
Jeśli masz pytania lub potrzebujesz wsparcia, skontaktuj się z naszym zespołem pomocy technicznej.
Skontaktuj się z pomocą techniczną