Licznik odwiedzin i blok statystyk - odwiedzający online, wykresy krajów i statystyki w stopce dla PrestaShop

Dowód społeczny, który już masz

Sklep, który wygląda na ruchliwy, sprzedaje lepiej niż taki, który wygląda na pusty. Dane już masz — PrestaShop zapisuje każdą wizytę od dnia instalacji — tylko że leżą one w zapleczu, gdzie żaden klient ich nie zobaczy.

Ten moduł przenosi je na front sklepu: mały blok z liczbami, które faktycznie coś mówią, i dwa wykresy pokazujące, skąd pochodzą Twoi klienci.

Pięć liczb — w stopce albo w kolumnie

Blok pokazuje: kto jest teraz online, wczoraj, dziś, łączną liczbę odwiedzających i łączną liczbę wizyt.

„Online” oznacza wizyty rozpoczęte w ciągu ostatnich 30 minut — tak się to standardowo liczy i warto o tym wiedzieć, żeby ta liczba Cię nie zaskoczyła. „Łączna liczba odwiedzających” zlicza unikalne adresy IP, „łączna liczba wizyt” zlicza każdą wizytę. Te dwie wartości różnią się celowo, a pokazanie obu mówi więcej niż każda z nich osobno.

Przesunięcie historyczne pozwala zasilić obie sumy ruchem sprzed instalacji, dzięki czemu sklep z pięcioletnią historią nie startuje od zera.

To Ty decydujesz, gdzie stanie blok

Trzy przełączniki na stronie konfiguracji: stopka, lewa kolumna, prawa kolumna. Domyślnie włączona jest wyłącznie stopka.

To nie są filtry wyświetlania. Włączenie przełącznika rejestruje hook, a wyłączenie go wyrejestrowuje, więc blok rysuje się dokładnie tam, gdzie sobie tego zażyczyłeś, i w żadnej innej pozycji. Układ dla stopki i układ dla kolumny to osobne szablony, każdy zbudowany pod miejsce, w którym stoi.

Jedno warto wiedzieć, zanim zaczniesz go przenosić: oba wykresy są związane z blokiem w stopce. Jeśli wyłączysz stopkę i zostawisz samą kolumnę, liczniki działają dokładnie tak, jak opisano, ale przyciski Kraje i Kontynenty nie mają czego otworzyć. Zostaw stopkę włączoną, jeśli zależy Ci na wykresach, a kolumn używaj obok niej, a nie zamiast niej.

Radzi sobie na nowoczesnych motywach, nie tylko na Classic

Większość bloków stopki pisano pod motyw Classic i rozjeżdżają się na wszystkim innym. Ten był poprawiany pod prawdziwe motywy przez cztery wydania.

Na Hummingbirdzie i innych motywach PrestaShop 8 i 9 blok odnajduje własne kolumny stopki motywu — PRODUCTS, COMPANY, ACCOUNT, STORE — i dołącza do tego rzędu jako kolumna o równej szerokości, zamiast zawijać się pod nim. Dziedziczy kolor tekstu stopki, zamiast wpisywać na sztywno ciemny odcień, więc pozostaje czytelny także na ciemnej stopce. Klasy responsywne działają zarówno pod Bootstrapem 5, jak i Bootstrapem 4, więc nagłówek nie renderuje się dwa razy, a mobilna harmonijka poprawnie się otwiera i zamyka na obu. Classic, pod który większość takich bloków w ogóle powstawała, celowo pozostaje przez to wszystko nietknięty.

Jedna szorstka krawędź, którą lepiej nazwać wprost, niż pozwolić Ci ją odkryć: drobne ikony bloku pochodzą z Material Icons — czcionki, którą Classic ładuje, a Hummingbird nie. W sklepie na Hummingbirdzie oba przyciski wykresów pokazują nazwy swoich ikon jako tekst, mała strzałka w górę lub w dół obok dzisiejszej liczby robi to samo, a symbole otwierania i zamykania mobilnej harmonijki nie rysują się w ogóle. Liczby, wykresy i układ pozostają tym nietknięte. Wystarczy dodać tę czcionkę do motywu albo podmienić te ikony na ikony własnego motywu.

