Matomo Analytics

Wprowadzenie

Matomo (dawniej Piwik) to narzędzie analityczne o otwartym kodzie źródłowym, które zapewnia kompleksowy wgląd w wykorzystanie stron internetowych i aplikacji. Gromadzi i przechowuje dane oraz zapewnia interfejs sieciowy do przeglądania danych w czasie rzeczywistym i tworzenia raportów. Więcej informacji można znaleźć na stronie https://matomo.org.

Integracja ta może być wykorzystywana na wiele sposobów:

• subskrybować Matomo Cloud, która obejmuje hosting i wsparcie
• zainstalować Matomo na własnym serwerze, aby uzyskać pełną kontrolę nad danymi
• zbudować własny punkt końcowy, który analizuje dane zdarzeń, co pozwala na przechowywanie danych i zarządzanie nimi dokładnie tak, jak chcesz.

Szczegóły implementacji

Klienci Prenly Reader będą wysyłać dane statystyczne do punktu końcowego api śledzenia serwera Matomo, zgodnie z oficjalną dokumentacją api śledzenia Matomo, przy użyciu:

• oficjalnego zestawu SDK Matomo w języku JavaScript z czytnika Prenly.
• open source SDK:s dla Android och iOS z czytników aplikacji natywnych Prenly. Wymaga to dodania SDK do kodu programu aplikacji natywnej, co oznacza, że nowe wersje aplikacji muszą zostać skompilowane i wydane, zanim integracja zacznie działać.

Obecna implementacja obsługuje eksportowanie zdarzeń, ale nie "widoków stron", ponieważ Prenly Reader nie opiera się na tradycyjnej nawigacji opartej na stronach.

Prenly nie obsługuje Matomo Tag Manager, ponieważ jest to przede wszystkim rozwiązanie dla środowisk internetowych, a zatem nie ma bezpośredniego zastosowania do natywnych klientów Prenly.

Konfiguracja

Konfiguracja serwera Matomo

Korzystanie z serwera Matomo

Normalna konfiguracja Matomo wymaga zainstalowania oprogramowania serwera Matomo o otwartym kodzie źródłowym na miejscu lub za pośrednictwem usługi hostowanej zewnętrznie, oferowanej przez matomo.org lub inne firmy. Oprogramowanie serwera będzie udostępniać interfejs API, który zbiera dane statystyczne, oraz narzędzie internetowe, które umożliwia przeglądanie i analizowanie danych.

W narzędziu internetowym należy

• utworzyć "witrynę" odpowiadającą aplikacji Prenly, co spowoduje utworzenie "identyfikatora witryny"
• ręcznie dodać "wymiary niestandardowe" (metadane dla różnych zdarzeń), które będą wysyłane przez Prenly.

Jeśli chodzi o metadane/wymiary niestandardowe w Matomo, każdy wymiar jest określany jako zwykła liczba całkowita, ponieważ jest zapisywany w bazie danych Matomo.

Podczas dodawania niestandardowych wymiarów za pomocą narzędzia internetowego są one tworzone w kolejności numerycznej (1, 2, 3, ...). Ponieważ Prenly wyśle wymiary zgodnie z poniższą listą, ważne jest, aby utworzyć niestandardowe wymiary we właściwej kolejności.

Wdrażanie niestandardowego punktu końcowego śledzenia

Zapoznając się ze specyfikacją api śledzenia Matomo, można zaimplementować własny punkt końcowy api, który zbiera dane metryczne wysyłane z aplikacji Prenly Reader.

Jest to przydatne, jeśli chcesz przechowywać dane metryczne we własnym systemie i/lub we własnym formacie. API śledzenia Matomo jest proste, więc taki punkt końcowy powinien być dość łatwy do wdrożenia.

Należy zwrócić uwagę na następujące kwestie:

• Powinien istnieć tylko jeden punkt końcowy i musi on odpowiadać zarówno na metodę GET (pojedyncze zdarzenie), jak i POST (partia zdarzeń), jak opisano w dokumentacji.
• Adres URL punktu końcowego musi kończyć się na /matomo.php. Wynika to z faktu, że klienci open source używani przez Prenly mają to ograniczenie.
• Niestandardowe wymiary wysyłane przez Prenly zostaną nazwane zgodnie z poniższą listą.

Konfiguracja integracji w PWS

Następujące parametry konfiguracyjne są ustawiane w Prenly Workspace.

Site ID

Identyfikator witryny skonfigurowany na serwerze Matomo jako liczba całkowita.

Przykład: 5

Tracking api URL

Adres URL, na który będą wysyłane dane śledzenia, kończący się na matomo.php.

Przykład: https: //my.site.com/matomo.php

Transformacja danych

Ogólne

Ze względu na ograniczenia techniczne, wszystkie właściwości są wysyłane do Matomo jako ciągi znaków.

Atrybuty zdarzeń, które są wartościami logicznymi, są wysyłane jako "0" dla wartości false i "1" dla wartości true.

Atrybuty zdarzeń

W Matomo niestandardowe wymiary są używane do reprezentowania atrybutów specyficznych dla zdarzeń. W oprogramowaniu serwera Matomo te niestandardowe wymiary muszą zostać skonfigurowane przez administratora w interfejsie internetowym serwera Matomo. Niestety, Matomo nie oferuje sposobu na nazwanie lub zidentyfikowanie tych wymiarów, zamiast tego otrzymają one numer reprezentujący ich identyfikator w bazie danych serwera Matomo.

Prenly wyśle niestandardowe wymiary zgodnie z poniższą tabelą. Aby identyfikatory były zgodne z poniższą tabelą, należy dodać wymiary niestandardowe we właściwej kolejności.

Dane kontekstowe

Dane kontekstowe są wysyłane jako parametry zgodnie z dokumentacją w api śledzenia Matomo.

Zestawy SDK typu open source używane w aplikacjach Prenly Reader implementują śledzenie danych w nieco inny sposób. Ta różnorodność prowadzi do różnic w danych wysyłanych z każdego typu klienta do serwera Matomo.

Potwierdzono, że parametry te są wysyłane ze wszystkich platform (web, Android, iOS):

Nie można zagwarantować wysłania innych parametrów.

Należy pamiętać, że specjalnie nie zastępujemy agenta użytkownika za pomocą parametru "ui". Nadal niektóre platformy mogą go wysyłać, ale nie należy temu ufać. Zamiast tego należy sprawdzić nagłówek HTTP User-Agent, aby móc określić agenta użytkownika i platformę.