Matomo Analytics: konfiguracja i pomoc

Wykonaj kroki opisane w sekcji Szybki start.

Otwórz "Configure" w menedżerze modułów. Potrzebujesz istniejącej instalacji Matomo na własnym serwerze lub witryny Matomo Cloud. Skonfiguruj raportowanie e-commerce witryny w Matomo. Moduł nie instaluje ani nie hostuje Matomo.

Użyj bazowego URL, np. https://analytics.example.com/ lub https://example.com/matomo/. Normalizator dodaje końcowy ukośnik i usuwa końcowe matomo.php lub piwik.php. Odrzuca dane logowania, ciągi zapytań i fragmenty. Przeglądarka ładuje matomo.js; śledzenie przeglądarki i serwera używa matomo.php pod tym adresem bazowym.

Ustaw "Matomo site currency", nawet jeśli zakupy są obsługiwane tylko w przeglądarce. Matomo używa waluty witryny, więc integracja wstrzymuje zdarzenia pieniężne, gdy waluty zamówienia brakuje lub jest inna. Nie przelicza kwot. Skonfiguruj oddzielną odpowiednią witrynę dla innej waluty raportowania zamiast zmieniać oznaczenie kwoty.

Czytnik zgody obsługuje Cookies Revolution, Cookie Banner i wspólne czytniki Cookiebot, OneTrust oraz TCF. Przetestuj mapowanie kategorii i usług. Zgoda jest sprawdzana przy wysyłaniu, a wycofania są trwale zapisywane przez prywatny punkt końcowy. Brak decyzji CMP nie jest traktowany jako pozwolenie. Wykryta obsługiwana CMP obowiązuje również po wyłączeniu przełącznika respektowania zgody modułu.

Każdy standardowy przełącznik ma domyślnie wartość Tak. Wyłącz niepotrzebne zdarzenia.

Bieżąca ścieżka zdarzenia koszyka rejestruje zdarzenie. Nie wysyła sumy aktualizacji koszyka e-commerce tylko dlatego, że kliknięto przycisk dodawania. Wyszukiwane hasła przypominające adresy e-mail lub długie ciągi cyfr są filtrowane.

"Track phone-link clicks", "Track actual chat starts", "Track confirmed contact forms" i "Track product engagement" mają domyślnie wartość Nie. Śledzenie formularza wymaga potwierdzenia serwera. Śledzenie czatu wymaga obsługiwanego powiadomienia o rzeczywistym rozpoczęciu. Mechanizm zaangażowania używa wspólnych wartości domyślnych: 3 interakcje z galerią, 1 zmiana wariantu, 1 interakcja ze szczegółami lub 45 sekund, raz na produkt/sesję, gdy przechowywanie jest dozwolone. Ten formularz nie ma pól progów dla tych wartości.

Śledź zdarzenia niestandardowe ma domyślnie wartość Nie. Pole Niestandardowe reguły zdarzeń jest początkowo puste. Dodaj reguły przed włączeniem przełącznika. Nazwy mogą zawierać od 1 do 64 liter, cyfr, podkreśleń lub łączników. Możesz skonfigurować do 25 różnych nazw.

[
  {"event":"QuoteRequest","trigger":"click","selector":".request-quote","label":"Quote request"},
  {"event":"SalePageView","trigger":"url","url_contains":["/promotions","/sale"],"label":"Sale page"},
  {"event":"ContactPageView","trigger":"controller","controllers":["contact"],"modules":["contactform"],"label":"Contact page"},
  {"event":"ConfiguratorUsed","trigger":"event","dom_event":"mprmtmo:custom","label":"Configurator used"}
]

document.dispatchEvent(new CustomEvent('mprmtmo:custom'));

Użyj selector dla reguły kliknięcia, fragmentów URL dla reguły URL i controllers dla reguły kontrolera. modules może uzupełniać regułę kontrolera. Reguła zdarzenia DOM bez nazwy używa mprmtmo:custom. once ma domyślnie wartość false dla kliknięć i true dla reguł URL, kontrolerów i zdarzeń DOM.

Aktywny mechanizm mapuje reguły niestandardowe na kategorię Matomo Custom, skonfigurowane zdarzenie jako akcję i skonfigurowaną etykietę jako nazwę. Dowolne params i szczegóły zdarzeń DOM nie stają się właściwościami Matomo. Używaj tych skonfigurowanych reguł zamiast starego pomocnika window.mprmtmoTrackEvent.

