> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SDK Analytics
> Przywróć analizę odwiedzających do swojego panelu Komerza dzięki naszemu lekkiemu skryptowi analytics
## Przegląd
SDK Analytics firmy Komerza pozwala śledzić zachowanie odwiedzających na Twojej niestandardowej stronie internetowej i przeglądać analizy bezpośrednio w panelu Komerza. Dzięki jednemu tagowi skryptu uzyskasz kompleksowe informacje o odwiedzających, w tym widoki stron, sesje użytkowników, śledzenie konwersji i wiele więcej.
Uzyskaj dostęp do analiz odwiedzających w panelu Komerza
## Funkcje
Automatyczne zarządzanie zgodą na pliki cookie z ciasteczkami niezbędnymi/opcjonalnymi
Wystarczy dołączyć skrypt z identyfikatorem sklepu - bez skomplikowanej
konfiguracji
Przeglądaj dane odwiedzających natychmiast w swoim panelu Komerza
Szanuje prywatność użytkowników dzięki przejrzystej zgodzie na pliki cookie i izolacji Shadow DOM
## Szybki start
### Integracja z jednym skryptem
Dodaj skrypt analytics do swoich stron HTML wraz z identyfikatorem sklepu:
```html theme={null}
Mój sklep
Witamy w moim sklepie
```
Zastąp `your-store-id` rzeczywistym identyfikatorem sklepu Komerza ze swojego
panelu. Skrypt analytics automatycznie obsługuje zgodność z RODO, wyświetlając
odwiedzającym informację o zgodzie na pliki cookie.
## Przepływ zgody na pliki cookie
Gdy odwiedzający po raz pierwszy przybywa na Twoją stronę:
1. **Natychmiastowe wyświetlenie strony**: Widok strony tylko z IP jest rejestrowany natychmiast (zgodność z RODO)
2. **Wyświetlenie informacji o plikach cookie**: Zgodna z RODO informacja pojawia się w prawym dolnym rogu
3. **Licznik 20 sekund**: Bez odpowiedzi automatycznie aktywuje się śledzenie „Tylko wymagane"
4. **Wybór użytkownika**: Odwiedzający może w dowolnym momencie wybrać „Tylko wymagane" lub „Akceptuj wszystkie"
5. **Przechowywanie preferencji**: Wybór jest zapamiętywany dla przyszłych wizyt (wygaśnięcie pliku cookie po 1 godzinie)
* Losowy identyfikator odwiedzającego (bez profilowania)
* Typ urządzenia i nazwa przeglądarki
* Informacje o odsyłaczu
* Śledzenie sesji (wygaśnięcie po 1 godzinie)
* Brak śledzenia między sesjami
* Odcisk przeglądarki dla stabilnego identyfikatora odwiedzającego
* Pełne śledzenie analytics
* Rozszerzone informacje o zachowaniu użytkowników
* Śledzenie konwersji i celów
* Szczegółowe metryki wydajności
* Śledzenie między sesjami
## Ręczna kontrola zgody
Jeśli chcesz programowo kontrolować zgodę (np. niestandardowy baner plików cookie):
```html theme={null}
```
## Funkcje prywatności
* **Losowe identyfikatory odwiedzających**: Śledzenie tylko wymagane używa losowych identyfikatorów kryptograficznych (bez profilowania)
* **Krótki czas wygaśnięcia**: Wszystkie pliki cookie wygasają po 1 godzinie
* **Brak śledzenia między domenami**: Pliki cookie są specyficzne dla witryny
* **Anonimizacja IP**: Niezbędne wyświetlenia stron są tylko IP, bez identyfikatora odwiedzającego
## Polityka bezpieczeństwa treści (CSP)
W przypadku witryn z nagłówkami CSP dodaj do swojej konfiguracji CSP:
```http theme={null}
Content-Security-Policy:
script-src 'self' https://cdn.komerza.com;
connect-src 'self' https://m-api.komerza.com;
```
Skrypt analytics nie wymaga integracji nonce CSP, ponieważ ładuje się z
zaufanego CDN. Upewnij się jednak, że `https://cdn.komerza.com` jest w
dyrektywie `script-src`, a `https://m-api.komerza.com` w dyrektywie
`connect-src`.
## Przeglądanie analiz
Po zainstalowaniu skryptu i pojawieniu się odwiedzających na Twojej stronie:
1. **Logowanie do panelu**: Odwiedź [dashboard.komerza.com](https://dashboard.komerza.com)
2. **Przejdź do Analytics odwiedzających**: Kliknij sekcję „Odwiedzający"
3. **Wyświetl statystyki**: Zobacz dane odwiedzających w czasie rzeczywistym i historyczne
4. **Śledź wydajność**: Monitoruj współczynniki konwersji i zachowanie użytkowników
## Kompatybilność z blokadami reklam
Skrypt analytics używa nazwy pliku `ka.min.js`, która jest mniej prawdopodobna do zablokowania przez blokady reklam w porównaniu do nazw plików zawierających „analytics" lub „tracking". Jednak niektóre agresywne blokady mogą nadal blokować żądania analytics.
## Wsparcie
Uzyskaj dostęp do swoich analiz odwiedzających i raportów