{"id":291,"date":"2024-08-21T15:15:08","date_gmt":"2024-08-21T15:15:08","guid":{"rendered":"https:\/\/www.privacyanalytics.eu\/?p=291"},"modified":"2024-08-21T15:17:52","modified_gmt":"2024-08-21T15:17:52","slug":"matomo-php-tracker","status":"publish","type":"post","link":"https:\/\/www.privacyanalytics.eu\/matomo-php-tracker\/","title":{"rendered":"Matomo PHP Tracker"},"content":{"rendered":"

Passiamo a qualcosa di pi\u00f9 tecnico. Possiamo configurare un tracciamento lato server<\/a> per avere un\u2019analisi del traffico pi\u00f9 precisa.<\/p>\n\n

Server side e client side<\/h2>\n

Per dirlo in poche parole, il tracciamento lato client<\/a> funziona sul browser <\/strong>dell’utente, generalmente tramite Javascript<\/strong>. Il vantaggio \u00e8 che \u00e8 possibile raccogliere determinate metriche in modo semplice e pi\u00f9 leggero per il server.<\/p>\n

Diversamente, il tracciamento lato server <\/strong>non usa Javascript ma viene effettuato direttamente, appunto, dal server stesso. Possiamo utilizzare ad esempio PHP <\/strong>per analizzare le visite che riceviamo dagli utenti.<\/p>\n

Vi sono poi dei software di Log Analytics <\/strong>come Awstats<\/a> o GoAccess<\/a>, che analizzano i log del server per determinare il traffico degli utenti sulle nostre pagine web.<\/p>\n

Il vantaggio pi\u00f9 importante del server side tracking<\/b> o della log analysis \u00e8 che possiamo monitorare il traffico che arriva anche da quegli utenti che usano sistemi di AdBlock<\/strong>, o simili, che bloccano i tracciamenti Javascript<\/strong>.<\/p>\n

In realt\u00e0, il server side analytics tracking di Matomo<\/a> \u00e8 semplice da utilizzare. Prenderemo come riferimento la libreria PHP<\/strong>, che \u00e8 tra i linguaggi pi\u00f9 diffusi nella creazione di siti web.<\/p>\n

Installazione del PHP Tracker<\/h2>\n

La via pi\u00f9 semplice \u00e8 tramite Composer:<\/p>\n

composer require matomo\/matomo-php-tracker<\/code><\/pre>\n
Altrimenti andiamo con la strada classica:<\/p>\n
    \n
  1. Scaricare MatomoTracker.php<\/a> e PiwikTracker.php<\/a> da Github oppure una differente libreria per il server side tracking<\/a><\/li>\n
  2. Caricare i file MatomoTracker.php <\/strong>e PiwikTracker.php<\/strong> nel proprio server web<\/strong>, ad esempio nella cartella \/public_html\/matomo\/<\/em>, tramite Filezilla <\/strong>o altro File Manager con FTP<\/strong><\/li>\n
  3. Nel proprio applicativo web<\/strong>, aggiungere il seguente codice PHP <\/strong>in tutte le pagine, oppure nel template <\/strong>a seconda di quale strumento si sta usando:<\/li>\n<\/ol>\n
    \"\"
    Codice PHP per attivare il tracker server side<\/figcaption><\/figure>\n
    Ecco lo snippet di codice:<\/p>\n
    # File template.php o simile, l'imporante \u00e8 che questo codice venga caricato in tutte le pagine\r\n$matomoSiteId = 1;\r\n$matomoUrl = '{url-piattaforma-matomo}';\r\n$matomoToken = '{inserisci-token}';\r\n$matomoPageTitle = '';\r\n\r\nrequire_once '{percorso-al-file}\/MatomoTracker.php';\r\n\r\ntry {\r\n    $matomoTracker = new MatomoTracker($matomoSiteId, $matomoUrl);\r\n    $matomoTracker->setRequestTimeout(2);\r\n    $matomoTracker->setTokenAuth($matomoToken);\r\n} catch (Exception $e) {\r\n}\r\n\r\n# File pagina.php, per personalizzare il titolo della pagina da passare a Matomo\r\n\r\nif (!empty($matomoTracker)) {\r\n    $matomoTracker->doTrackPageView($matomoPageTitle);\r\n}\r\n<\/code><\/pre>\n
    In base a come abbiamo installato il PHP Tracker, potremmo dover includere il namespace<\/b> in PHP oppure fare un require<\/b> di MatomoTracker.php.<\/p>\n
    Per poter configurare il $matomoToken<\/strong>, facciamo riferimento a: Matomo: Configurazione Auth Token<\/a><\/p>\n
    Se pu\u00f2 esservi di aiuto, il titolo della pagina<\/b> che passiamo a Matomo tramite la funzione doTrackPageView()<\/b> lo possiamo determinare solitamente nel template<\/b>, dove viene generato il tag title all\u2019interno dell\u2019head. Questo dipende molto dallo strumento che usiamo, ad esempio un CMS personalizzato<\/b>.<\/p>\n
    A questo punto, commentiamo la riga di Javascript<\/b> che invia il tracciamento (trackP<\/b>ageView<\/b>) a Matomo, perch\u00e9 altrimenti registrerem<\/b>m<\/b>o una doppia visita<\/b>:<\/p>\n
    \"\"
    Codice di tracciamento client side compatibile con il server side<\/figcaption><\/figure>\n
    Questo lo snippet:<\/p>\n
    var _paq = window._paq = window._paq || [];\r\n\/* tracker methods like \"setCustomDimension\" should be called before \"trackPageView\" *\/\r\n_paq.push(['enableHeartBeatTimer', 15]);\r\n\/\/ La riga seguente \u00e8 stata commentata per evitare doppie visite\r\n\/\/ _paq.push(['trackPageView']);\r\n_paq.push(['enableLinkTracking']);\r\n(function() {\r\n    var u = \"https:\/\/matomo.yourwebsite.com\/\";\r\n    _paq.push(['setTrackerUrl', u + 'matomo.php']);\r\n    _paq.push(['setSiteId', '1']);\r\n    var d = document,\r\n        g = d.createElement('script'),\r\n        s = d.getElementsByTagName('script')[0];\r\n    g.type = 'text\/javascript';\r\n    g.async = true;\r\n    g.src = u + 'matomo.js';\r\n    s.parentNode.insertBefore(g, s);\r\n})();<\/code><\/pre>\n
    In questo caso ho usato anche enableHeartBeatTimer<\/strong>, \u00e8 una funzione che permette un tracciamento pi\u00f9 preciso inviando un ping ogni tot secondi (minimo 15) a Matomo per capire quanto tempo un utente rimane su una certa pagina. Per approfondire, rimando alla documentazione Javascript di Matomo<\/a>.<\/p>\n
    Possiamo anche configurare su Matomo il tracciamento di Eventi<\/strong>, ad esempio se vogliamo sapere su quali link cliccano gli utenti.<\/p>\n
    Attenzione che alcuni tracciamenti potrebbero venire bloccati dalla funzionalit\u00e0 Do Not Track <\/strong>di Firefox e altri browser, oppure da sistemi di Ad blocking.<\/p>\n
    Link utili<\/h2>\n