Dwa wykresy i skąd biorą się ich dane

Przyciski otwierają wykresy pierścieniowe według krajów i według kontynentów — 20 największych krajów plus zbiorcza pozycja „Pozostałe”, a kontynenty na jednym wykresie. Wycinek to suma dziennych liczb unikalnych odwiedzających dla danego miejsca, więc czyta się go jako udział względny, a nie jako pojedynczą, odduplikowaną liczbę osób.

Biblioteka wykresów ładuje się dopiero wtedy, gdy ktoś faktycznie otworzy wykres. Przy każdym innym wyświetleniu strony nie jest w ogóle pobierana. Warto wiedzieć, że pochodzi z publicznego CDN-u, a nie jest dołączona do modułu — co ma znaczenie, jeśli stosujesz restrykcyjną politykę bezpieczeństwa treści (CSP).

Szybki, bo kosztowna praca nie powtarza się przy każdym odwiedzającym

Naiwne podejście to liczenie wszystkiego przy każdym wczytaniu strony. W sklepie z dużą tabelą połączeń to wolne zapytanie na najbardziej obciążonych podstronach.

Zapobiegają temu dwie rzeczy. Wykresy są wstępnie zagregowane: znacznik postępu pilnuje, jak daleko w dzienniku połączeń moduł już doszedł, każde uruchomienie podejmuje pracę tam, gdzie skończyło poprzednie, a nowe wiersze są składane w dzienne sumy według krajów i kontynentów. Rysowanie wykresu czyta te niewielkie dzienne wiersze, nigdy sam dziennik.

Pięć wskaźników KPI jest liczonych z dziennika połączeń, ponieważ narastającej liczby unikalnych odwiedzających nie da się zbudować z dziennych podsumowań bez dryfu. To, co sprawia, że nie jest to kosztowne, to zapisanie wyniku w tabeli pamięci podręcznej i przeliczanie go najwyżej raz na minutę, niezależnie od tego, ile osób jest w sklepie. Za to liczenie płacisz raz na minutę, a nie raz na wyświetlenie strony.

Adres cron — i sklep, który radzi sobie bez niego

Strona konfiguracji daje Ci adres URL crona zabezpieczony 32-znakowym tokenem. Zaplanuj go co godzinę, a agregacja odbywa się w całości w tle, do 20 000 połączeń na jedno uruchomienie.

Jeśli nigdy go nie skonfigurujesz, blok i tak działa: żądanie ze sklepu przetwarza jedną paczkę do 1 000 połączeń za każdym razem, gdy wygaśnie pamięć podręczna KPI, więc sklep z regularnym ruchem sam utrzymuje się mniej więcej na bieżąco. Powodem, dla którego warto zaplanować crona, jest miejsce, w którym wykonuje się praca — w tle, a nie w trakcie wczytywania strony przez klienta — oraz to, że cron nie zależy od tego, czy ktoś akurat odwiedza sklep. Spokojny sklep z dużymi zaległościami nadrobi je z cronem znacznie szybciej niż bez niego.

Geolokalizacja, która działa na Twoim własnym serwerze

Ustalanie kraju odbywa się w całości na Twoim własnym serwerze, w oparciu o dołączoną bazę zakresów IP liczącą 188 686 zakresów, importowaną do zaindeksowanej tabeli.

Rozwiązanie adresu IP to pojedyncze zapytanie po indeksie, a nie skanowanie — moduł korzysta ze standardowego wzorca wyszukiwania zakresu z kluczem głównym na końcu zakresu. Nie ma tu żadnego API geolokalizacyjnego, żadnego limitu zapytań, żadnej zewnętrznej usługi, która może paść albo zacząć naliczać opłaty, i żaden adres IP odwiedzającego nie jest nigdzie wysyłany w celu wzbogacenia danych.

Jedno ograniczenie, o którym trzeba wiedzieć od razu: baza zakresów obejmuje IPv4. Odwiedzający wchodzący po IPv6 są liczeni we wszystkich wskaźnikach KPI, ale nie da się przypisać ich do kraju i pojawiają się na wykresach jako „Unknown”.

