Tutorial: Implementierung von Custom Dimensions in Matomo

Custom Dimensions ergänzen Matomo-Daten um beschreibende Merkmale, etwa einen Mitgliedschaftstarif für einen Besuch oder eine Artikelkategorie für einen Seitenaufruf. Eine Dimension dient zur Gruppierung und ist keine Kennzahl wie Anzahl oder Dauer. Zur Einrichtung gehören eine passende Dimensions-ID, der richtige Gültigkeitsbereich und ein beim Versand verfügbarer Wert.

1. Dimension anlegen und aktivieren

Unter Verwaltung führt der Weg über Websites beziehungsweise Messgrößen zu Benutzerdefinierte Dimensionen. Für die richtige Website wird eine benannte Dimension angelegt und aktiviert. Die erzeugte numerische ID dient als Referenz im Tracking. Dieselbe Zahl kann bei einer anderen Website ein anderes Merkmal bezeichnen.

• Besuchs-Gültigkeitsbereich: Ein Wert beschreibt den Besuch. Bei einer Änderung während des Besuchs gilt der zuletzt erfasste Wert. Ein Wechsel von Standard zu Premium bewahrt deshalb nicht beide Stufen als getrennte Besuchswerte.
• Aktions-Gültigkeitsbereich: Der Wert beschreibt einen einzelnen Seitenaufruf, ein Ereignis, einen Download oder ausgehenden Link. Unterschiedliche Aktionen können unterschiedliche Werte tragen.

2. Wert mit dem passenden Aufruf senden

Das Beispiel setzt voraus, dass ID 1 eine aktive Besuchsdimension für den Mitgliedschaftstarif bezeichnet. Der Code gehört vor den Seitenaufruf in einen bereits konfigurierten Matomo-Tracker. premium ist ein Beispielwert und muss aus dem tatsächlichen Anwendungszustand stammen.

var _paq = window._paq = window._paq || [];
_paq.push(['setCustomDimension', 1, 'premium']);
_paq.push(['trackPageView']);

Das Beispiel ersetzt den vorhandenen Seitenaufruf an dieser Stelle. Ein zusätzlicher zweiter Aufruf würde die Seite doppelt zählen.

setCustomDimension sendet selbst keine Anfrage. Der gesetzte Wert begleitet nachfolgende Tracking-Aufrufe innerhalb desselben Seitenaufbaus bis zur Änderung oder Entfernung mit deleteCustomDimension. Das betrifft auch Aktionsdimensionen: Der Aktions-Gültigkeitsbereich leert den Wert im JavaScript-Tracker nicht automatisch nach einer Aktion. Für genau eine Aktion unterstützt Matomo außerdem aufrufspezifische Dimensionsdaten. Das Entfernen eines Trackerwerts löscht keine bereits erfassten Serverdaten.

3. Matomo Tag Manager konfigurieren

Im Matomo Tag Manager wird eine Variable für den Wert angelegt, etwa für ein Data-Layer-Feld. In der Matomo Configuration Variable wird unter Custom Dimensions die Dimensions-ID eingetragen und die Variable als Value zugeordnet. Das Matomo-Tracking-Tag muss diese Konfiguration verwenden. Die Vorschau muss zeigen, dass der Wert beim vorgesehenen Auslösen bereits vorhanden ist.

4. Vor dem Berichtsvergleich prüfen

Ein kontrollierter Test prüft Website-ID, aktive Dimensions-ID und den gesendeten Parameter dimension1. Mindestens zwei Werte und ein fehlender Wert gehören zur Probe. Bei einer Aktionsdimension folgt eine weitere Aktion, um versehentlich übernommene Werte zu erkennen. Bei einer Besuchsdimension wird ein Wertwechsel innerhalb desselben Besuchs samt Übernahme des letzten Werts geprüft.

Custom Dimensions besitzen eigene Berichte und lassen sich für Segmente sowie, abhängig vom Funktionsumfang, Custom Reports verwenden. Verfügbare Kennzahlen hängen vom Gültigkeitsbereich und den installierten Produktfunktionen ab. Eine beliebige Sekundärdimension steht nicht automatisch in jedem Standardbericht bereit. Neue Anfragen können im Besuchsprotokoll früher erscheinen als in fertig aufbereiteten Berichten.

Fiktives Beispiel: Mitgliedschaftstarife

Die folgenden Zahlen veranschaulichen ausschließlich einen Berichtsaufbau. Es handelt sich weder um gemessene Ergebnisse noch um einen Nachweis, dass Premium-Mitgliedschaft längere Besuche verursacht. Seitenaufrufe und durchschnittliche Besuchsdauer messen unterschiedliche Dinge; Zeitdefinition und Berichtszeitraum müssen einheitlich sein.

Stabile Kategorien halten Berichte vergleichbar. E-Mail-Adressen, Namen oder unkontrollierte Freitexte sind zur Unterscheidung von Tarifen nicht erforderlich. Ein geeigneter Tarifwert lautet beispielsweise premium statt einer persönlichen Kennung.