Matomo Analytics

Innledning

Matomo (tidligere Piwik) er et analyseverktøy med åpen kildekode som gir omfattende innsikt i bruken av nettsteder og applikasjoner. Verktøyet samler inn og lagrer data, og tilbyr et webgrensesnitt for visning av sanntidsdata og oppretting av rapporter. Besøk https://matomo.org for mer informasjon.

Denne integrasjonen kan brukes på flere måter:

• abonnere på Matomo Cloud, som inkluderer hosting og support
• installere Matomo på din egen server for å få full kontroll over dataene dine
• bygge ditt eget endepunkt som analyserer hendelsesdata, slik at du kan lagre og administrere dataene akkurat slik du vil

Detaljer om implementeringen

Prenly Reader-klientene sender statistiske data til Matomo-serverens sporings-API-sluttpunkt, i henhold til den offisielle dokumentasjonen for Matomo-sporings-API-et, ved hjelp av:

• Matomos offisielle JavaScript SDK fra Prenly-nettleseren.
• SDK-er med åpen kildekode for Android og iOS fra Prenlys native app-lesere. Dette krever at SDK-ene legges til i programkoden til den opprinnelige appen, noe som innebærer at nye appversjoner må kompileres og utgis før integrasjonen begynner å fungere.

Den nåværende implementasjonen støtter eksport av hendelser, men ikke "sidevisninger", siden Prenly Reader ikke er avhengig av tradisjonell sidebasert navigering.

Prenly støtter ikke Matomo Tag Manager, ettersom det først og fremst er en løsning for nettmiljøer, og derfor ikke er direkte anvendelig for Prenlys native-klienter.

Oppsett

Sette opp en Matomo-server

Bruke en Matomo-server

Det normale Matomo-oppsettet krever at Matomo-serverprogramvaren med åpen kildekode installeres lokalt eller via en eksternt hostet tjeneste, som tilbys av matomo.org eller andre selskaper. Serverprogramvaren eksponerer et api som samler inn statistiske data, og et nettverktøy som lar deg vise og analysere dataene.

I nettverktøyet må du

• opprette et "nettsted" som tilsvarer Prenly-applikasjonen, noe som vil resultere i en "nettsted-ID"
• manuelt legge til "egendefinerte dimensjoner" (metadata for ulike hendelser) som Prenly vil sende

Når det gjelder teknisk håndtering av metadata/egendefinerte dimensjoner i Matomo, omtales hver dimensjon som et helt tall, ettersom det lagres i Matomos database.

Når du legger til egendefinerte dimensjoner via nettverktøyet, opprettes de i numerisk rekkefølge (1, 2, 3, ...). Siden Prenly sender dimensjoner i henhold til listen nedenfor, er det viktig å opprette de egendefinerte dimensjonene i riktig rekkefølge.

Implementere et egendefinert sporingsendepunkt

Ved å studere spesifikasjonen for Matomo-sporingsapi er det mulig å implementere ditt eget api-endepunkt som samler inn de metriske dataene som sendes fra Prenly Reader-applikasjonene.

Dette er nyttig hvis du ønsker å lagre metriske data i ditt eget system og/eller i ditt eget format. Matomo-sporingsapien er enkel, så et slikt endepunkt bør være ganske enkelt å implementere.

Vær oppmerksom på følgende:

• Det skal bare være ett endepunkt, og det må svare på både GET- (enkelthendelse) og POST-metoden (en gruppe hendelser) som beskrevet i dokumentasjonen.
• URL-en til endepunktet må slutte med /matomo.php. Dette skyldes at open source-klientene som brukes av Prenly, har denne begrensningen.
• De egendefinerte dimensjonene som sendes av Prenly, vil bli navngitt i henhold til listen nedenfor.

Konfigurer integrasjonen i PWS

Følgende konfigurasjonsparametere settes opp i Prenly Workspace.

Område-ID

Område-ID-en som er konfigurert på Matomo-serveren, som et heltall.

Eksempel 5

URL for sporings-API

URL-adressen som sporingsdata skal sendes til, og som slutter med matomo.php.

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

Datatransformasjon

Generelt

På grunn av tekniske begrensninger sendes alle egenskaper til Matomo som strenger.

Hendelsesattributter som er boolske, sendes som "0" for false og "1" for true.

Hendelsesattributter

I Matomo brukes egendefinerte dimensjoner til å representere hendelsesspesifikke attributter. I Matomo-serverprogramvaren må disse egendefinerte dimensjonene settes opp av en administrator i Matomo-serverens webgrensesnitt. Matomo tilbyr dessverre ikke en måte å navngi eller identifisere disse dimensjonene på, i stedet får de et nummer som representerer ID-en deres i Matomo-serverens database.

Prenly sender egendefinerte dimensjoner i henhold til tabellen nedenfor. For at ID-ene skal samsvare med tabellen nedenfor, må du legge til de egendefinerte dimensjonene i riktig rekkefølge.

Kontekstuelle data

Kontekstuelle data sendes som parametere som dokumentert i Matomos sporings-API.

SDK-ene med åpen kildekode som brukes i Prenly Reader-applikasjonene, implementerer datasporing på litt forskjellige måter. Dette mangfoldet fører til variasjoner i dataene som sendes fra hver klienttype til Matomo-serveren.

Disse parameterne bekreftes å bli sendt fra alle plattformer (web, Android, iOS):

Andre parametere kan ikke garanteres å bli sendt.

Merk at vi spesifikt ikke overstyrer brukeragenten ved hjelp av "ui"-parameteren. Noen plattformer kan likevel sende den, men du bør ikke stole på det. I stedet må du sjekke HTTP-overskriften User-Agent for å finne ut hvilken brukeragent og plattform du bruker.