Moduł zapisuje zgodę kupującego i jego status pracownika oraz dodaje kwalifikujące się zamówienia do kolejki serwerowej. Proces ponownie sprawdza włączenie, własność miejsca docelowego, politykę ruchu wychodzącego, zgodę kupującego, status pracownika i walutę witryny. Jeśli kupujący później wycofa zgodę, zakup z kolejki nie zostanie wysłany.

Każde zamówienie jest wysyłane do danego celu Matomo jednym kanałem. Gdy serwer przejmuje wysyłkę zakupu, przeglądarka go nie wysyła; gdy przeglądarka przejmie wysyłkę jako pierwsza, zakup nie trafia do kolejki serwera.

Identyfikator zakupu wysyłany do Matomo to numeryczny identyfikator zamówienia PrestaShop, a nie jego numer referencyjny. Dane obejmują produkty, przychód i sumę częściową z podatkiem oraz kwoty podatku, wysyłki i rabatu. Są wysyłane tylko wtedy, gdy waluta zamówienia odpowiada "Matomo site currency".

Upewnij się, że wspólny mechanizm cron MPR wykonuje:

task: send_matomo_tracking_api
callable: mprmatomo::cronProcessMatomoTrackingAPIQueue
schedule: every:300
context: any
timeout: 30

Dostawca we wspólnej kolejce konwersji to matomo_tracking_http_api. Proces działa w kontekście każdego włączonego sklepu. Panel gotowości pokazuje liczniki oczekujących, wysyłanych, wysłanych i nieudanych oraz stany wstrzymane, ostateczne, pominięte i niejednoznaczne. Niejednoznaczność sieciowa może wymagać sprawdzenia zamiast ponownego wysyłania w ciemno.

Sprawdź Gotowość śledzenia Matomo pod kątem Site ID, znormalizowanego URL, śledzenia, zgody, reguł niestandardowych, kolejki API i rejestracji procesu. Testuj w przeglądarce klienta z odpowiednim uprawnieniem analitycznym/usługi.

Potwierdź żądanie matomo.js i wywołania trackera. Przetestuj wyświetlenia stron, produktów i kategorii, udaną zmianę koszyka, listę życzeń, proces zamówienia, wyszukiwanie i rejestrację zgodnie z włączonymi przełącznikami. Publiczny HTML zawiera statyczną konfigurację; prywatny punkt końcowy dostarcza politykę odwiedzającego i prywatny kontekst zamówienia/rejestracji.

Złóż zamówienie w skonfigurowanej walucie Matomo. Sprawdź numeryczny identyfikator zamówienia i kwoty. Jeśli włączono wariant awaryjny serwera, sprawdź przyjęcie do kolejki i wynik procesu oraz potwierdź, że kanał przeglądarki nie utworzył duplikatu. Osobno sprawdź odmowę i wycofanie zgody.

Jeśli nic nie jest śledzone, sprawdź przełącznik włączenia, Site ID, URL, własność, lokalne zależności, zgodę i politykę personelu. Usuń inny tracker Matomo, który mógłby powiązać się z innym miejscem docelowym.

Jeśli brakuje zakupów, najpierw sprawdź "Matomo site currency". Następnie sprawdź Śledź zakupy, własność kupującego/koszyka/sesji, pierwotną zgodę i status pracownika kupującego, rezerwację kanału i stan procesu. Zakup o nieznanym stanie zgody jest wstrzymywany.

Jeśli niestandardowy przycisk nie jest śledzony, zaktualizuj selektor i sprawdź regułę. Udane standardowe zdarzenie koszyka wymaga wspólnego sygnału handlowego; samo kliknięcie nie wystarcza. Stary pomocnik i listy selektorów we wcześniejszej dokumentacji nie definiują obecnego detektora zdarzeń standardowych.

Ustaw Włącz Matomo Analytics na Nie i zapisz, aby wstrzymać integrację. Odinstaluj przez menedżer modułów, aby usunąć menu, rejestrację cron i konfigurację modułu. Wspólna tabela kolejki pozostaje, jeśli inny moduł używa pakietu konwersji; w przeciwnym razie pomocnik odinstalowania usuwa ją. Wspólne tabele zgód i kanałów pozostają po odinstalowaniu; nie usuwaj ich ręcznie. Zarządzaj witryną Matomo i danymi historycznymi w Matomo.

Jeśli zrzut referencyjny różni się od zainstalowanej wersji, używaj powyższych nazw ustawień.