Tutorial: Wdrożenie wymiarów niestandardowych (Custom Dimensions) w Matomo

Wymiary niestandardowe uzupełniają dane Matomo o cechy opisowe, np. poziom subskrypcji dla wizyty albo kategorię artykułu dla odsłony. Wymiar służy do grupowania danych; nie jest metryką, taką jak liczba lub czas trwania. Konfiguracja wymaga właściwego ID, odpowiedniego zakresu i wartości dostępnej podczas wysyłania żądania.

1. Utworzenie i aktywacja wymiaru

W Administracji sekcja Websites lub Measurables prowadzi do Custom Dimensions. Dla właściwej witryny powstaje nazwany, aktywny wymiar. Wygenerowane numeryczne ID jest odwołaniem w kodzie śledzącym. Ten sam numer w innej witrynie może oznaczać inną cechę.

• Zakres wizyty: Jedna wartość opisuje wizytę. Jeśli wartość zmieni się podczas wizyty, obowiązuje ostatnia zarejestrowana. Przejście ze Standard do Premium nie zachowuje więc obu etapów jako osobnych wartości wizyty.
• Zakres akcji: Wartość opisuje pojedynczą odsłonę, zdarzenie, pobranie lub link wychodzący. Poszczególne akcje mogą mieć różne wartości.

2. Wartość razem z odpowiednim żądaniem

Przykład zakłada, że ID 1 oznacza aktywny wymiar wizyty dla poziomu subskrypcji. Kod należy umieścić przed odsłoną w już skonfigurowanym trackerze Matomo. premium jest wartością przykładową, a rzeczywista wartość musi wynikać ze stanu aplikacji.

var _paq = window._paq = window._paq || [];
_paq.push(['setCustomDimension', 1, 'premium']);
_paq.push(['trackPageView']);

Przykład zastępuje istniejące wywołanie odsłony w tym miejscu. Dodanie drugiego wywołania policzyłoby stronę dwukrotnie.

setCustomDimension samo nie wysyła żądania. Ustawiona wartość trafia do kolejnych żądań śledzących podczas tego samego załadowania strony, aż do zmiany lub usunięcia przez deleteCustomDimension. Dotyczy to również wymiarów akcji: zakres akcji nie czyści automatycznie wartości w trackerze JavaScript po jednym zdarzeniu. Dla pojedynczej akcji Matomo obsługuje także dane wymiaru przekazywane tylko w konkretnym żądaniu. Usunięcie wartości trackera nie usuwa wcześniej zapisanych danych serwera.

3. Konfiguracja Matomo Tag Manager

W Matomo Tag Manager powstaje zmienna odczytująca wartość, np. pole warstwy danych. W Matomo Configuration Variable, w sekcji Custom Dimensions, należy wpisać ID wymiaru i przypisać zmienną jako Value. Tag śledzący Matomo musi korzystać z tej konfiguracji. Podgląd powinien potwierdzić dostępność wartości przy uruchomieniu właściwego tagu.

4. Weryfikacja przed porównaniem raportów

Kontrolowany test obejmuje ID witryny, aktywne ID wymiaru i wysłany parametr dimension1. Potrzebne są co najmniej dwie wartości oraz przypadek braku wartości. Dla wymiaru akcji kolejna akcja pozwala wykryć przypadkowe przenoszenie poprzedniej wartości. Dla wymiaru wizyty test zmiany w jednej wizycie potwierdza zachowanie ostatniej wartości.

Wymiary niestandardowe mają własne raporty i mogą służyć do tworzenia segmentów oraz, przy odpowiednim zakresie funkcji, Custom Reports. Dostępne metryki zależą od zakresu i zainstalowanych funkcji produktu. Dowolnego dodatkowego wymiaru nie można zakładać w każdym raporcie standardowym. Nowe żądania mogą pojawić się w dzienniku wizyt wcześniej niż w przetworzonych raportach zbiorczych.

Fikcyjny przykład: poziomy subskrypcji

Poniższe liczby ilustrują wyłącznie układ raportu. Nie są wynikami pomiaru ani dowodem, że subskrypcja Premium powoduje dłuższe wizyty. Odsłony i średni czas wizyty mierzą różne zjawiska; definicja czasu i okres raportowania muszą być spójne.

Stałe etykiety kategorii ułatwiają porównywanie raportów. Adresy e-mail, nazwiska ani niekontrolowany tekst nie są potrzebne do odróżniania planów. Odpowiednią wartością planu jest np. premium, zamiast identyfikatora osobowego.