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

1

Utwórz bezpłatne konto w StatOn

2

Skopiuj swój unikalny skrypt śledzący z panelu

3

Wklej skrypt przed znacznikiem zamykającym </body> w swojej witrynie

4

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ą