Mercury Dokumentation

Einbindung von Matomo, Google Analytics oder Piwik PRO

Diese Anleitung beschreibt, wie Sie die Analytik-Dienste zur Messung der Webseiten-Besucherzahlen im Mercury Template konfigurieren können.

Um diese Einstellungen optimal einsetzen zu können sind ein erweitertes technisches Verständnis sowie HTML und CSS Kenntnisse hilfreich.

Setzen der Matomo Eigenschaften 'matomo.url', 'matomo.id' und 'matomo.jst'

Um Matomo zu verwenden, müssen Sie die URL des von Ihnen verwendeten Matomo-Servers angeben. In OpenCms müssen Sie dafür die Eigenschaft matomo.url setzen. Da der Server vermutlich für alle Websites derselbe sein wird, setzen Sie diese Eigenschaft am bestem am Ordner /sites/.

Von Matomo erhalten sie dann für jede Website eine sogenannte Website ID. Diese Website ID ist in der Regel eine Zahl wie z.B. 12345.

In OpenCms müssen Sie nun diese Website ID für Matomo in der Eigenschaft matomo.id an den Startordner der betreffenden Website setzen. Dies ist für jede Website, welche individuell gemessen werden soll, zu wiederholen.

Matomo bietet ab der Version 3.13.6 die Möglichkeit, Seitenaufrufe auch ohne die Verwendung von Cookies zu tracken. In diesem Fall erfolgt das Tracking von Matomo nur durch JavaScript.

Die Option des JavaScript-Tracking durch Matomo muss im OpenCms ausdrücklich aktiviert werden. Hierfür ist die Eigenschaft matomo.jst auf den Wert true zu setzen. Dies kann für alle Websites gleichzeitig am Ordner /sites/ erfolgen.

Die Funktion „Datenschutz Cookie-Umschalter“ ermöglicht es Webusern, dem Tracking durch JavaScript zu widersprechen.

Matomo bietet außerdem die Möglichkeit, den „Do Not Track“ Header des Browsers auszuwerten und das Tracken der Seitenaufrufe in diesem Fall zu unterlassen. Dies ist auf dem Matomo-Server einzustellen. Ist dies eingestellt, so ist die Eigenschaft matomo.jst im OpenCms auf den Wert true: dnt zu setzen. In der Funktion „Datenschutz Cookie-Umschalter“ wird dem Benutzer dann ein entsprechender Hinweis angezeigt, dass seine Seitenaufrufe nicht getrackt werden.

Hinweis: Die Einstellung des JavaScript-Trackings mit der Eigenschaft matomo.jst funktioniert nur gemeinsam mit den Eigenschaften matomo.id und matomo.url, nicht mit den Eigenschaften piwik.id und piwik.url.

Diese Funktion setzt Cookies in der Gruppe „Statistiken“.

Diese Funktion verwendet JavaScript von anderen Servern.

Das Ausführen der Matomo Analytik-Komponente wird durch das Cookie Banner gesteuert.

Wenn der Webuser Statistik-Cookies nicht zugestimmt hat, so ist Matomo in der Lage den Besuch dennoch durch Ausführen eines JavaScripts zu tracken. Diese Option des Tracking durch JavaScript muss separat aktiviert werden. 

Falls konfiguriert und aktiv, so ist diese Funktion automatisch auf allen Seiten integriert und wird daher beim Laden jeder Seite ausgeführt.

Beim Laden der Seite werden von Matomo Cookies gesetzt. Diese werden für das Tracking des Webusers genutzt.

Wurden Statistik-Cookies vom Webuser abgelehnt, das Tracking über JavaScript ist aber aktiviert, so werden keine Cookies für statistische Zwecke gesetzt. Allerdings werden in diesem Fall eventuell Session-Cookies oder Opt-Out Cookies gesetzt.

Für dieses Element werden JavaScript-Dateien von anderen Servern geladen. Diese werden im Kontext der Seite ausgeführt. Dies ermöglicht ein umfangreiches Tracking der Aktivitäten des Webusers auf der angezeigten Seite. 

Matomo kann auf einem eigenen Server gehostet werden. In diesem Fall werden keine Daten an externe Dienstleister übertragen. Alternativ kann Matomo auch bei einem Dienstleister eingekauft werden. 

OpenCms unterscheidet nicht zwischen eigenen Matomo-Servern oder Matomo-Servern bei einem anderen Dienstleister.

Setzen der Piwik PRO Eigenschaften „piwik.url“ und „piwik.id“

Hinweis: Im Januar 2018 wurde die Software Piwik umbenannt in Matomo (Blog-Artikel dazu). Verwenden Sie die hier beschriebenen Konfigurationen nur dann, wenn Sie Piwik PRO und nicht Matomo benutzen.

Um Piwik PRO zu verwenden, müssen Sie die URL des von Ihnen verwendeten Piwik PRO-Servers angeben. In OpenCms müssen Sie dafür die Eigenschaft piwik.url setzen. Da der Server vermutlich für alle Websites derselbe sein wird, setzen Sie diese Eigenschaft am besten am Ordner /sites/.

