Matomo Analytics

Introduzione

Matomo (ex Piwik) è uno strumento di analisi open-source che fornisce informazioni complete sull'utilizzo di siti web e applicazioni. Raccoglie e memorizza i dati e fornisce un'interfaccia web per visualizzare i dati in tempo reale e creare report. Per ulteriori informazioni, visitate il sito https://matomo.org.

Questa integrazione può essere utilizzata in diversi modi:

• sottoscrivere Matomo Cloud, che include hosting e assistenza
• installare Matomo sul proprio server per avere il pieno controllo sui propri dati
• creare il proprio endpoint che analizza i dati degli eventi, consentendo di archiviare e gestire i dati esattamente come si desidera.

Dettagli sull'implementazione

I client di Prenly Reader invieranno dati statistici all'endpoint dell'API di monitoraggio del server Matomo, secondo la documentazione ufficiale dell'API di monitoraggio Matomo, utilizzando:

• l'SDK JavaScript ufficiale di Matomo del lettore web Prenly.
• gli SDK open source per Android o iOS dal lettore di app native Prenly. Ciò richiede l'aggiunta degli SDK al codice di programma dell'applicazione nativa, il che implica che le nuove versioni dell'applicazione devono essere compilate e rilasciate prima che l'integrazione inizi a funzionare.

L'implementazione attuale supporta l'esportazione di eventi, ma non di "pagine viste", poiché il lettore Prenly non si basa sulla navigazione tradizionale basata sulle pagine.

Prenly non supporta Matomo Tag Manager in quanto è una soluzione principalmente per ambienti web e quindi non direttamente applicabile ai client nativi di Prenly.

Configurazione

Configurazione di un server Matomo

Utilizzo di un server Matomo

La normale configurazione di Matomo richiede l'installazione del software opensource Matomo server in sede o tramite un servizio ospitato esternamente, offerto da matomo.org o da altre aziende. Il software del server espone un'API che raccoglie dati statistici e uno strumento web che consente di visualizzare e analizzare i dati.

Nello strumento web, è necessario

• creare un "sito" che corrisponda all'applicazione Prenly, il che si tradurrà in un "ID sito"
• aggiungere manualmente "dimensioni personalizzate" (metadati per vari eventi) che Prenly invierà.

Quando si tratta tecnicamente di metadati/dimensioni personalizzate in Matomo, ogni dimensione viene indicata come un semplice numero intero, poiché viene salvata nel database di Matomo.

Quando si aggiungono dimensioni personalizzate tramite lo strumento web, queste vengono create in ordine numerico (1, 2, 3, ...). Poiché Prenly invierà le dimensioni in base all'elenco seguente, è importante creare le dimensioni personalizzate nell'ordine corretto.

Implementazione di un endpoint di tracciamento personalizzato

Studiando le specifiche dell'API di tracking di Matomo, è possibile implementare un proprio endpoint dell'API che raccolga i dati metrici inviati dalle applicazioni Prenly Reader.

Ciò è utile se si desidera memorizzare i dati metrici nel proprio sistema e/o nel proprio formato. L'API di monitoraggio di Matomo è semplice, quindi un endpoint di questo tipo dovrebbe essere abbastanza facile da implementare.

Si noti quanto segue:

• Ci deve essere un solo endpoint, che deve rispondere sia al metodo GET (singolo evento) sia al metodo POST (un gruppo di eventi), come descritto nella documentazione.
• L'URL dell'endpoint deve terminare con /matomo.php. Questo è dovuto al fatto che i client open source utilizzati da Prenly hanno questa limitazione.
• Le dimensioni personalizzate inviate da Prenly saranno denominate secondo l'elenco seguente.

Configurare l'integrazione in PWS

I seguenti parametri di configurazione sono impostati in Prenly Workspace.

ID sito

L'ID del sito configurato nel server Matomo, come numero intero.

Esempio: 5

URL api di tracciamento

L'URL a cui verranno inviati i dati di tracciamento, che termina con matomo.php.

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

Trasformazione dei dati

Generale

A causa di limitazioni tecniche, tutte le proprietà sono inviate a Matomo come stringhe.

Gli attributi degli eventi che sono booleani vengono inviati come "0" per falso e "1" per vero.

Attributi degli eventi

In Matomo, le dimensioni personalizzate sono utilizzate per rappresentare gli attributi specifici di un evento. Nel software del server Matomo, queste dimensioni personalizzate devono essere impostate da un amministratore nell'interfaccia web del server Matomo. Sfortunatamente, Matomo non offre un modo per nominare o identificare queste dimensioni, che riceveranno invece un numero che rappresenta il loro ID nel database del server Matomo.

Prenly invierà le dimensioni personalizzate secondo la tabella seguente. Affinché gli ID corrispondano alla tabella sottostante, è necessario aggiungere le dimensioni personalizzate nell'ordine corretto.

Dati contestuali

I dati contestuali vengono inviati come parametri, come documentato nell'API di tracciamento di Matomo.

L'SDK open source utilizzato nelle applicazioni Prenly Reader implementa il tracciamento dei dati in modo leggermente diverso. Questa diversità porta a variazioni nei dati inviati da ciascun tipo di client al server Matomo.

Questi parametri sono confermati dall'invio da tutte le piattaforme (web, Android, iOS):

Non è possibile garantire l'invio di altri parametri.

Si noti che non si sovrascrive specificamente l'agente utente utilizzando il parametro "ui". Alcune piattaforme potrebbero comunque inviarlo, ma non bisogna fidarsi. È invece necessario controllare l'intestazione HTTP User-Agent per poter determinare l'agente utente e la piattaforma.