Microsoft Clarity: konfiguracja i pomoc

Wykonaj kroki opisane w sekcji Szybki start.

Otwórz moduł przez "Configure". Śledzenie jest początkowo wyłączone. Projekt Clarity musi już istnieć.

Zgoda jest sprawdzana przed każdym zdarzeniem, a jej zmiany są uwzględniane podczas wizyty. Nie musisz przeładowywać strony tylko dlatego, że prawidłowa zgoda dotarła po jej wyrenderowaniu. Moduł obsługuje sygnały zgód z Cookies Revolution, Cookie Banner, Cookiebot, OneTrust i TCF. Przetestuj decyzję kategorii i usługi dostarczaną przez własną konfigurację zgód. Brak decyzji lub brak możliwości jej odczytu nie oznacza zgody. Obsługiwane narzędzie zgód wykryte w sklepie jest nadal respektowane po wyłączeniu ustawienia zgody w module.

Zdarzenia Clarity

Każdy z tych przełączników domyślnie ma wartość Tak. Wyłącz przełącznik, jeśli nie chcesz danego zdarzenia.

Otrzymujesz tylko nazwy zdarzeń. Ta wersja nie dołącza do nich ID produktów, numerów zamówień, sum, wyszukiwanych fraz ani własnych tagów sesji. Zdarzenia koszyka i listy życzeń są wysyłane po udanym dodaniu, a nie przy kliknięciu przycisku.

Ustawienia kontaktu i zaangażowania

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" i "Track product engagement" domyślnie mają wartość Nie. Włącz tylko skonfigurowane sygnały, które możesz przetestować. Kliknięcia telefonu korzystają z sygnałów kontaktu. Rozpoczęcie czatu wymaga obsługiwanego powiadomienia o faktycznym starcie. Formularze wymagają potwierdzenia sukcesu z serwera zamiast kliknięcia przycisku wysyłania.

Użyj "Product engagement thresholds", aby dostosować JSON. Domyślnie wymagane są 3 interakcje z galerią, 1 zmiana wariantu, 1 interakcja ze szczegółami lub 45 sekund na stronie. Domyślne ograniczenie częstotliwości opcji to 1500 ms. Progi galerii, wariantów i szczegółów przyjmują od 1 do 20; czas od 5 do 600 sekund; ograniczenie od 250 do 60000 ms. Zachowaj nazwę high_intent_product_engagement. Domyślny tracker zapisuje ją raz na produkt/sesję, gdy przechowywanie danych śledzenia jest dozwolone.

"Track custom events" domyślnie ma wartość Nie. Pole Reguły zdarzeń niestandardowych jest początkowo puste. Włącz przełącznik dopiero po dodaniu co najmniej jednej prawidłowej reguły.

Używaj różnych nazw zawierających od 1 do 64 liter, cyfr, podkreśleń lub łączników. Możesz skonfigurować do 15 różnych nazw. Wbudowane nazwy zdarzeń handlowych i kontaktowych są zastrzeżone. Własne reguły wysyłają tylko skonfigurowaną nazwę. Tagi, atrybuty danych i szczegóły zdarzeń DOM nie są przekazywane jako właściwości.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img,.images-container img"},
  {"event":"LandingPageViewed","trigger":"url","contains":["/promo","utm_campaign=sale"]},
  {"event":"CheckoutControllerViewed","trigger":"controller","controllers":["order","orderopc","checkout"]},
  {"event":"SizeGuideOpened","trigger":"event","dom_event":"mprclarity:sizeguide"}
]

Reguła kliknięcia wymaga selector. Reguła URL wymaga contains; fragmenty są alternatywami. Reguła kontrolera wymaga controllers. Jeśli podasz też modules, warunki kontrolera i modułu muszą pasować jednocześnie. Reguła DOM używa dom_event, domyślnie mprclarity:custom, jeśli pominięto. once domyślnie wynosi false dla kliknięć oraz true dla reguł URL, kontrolera i DOM.

Wywołaj skonfigurowane zdarzenie DOM z motywu:

document.dispatchEvent(new CustomEvent('mprclarity:sizeguide'));

Aktualizuj selektory po zmianach motywu. Używaj skonfigurowanych reguł zamiast starego helpera window.mprclarityTrack.

Otwórz dozwoloną stronę w przeglądarce klienta. Po udzieleniu zgody analitycznej sprawdź żądanie do https://www.clarity.ms/tag/PROJECT_ID. Sprawdź zdarzenia zawierające tylko nazwy dla wyświetlenia produktu, udanego dodania do koszyka, wyszukiwania, rejestracji i testowego zamówienia. Przejrzyj sesje i nagrania w Clarity; PrestaShop nie przechowuje tych raportów.

Osobno sprawdź odmowę i wycofanie zgody. Śledzenie przestrzega zasad wysyłania danych w sklepie i integracji przypisanej do projektu Clarity. Inna integracja przypisana do tego samego projektu Clarity, niezależnie ładowany tag Clarity, wykluczenia pracowników lub niebezpieczne URL stron mogą wstrzymać śledzenie. Publiczne strony zawierają tylko ustawienia śledzenia. Oczekujące zdarzenia rejestracji są pobierane prywatnie dla każdego odwiedzającego.

Jeśli tag się nie ładuje, sprawdź "Enable Microsoft Clarity", format identyfikatora projektu i tabelę gotowości. Testuj poza przeglądarką panelu administracyjnego. Sprawdź zgodę analityczną i usługową, lokalne pliki JavaScript, blokowane żądania i podwójne mechanizmy ładowania Clarity.

Jeśli brakuje zdarzeń koszyka lub listy życzeń, potwierdź, że udana akcja generuje oczekiwany sygnał sukcesu. Mocno zmodyfikowany motyw może wymagać integracji. Używaj własnych reguł do osobnych, zamierzonych pomiarów kliknięć.

Jeśli nie możesz zapisać reguł, usuń zastrzeżone nazwy, błędny JSON lub nieobsługiwane wyzwalacze. Jeśli po przeładowaniu potwierdzenia brakuje znacznika zakupu, jednorazowa rezerwacja dla zamówienia mogła już zostać wykorzystana. Moduł nie ma serwerowego API konwersji, workera ponowień ani zadania cron do wysyłki zdarzeń Clarity.

Ustaw "Enable Microsoft Clarity" na Nie i zapisz, aby wstrzymać integrację z zachowaniem ustawień. Aby ją usunąć, odinstaluj przez "Module Manager". Odinstalowanie usuwa menu i konfigurację modułu. Projektem Clarity i nagraniami nadal zarządzasz w Clarity.

Korzystaj z powyższych nazw ustawień, gdy zrzut różni się od zainstalowanej wersji.