Von Piwik PRO erhalten Sie dann für jede Website eine sogenannte Website-ID. Diese Website-ID ist normalerweise eine Zahl, z.B. 12345.

In OpenCms müssen Sie nun diese Website-ID für Piwik PRO in der Eigenschaft piwik.id an den Startordner der betreffenden Website setzen. Dies ist für jede Website, welche individuell gemessen werden soll, zu wiederholen.

Diese Funktion setzt Cookies in der Gruppe „Statistiken“.

Diese Funktion verwendet JavaScript von anderen Servern.

Das Ausführen der Piwik PRO Analytik-Komponente wird durch das Cookie Banner gesteuert. Diese Funktion ist deaktiviert, wenn der Webuser Statistik-Cookies nicht zugestimmt hat.

Falls konfiguriert und aktiv, so ist diese Funktion automatisch auf allen Seiten integriert und wird daher beim Laden jeder Seite ausgeführt.

Beim Laden der Seite werden von Piwik PRO Cookies gesetzt. Diese werden für das Tracking des Webusers genutzt.

Für dieses Element werden externe JavaScript-Dateien von den Servern von Piwik PRO geladen. Diese werden im Kontext der Seite ausgeführt. Dies ermöglicht ein umfangreiches Tracking der Aktivitäten des Webusers auf der angezeigten Seite.

Neben den klassischen Webstatistiken bieten Matomo und Piwik PRO mittlerweile alternativ eine modernere und erweiterte Analysemöglichkeit über den sogenannten Tag Manager. In älteren Matomo-Versionen muss der Tag Manager zunächst als Plugin installiert werden, in neueren Matomo-Versionen sowie in Piwik PRO ist der Tag Manager standardmäßig verfügbar.

Wenn der Tag Manager eingerichtet ist, erhalten Sie eine Container-ID. Bei Matomo ist dies eine Zeichenkette aus Zahlen, Klein- und Großbuchstaben, z.B. „M9AeoyHz“, bei Piwik PRO hat die Container-ID die Form einer UUID, z.B. „04868047-4d3d-4ef5-86ef-342005a73086e“.

Diese Container-ID wird für die Konfiguration in OpenCms benötigt:

  • Geben Sie als Wert der Eigenschaft matomo.id (bzw. piwik.id) das Schlüsselwort „container“ gefolgt von einem Unterstrich „_“ und der Container ID an, z.B. „container_M9AeoyHz“.
  • Falls noch nicht vorhanden, geben Sie die von Ihnen verwendete Server-URL an, indem Sie die URL als Wert der Eigenschaft matomo.url (bzw. piwik.url) setzen.

Durch das der ID vorangestellte Schlüsselwort „container_“ wird der Tag Manager Endpunkt des konfigurierten Anbieters angesprochen.

Beim Wechsel vom herkömmlichen Tracking zum Tracking mit Tag Manager bleibt die Server-URL gleich - lediglich der Wert der Eigenschaft matomo.id (bzw. piwik.id) muss geändert werden.

Hinweis: Mit dem Tag Manager von Matomo bzw. Piwik PRO können neben der Webnutzerstatistik auch andere Funktionen („Tags“) wie z.B. Social Media Buttons eingebunden werden. Letztendlich kann der Tag Manager beliebiges HTML und JavaScript in eine Mercury Website einfügen. Sollten Funktionen eingebunden werden, die über die reine Webnutzerstatistik hinausgehen, ist dies datenschutzrechtlich nicht durch das Mercury Cookie Banner abgedeckt. 

Setzen der Google Tracking-ID in der Eigenschaft 'google.analytics'

Um Google Analytics zu verwenden, müssen Sie zunächst bei Google ein entsprechendes Konto anlegen. Wie das im Detail geht wird z.B. auf der Website von Google beschrieben.

Sie erhalten dann von Google für jede Website eine sogenannte Tracking-ID. Diese Tracking-ID hat in der Regel das Format UA-1234567-8. 

In OpenCms müssen Sie diese Tracking-ID für Google Analytics in der Eigenschaft google.analytics an dem Startordner der betreffenden Website setzen. Dies ist für jede Website, welche individuell gemessen werden soll, zu wiederholen.

Diese Funktion setzt Cookies in der Gruppe „Statistiken“.

Diese Funktion verwendet JavaScript von externen Servern.

Das Ausführen der Google Analytik-Komponente wird durch das Cookie Banner gesteuert. Diese Funktion ist deaktiviert, wenn der Webuser Statistik-Cookies nicht zugestimmt hat.

Falls konfiguriert und aktiv, so ist diese Funktion automatisch auf allen Seiten integriert und wird daher beim Laden jeder Seite ausgeführt.

Beim Laden der Seite werden von Google Cookies gesetzt. Diese werden für das Tracking des Webusers genutzt.

Für dieses Element werden externe JavaScript-Dateien von den Servern von Google geladen. Diese werden im Kontext der Seite ausgeführt. Dies ermöglicht ein umfangreiches Tracking der Aktivitäten des Webusers auf der angezeigten Seite.