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 erster Schritt 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ötigten 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 der Eintrag idSite in der URL, 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

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

Hello Friend

Der zugehörige Code lautet:

- 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:

tts_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.'