Matomo Analyse

Introduktion til Matomo

Matomo (tidligere Piwik) er et open source-analyseværktøj, der giver omfattende indsigt i brugen af hjemmesider og applikationer. Det indsamler og gemmer data og giver en webgrænseflade til at se data i realtid og oprette rapporter. Besøg https://matomo.org for at få flere oplysninger.

Denne integration kan bruges på flere måder:

• abonnere på Matomo Cloud, som inkluderer hosting og support
• installer Matomo på din egen server for at få fuld kontrol over dine data
• Byg dit eget slutpunkt, der analyserer hændelsesdata, så du kan gemme og administrere dataene, præcis som du vil.

Detaljer om implementering

Prenly Reader-klienterne sender statistiske data til Matomo-serverens tracking api-slutpunkt i henhold til den officielle dokumentation for Matomo tracking api ved hjælp af:

• den officielle Matomo ' s officielle JavaScript SDK fra Prenly-weblæseren.
• open source-SDK'erne til Android og iOS fra Prenlys native app-læsere. Dette kræver, at SDK'erne tilføjes til den oprindelige apps programkode, hvilket betyder, at nye app-versioner skal kompileres og frigives, før integrationen begynder at fungere.

Den nuværende implementering understøtter eksport af begivenheder, men ikke "sidevisninger", da Prenly Reader ikke er afhængig af traditionel sidebaseret navigation.

Prenly understøtter ikke Matomo Tag Manager, da det primært er en løsning til webmiljøer og derfor ikke kan anvendes direkte på Prenlys native klienter.

Opsætning

Opsætning af en Matomo-server

Brug af en Matomo-server

Den normale Matomo-opsætning kræver, at Matomo-serversoftwaren med åben kildekode installeres lokalt eller via en eksternt hostet tjeneste, der tilbydes af matomo.org eller af andre virksomheder. Serversoftwaren udstiller et api, der indsamler statistiske data, og et webværktøj, der giver dig mulighed for at se og analysere dataene.

I webværktøjet skal du:

• oprette et "site", der svarer til Prenly-applikationen, hvilket vil resultere i et "site-ID"
• manuelt tilføje "brugerdefinerede dimensioner" (metadata for forskellige begivenheder), som Prenly vil sende

Når man teknisk beskæftiger sig med metadata/brugerdefinerede dimensioner i Matomo, omtales hver dimension som et almindeligt heltal, da det gemmes i Matomos database.

Når man tilføjer brugerdefinerede dimensioner via webværktøjet, oprettes de i numerisk rækkefølge (1, 2, 3, ...). Da Prenly sender dimensioner i henhold til listen nedenfor, er det vigtigt at oprette de brugerdefinerede dimensioner i den rigtige rækkefølge.

Implementering af et brugerdefineret sporingsslutpunkt

Ved at studere specifikationen af Matomo tracking api er det muligt at implementere dit eget api-endepunkt, som indsamler de metriske data, der sendes fra Prenly Reader-applikationerne.

Det er nyttigt, hvis du vil gemme metriske data i dit eget system og/eller i dit eget format. Matomo-sporingsapi'et er enkelt, så et sådant slutpunkt burde være ret enkelt at implementere.

Bemærk følgende:

• Der skal kun være ét endpoint, og det skal reagere på både GET- (en enkelt begivenhed) og POST-metoderne (en række begivenheder) som beskrevet i dokumenterne.
• URL'en til slutpunktet skal slutte med /matomo.php. Det skyldes, at de open source-klienter, der bruges af Prenly, har denne begrænsning.
• De brugerdefinerede dimensioner, der sendes af Prenly, navngives i henhold til listen nedenfor.

Konfigurer integrationen i PWS

Følgende konfigurationsparametre opsættes i Prenly Workspace.

Websteds-id

Det sted-ID, der er konfigureret på Matomo-serveren, som et heltal.

Eksempel: 5

URL til sporingsapi

Den URL, som sporingsdata vil blive sendt til, og som slutter med matomo.php.

Eksempel: https: //my.site.com/matomo.php

Transformation af data

Generelt

På grund af tekniske begrænsninger sendes alle egenskaber til Matomo som strenge.

Begivenhedsattributter, der er boolske, sendes som "0" for falsk og "1" for sand.

Hændelsesattributter

I Matomo bruges brugerdefinerede dimensioner til at repræsentere hændelsesspecifikke attributter. I Matomo-serversoftwaren skal disse brugerdefinerede dimensioner opsættes af en administrator i din Matomo-servers webinterface. Desværre tilbyder Matomo ikke en måde at navngive eller identificere disse dimensioner på, i stedet får de et nummer, der repræsenterer deres ID i Matomo-serverens database.

Prenly sender brugerdefinerede dimensioner i henhold til nedenstående tabel. For at ID'erne skal matche tabellen nedenfor, skal du tilføje de brugerdefinerede dimensioner i den rigtige rækkefølge.

Kontekstuelle data

Kontekstuelle data sendes som parametre som dokumenteret i Matomos tracking api.

De open source SDK'er, der bruges i Prenly Reader-applikationerne, implementerer datasporing lidt forskelligt. Denne forskellighed fører til variationer i de data, der sendes fra hver klienttype til Matomo-serveren.

Disse parametre bekræftes at blive sendt fra alle platforme (web, Android, iOS):

Andre parametre kan ikke garanteres at blive sendt.

Bemærk, at vi specifikt ikke tilsidesætter brugeragenten ved hjælp af "ui"-parameteren. Nogle platforme kan stadig sende den, men du bør ikke stole på den. I stedet skal du tjekke HTTP-headeren User-Agent for at kunne bestemme brugeragenten og platformen.