Kwestia prywatności, powiedziana wprost

Własne tabele modułu nie zapisują adresów IP odwiedzających. Ani zahaszowanych, ani skróconych — po prostu ich nie ma. Cztery tabele, które moduł tworzy na potrzeby statystyk, nie mają na to żadnej kolumny.

Adresy IP odwiedzających są odczytywane z istniejącej tabeli połączeń PrestaShopa, przetrzymywane w pamięci tylko na tyle długo, by ustalić liczbę unikalnych wejść i kraj, a potem odrzucane. Zapisywana jest liczba wejść na kraj na dzień. Jedyna tabela, która faktycznie zawiera numery IP, to zaimportowana baza referencyjna zakresów adresów — publiczne dane o internecie, a nie o kimkolwiek, kto Cię odwiedził. Pokazywanie odwiedzającemu jego własnego adresu IP w bloku to ustawienie i jest ono domyślnie wyłączone.

Dwie rzeczy lepiej wiedzieć wcześniej niż odkryć później. Ustawienie retencji to udokumentowana liczba, a nie automatyczne czyszczenie — nic nie jest za Ciebie usuwane, a tabelę połączeń powinieneś czyścić własnymi narzędziami PrestaShopa.

Druga to flaga kraju obok lokalizacji odwiedzającego: jest to obrazek pobierany z publicznego CDN-u z flagami. PrestaShop dostarcza lokalne pliki flag tylko dla zainstalowanych u Ciebie języków, więc dla większości krajów przeglądarka rzeczywiście sięga do tego CDN-u — i robi to niezależnie od tego, czy włączyłeś wyświetlanie IP. To niewielkie żądanie o obrazek do strony trzeciej, a nie kanał danych, ale jeśli piszesz informację o plikach cookie i o prywatności, wymień je, zamiast zakładać, że zdarza się rzadko.

Ustawienia, które naprawdę są ustawieniami

Przesunięcie historyczne, czas życia pamięci podręcznej wykresów, interwał odświeżania KPI, wartość retencji, przełącznik IP odwiedzającego i trzy przełączniki rozmieszczenia znajdują się na jednej stronie, z rozsądnymi wartościami domyślnymi: dane wykresów przechowywane w przeglądarce odwiedzającego przez godzinę, liczniki przeliczane najwyżej raz na minutę.

Na tej samej stronie jest narzędzie Testowe IP: wklejasz adres i widzisz dokładnie, do czego moduł go przypisuje, zamiast zgadywać, dlaczego wykres wygląda dziwnie.

Multistore

Każdy agregat, każdy wiersz pamięci podręcznej KPI i każdy znacznik postępu agregacji są kluczowane po sklepie i grupie sklepów, więc każdy sklep w instalacji multistore liczy własny ruch i rysuje własne wykresy. Zaimportowana tabela zakresów IP jest współdzielona, bo nie ma powodu trzymać trzech kopii tych samych danych referencyjnych.

Kompatybilność

PrestaShop od 1.7 do 9, w ośmiu językach: niderlandzkim, angielskim, francuskim, niemieckim, włoskim, polskim, hiszpańskim i tureckim.

Dwa hooki są rejestrowane zawsze — jeden ładuje zasoby bloku, drugi przekazuje mu jego ustawienia — plus te z trzech hooków rozmieszczenia, które włączysz. Żadnych nadpisań i żadnych modyfikacji motywu. Pierwsze uruchomienie wymaga dwóch kroków na stronie konfiguracji: zaimportuj zakresy IP, a następnie odśwież statystyki. Potem moduł radzi sobie sam.

Najczęściej zadawane pytania

Co dokładnie oznacza „online”?

Wizyty rozpoczęte w ciągu ostatnich 30 minut. Odczytywane są z własnego dziennika połączeń PrestaShopa, więc nie potrzeba żadnego dodatkowego śledzenia ani własnego ciasteczka. Odwiedzający, który czyta jedną stronę od 45 minut, nie jest już liczony jako online — dla tego rodzaju licznika to normalne.

