Matomo Besucherstatistik in Homeassistant einbinden

Matomo Besucherstatistik in Homeassistant einbinden

Wer Matomo als Analytics-Tool zur Auswertung der Besucherstatistiken auf seinem Blog nutzt, kann diese Daten über die Matomo-API, mittels eines REST-Sensors, in Homeassistant integrieren. Im Folgenden zeige ich wie man die täglichen, wöchentlichen und monatlichen Besucherstatistiken (Unique Visitors) in Homeassistant darstellen kann. Dazu muss wie folgt vorgegangen werden:

Auth-Token im Matomo Dashboard suchen

Als erstes muss in das Dashboard von Matomo gewechselt werden. Dort findet man in den Einstellungen unter der Sektion Platform den Menüpunkt API. Hier präsentiert Matomo den benötgten Token der wie folgt aussieht:

&token_auth=c7a98***************************

Dieser muss notiert werden, da er für den REST-Sensor in Homeassistant benötigt wird.

REST-Sensor in Homeassistant erstellen

In Homeassistant müssen folgende drei Sensoren angelegt werden. Der Platzhalter URL_MATOMO muss durch die entsprechende URL ersetzt werden unter der Matomo erreichbar ist. Zu beachten ist in der URL der Eintrag idSite, wenn mehrere Blogs mittels Matomo getrackt werden. An dieser Stelle muss dann die gewünschte ID eingetragen werden.

- platform: rest
resource: "https://URL_MATOMO/?module=API&method=VisitsSummary.getUniqueVisitors&idSite=1&period=day&date=today&format=JSON&token_auth=c7a98***************************"
name: Blog Visitors Today
value_template: '{{ value_json.value | int }}'
unit_of_measurement: "Visitors"
- platform: rest
resource: "https://URL_MATOMO/?module=API&method=VisitsSummary.getUniqueVisitors&idSite=1&period=week&date=today&format=JSON&token_authc7a98***************************4"
name: Blog Visitors Week
value_template: '{{ value_json.value | int }}'
unit_of_measurement: "Visitors"
- platform: rest
resource: "https://URL_MATOMO/?module=API&method=VisitsSummary.getUniqueVisitors&idSite=1&period=month&date=today&format=JSON&token_auth=c7a98***************************"
name: Blog Visitors Month
value_template: '{{ value_json.value | int }}'
unit_of_measurement: "Visitors"

Lovelace-Card in Homeassistant erstellen

Zu aller Letzt wird jetzt noch eine Card in der Lovelace-UI erstellt:

- type: glance
title: Triumvirat.org | Statistik 
entities:
- entity: sensor.blog_visitors_today
icon: 'mdi:calendar-today'
name: Today
- entity: sensor.blog_visitors_week
name: Week
icon: 'mdi:calendar-week'
- entity: sensor.blog_visitors_month
name: Month
icon: 'mdi:calendar-week-begin

Kleiner Obolus: Gesprochenene Blogstatistik mittels TTS-Service

Wer die Blogstatistik gerne mittels TTS ausgeben lassen möchte, kann dies mittels eines Scripts bewerkstelligen. Ich nutze hierfür Alexa:

alexa_blogstatistik:
alias: Blogstatistik
sequence:
- service: notify.alexa
data_template:
message: >
'Heute haben {{ states.sensor.blog_visitors_today.state }} Menschen den Blog gelesen. Die gesamte Woche waren es {{ states.sensor.blog_visitors_week.state }} und im gesamten Monat {{ states.sensor.blog_visitors_month.state }} Besucher.'