Czy spowolni mój sklep?

Wydajność to główna rzecz, wokół której zbudowano obecną wersję, a uczciwa odpowiedź ma dwie części. Dane wykresów są agregowane w tle do niewielkich tabel dziennych podsumowań, więc rysowanie wykresu nigdy nie sięga do dziennika połączeń. Pięć liczb licznika jest wyliczanych z tego dziennika, ale wynik trafia do pamięci podręcznej i domyślnie jest przeliczany najwyżej raz na minutę, niezależnie od tego, jak duży masz ruch. Zwykłe wyświetlenie strony ładuje jeden niewielki arkusz stylów i jeden niewielki skrypt oraz mały obrazek flagi; biblioteka wykresów jest pobierana tylko wtedy, gdy ktoś otworzy wykres. Jedyny przypadek wart uwagi to sklep bez zaplanowanego crona, gdzie wczytanie strony może dodatkowo przetworzyć paczkę do 1 000 połączeń, kiedy wygaśnie pamięć podręczna — a to dokładnie po to istnieje cron, żeby przenieść tę pracę do tła.

Gdzie pojawia się blok?

W stopce, w lewej kolumnie, w prawej kolumnie albo w dowolnej kombinacji — trzy przełączniki na stronie konfiguracji, domyślnie tylko stopka. Włączenie przełącznika rejestruje hook, więc blok pojawia się też w Wygląd → Pozycje, gdzie możesz go ustawić w kolejności względem pozostałych modułów. Jeśli zależy Ci na wykresach, zostaw włączoną stopkę, bo okna wykresów są częścią bloku w stopce; kolumn najlepiej używać obok niej, a nie zamiast niej.

Czy będzie dobrze wyglądał na moim motywie?

Na Classic zawsze wyglądał dobrze. Praca ostatnich czterech wydań polegała na tym, żeby zachowywał się poprawnie na wszystkim innym: na Hummingbirdzie i innych motywach PrestaShop 8 i 9 wykrywa teraz własne kolumny stopki motywu i ustawia się w jednym rzędzie z nimi jako kolumna o równej szerokości, a także dziedziczy kolor tekstu stopki, więc pozostaje czytelny na ciemnej stopce. Wystawia atrybuty zarówno Bootstrapa 4, jak i Bootstrapa 5, więc przełączniki i mobilna harmonijka działają na obu. Jedyna znana luka to czcionka ikon: blok korzysta z Material Icons, które Classic ładuje, a Hummingbird nie, więc na Hummingbirdzie przyciski wykresów i strzałka trendu przy dzisiejszej liczbie pokazują nazwy swoich ikon jako tekst, a symbole harmonijki nie rysują się wcale. Wszystko inne — liczby, wykresy, układ — pozostaje bez zmian, a dodanie tej czcionki do motywu rozwiązuje sprawę.

Czy zapisuje adresy IP moich odwiedzających?

Nie. Cztery tabele, które moduł tworzy na potrzeby statystyk, nie mają w ogóle kolumny na IP. Adresy IP są odczytywane z istniejącej tabeli połączeń PrestaShopa, używane w pamięci do ustalenia liczby unikalnych wejść i kraju, a następnie odrzucane. Zapisywana jest liczba wejść na kraj na dzień. Moduł tworzy jeszcze jedną tabelę, przechowującą zaimportowane zakresy referencyjne — to publiczne dane opisujące internet, a nie cokolwiek na temat Twoich odwiedzających.

Czy ustawienie retencji usuwa stare dane?

Nie i ważne, żeby nie zakładać inaczej. To udokumentowana wartość, którą ustawiasz zgodnie ze swoją polityką prywatności; nic nie jest usuwane automatycznie. Tabelę połączeń czyść własnymi narzędziami PrestaShopa, w takim rytmie, jaki sobie ustalisz.

Czy muszę skonfigurować zadanie cron?

Nie po to, żeby moduł działał. Bez crona żądanie ze sklepu przetwarza jedną paczkę do 1 000 połączeń za każdym razem, gdy wygaśnie pamięć podręczna KPI, więc sklep z regularnym ruchem utrzymuje się w miarę na bieżąco. Crona i tak skonfiguruj: przenosi tę pracę poza wczytywanie stron przez Twoich klientów i działa dalej wtedy, gdy nikt akurat nie odwiedza sklepu — a to właśnie ma znaczenie w spokojnym sklepie z zaległościami do nadrobienia. Strona konfiguracji podaje Ci adres URL wraz z tokenem.

Czy moduł odpytuje zewnętrzną usługę geolokalizacyjną?

Nie. Ustalanie kraju odbywa się w oparciu o bazę 188 686 zakresów IP, która jest dostarczana z modułem i importowana do Twojej własnej bazy danych przy pierwszej konfiguracji. Żadnego API, żadnego limitu, żaden adres IP odwiedzającego nie jest nigdzie wysyłany w celu wzbogacenia danych. Istnieją natomiast dwa żądania zewnętrzne, o których powinieneś wiedzieć. Biblioteka wykresów pochodzi z publicznego CDN-u, ale tylko wtedy, gdy ktoś otworzy wykres. Obrazek z flagą kraju pochodzi z publicznego CDN-u z flagami — i akurat to jest sytuacja normalna, a nie wyjątek: PrestaShop dostarcza lokalne pliki flag tylko dla zainstalowanych u Ciebie języków, więc większość krajów trafia do tego CDN-u, i dzieje się to niezależnie od tego, czy włączyłeś wyświetlanie IP. Wymień je w swojej informacji o prywatności.

Wykresy są puste.

Wykonaj po kolei dwa kroki konfiguracyjne na stronie ustawień: zaimportuj zakresy IP, a potem odświeżaj statystyki, aż zgłosi 100%. Dopóki tabele agregatów są puste, wykresy pokazują jeden wycinek z angielską etykietą „No data”. Liczby KPI działają jeszcze przed tym krokiem i od niego nie zależą.

Każdy odwiedzający pokazuje się jako „Unknown”.

Import zakresów IP nie został ukończony. Uruchom go ponownie ze strony konfiguracji, a następnie sprawdź konkretny adres narzędziem Testowe IP na tej samej stronie — powie Ci dokładnie, do czego moduł go przypisał. Odwiedzający wchodzący po IPv6 są liczeni, ale nie da się przypisać ich do kraju.

Moje sumy wyglądają na zbyt niskie jak na tak stary sklep.

Ustaw raz przesunięcie historycznej liczby wizyt. Jest ono doliczane do łącznej liczby odwiedzających i łącznej liczby wizyt, dzięki czemu licznik odzwierciedla ruch sprzed instalacji modułu. Celowo nie wpływa na wartości online, dziś i wczoraj, które są zawsze bieżące.

Czy mogę pokazywać odwiedzającym ich własny adres IP?

Tak, jest na to przełącznik i jest on domyślnie wyłączony, bo w większości sklepów lepiej go tak zostawić. Po włączeniu w bloku pojawia się wiersz pokazujący odwiedzającemu jego własny adres obok flagi jego kraju.

Jaka jest różnica między łączną liczbą odwiedzających a łączną liczbą wizyt?

Łączna liczba wizyt zlicza każdą wizytę. Łączna liczba odwiedzających zlicza unikalne adresy IP. Kilka osób za jednym łączem biurowym wygląda jak jeden odwiedzający, a jedna osoba na zmiennym IP komórkowym może wyglądać jak kilku — to nieodłączna cecha takiego sposobu liczenia i właśnie dlatego moduł pokazuje obie liczby, zamiast twierdzić, że któraś z nich jest jedyną prawdą.

Czy działa w instalacji multistore?

Tak. Każdy agregat, każda zbuforowana wartość i każdy znacznik postępu są zapisywane osobno dla sklepu i grupy sklepów, więc każdy sklep liczy własny ruch i rysuje własne wykresy. Zaimportowana tabela referencyjna zakresów IP jest między nimi współdzielona.