> For the complete documentation index, see [llms.txt](https://docs.digidesk.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digidesk.de/moduldokumentationen/matomo.md).

# Matomo

## Modulbeschreibung

Dieses Modul bietet Ihnen die Möglichkeit das [Matomo](https://matomo.org/) (ehemals Piwik) Ecommerce Trackings in Ihrem OXID-Shop zu integrieren. [Matomo](https://matomo.org/) ist einer der wichtigsten Webanalyse Tools und bietet eine datenschutzkonforme Alternative zu Google Analytics, da es auf eigenem Server gehostet werden kann und Open-Source ist. 

Ausser diesem Modul wird also noch eine [Matomo-Installation](https://matomo.org/download/) benötigt, google bietet genug Anleitungen dafür. Der Begriff Matomo kommt aus dem Japanischem und bedeutet **anständig**.

## Funktionsumfang <a href="#funktionsumfang" id="funktionsumfang"></a>

**Die Funktionen dieses Moduls im Überblick:**

* einfach zu konfigurierende Schnittstelle zwischen Ihrem Oxid eShop und Matomo-Dashboard
* Datenschutz - vollständige Kontrolle über die Tracking-Daten
* Cookieless Tracking - Betrieb ohne Cookies möglich
* keine Limits
* erfüllt rechtliche Anforderungen
* bessere Datenqualität durch vergleichsweise weniger blockiertem Traffik durch AdBlocker im Vergleich zu Google Analytics

## Systemvoraussetzungen

### Webserver-Konfiguration <a href="#webserver-konfiguration" id="webserver-konfiguration"></a>

* IonCube Loader (mind. v5.0)

### Kompatibel mit den Themes <a href="#kompatibel-mit-den-themes" id="kompatibel-mit-den-themes"></a>

* Flow
* Wave
* RoxIVE

### Kompatibel mit den OXID Versionen <a href="#kompatibel-mit-den-oxid-versionen" id="kompatibel-mit-den-oxid-versionen"></a>

* OXID CE/PE/EE 6.3.x bis 6.5.x

## **Installation** <a href="#installation" id="installation"></a>

1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung.\
   Sie erhalten dieses kostenlos unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul)
2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner `dd_matomo` im Ordner `packages/digidesk`, in den die heruntergeladene Zip-Datei entpackt wird.
3. Führen Sie anschließend den folgenden Befehl aus dem Hauptverzeichnis des Shopsystems heraus aus:

   ```
   composer require digidesk/dd_matomo
   ```
4. Nun kann das Modul im OXID eShop Admin aktiviert werden
5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren
6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort

## Update <a href="#update" id="update"></a>

1. Bitte aktualisieren Sie zunächst das Basis-Modul gemäß der darin enthaltenen Installationsanleitung.
2. Entpacken Sie die neue Modulversion in den Ordner `packages/digidesk/dd_matomo`
3. Deaktivieren Sie das Modul im OXID eShop Admin
4. Führen Sie anschließend den folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:

   ```
   composer update digidesk/dd_matomo
   ```
5. Aktivieren Sie dieses Modul im OXID eShop Admin.
6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren.

## Backend-Einstellungen <a href="#backend-einstellungen" id="backend-einstellungen"></a>

<figure><img src="/files/RzJmG5ReOogLdWkmGXtz" alt=""><figcaption></figcaption></figure>

**Matomo Server URL** - hier tragen Sie bitte Ihre Matomo-Server URL ein

**Auth Token** - kann auf dem Matomo-Server unter **Administration -> Persönlich -> Sicherheit** vom entsprechenden Benutzer angelegt werden

**Matomo Seiten-ID** - kann auf dem Matomo-Server unter **Administration ->Websites/Webseiten** entnommen werden.&#x20;

**Unbehandelte Frontend JavaScript-Fehler tracken** - Diese Option trackt unbehandelte JavaScript-Fehler im Shop-Frontend in Matomo's [Event Tracking](https://matomo.org/docs/event-tracking/).

**E-Mail Pixel aktivieren** - wenn aktiv, wird in den vom Shop verschickten E-Mails ein PageView Tracking Pixel integriert.

**Tracking Snippet über dynamisches Widget vom digidesk HTML Cache ausschließen** - funktioniert nur, wenn das **digidesk Caching Modul** installiert und aktiviert ist!

<figure><img src="/files/oXTWtVf0dFZsYqisUnPQ" alt=""><figcaption></figcaption></figure>

**Benutzerdefinierte Dimensionen** und **Ziele** - hier kann man die Voreinstellungen lassen.

<figure><img src="/files/Ik9TgEmJ8EyqtzSYUVwg" alt=""><figcaption></figcaption></figure>

**Tracking Snippet Script-Parameter** - Geben Sie hier bei Bedarf die für Ihre CMP benötigten Script-Parameter an, um das Matomo Tracking Snippet über die CMP zu steuern.

## &#x20;<a href="#hilfe--support" id="hilfe--support"></a>

## Hilfe & Support <a href="#hilfe--support" id="hilfe--support"></a>

Haben Sie Fragen oder benötigen Sie Hilfe bei der Installation? Gerne bieten wir Ihnen auch einen Installationsservice an. Kontaktieren Sie uns einfach über eine der unten stehenden Adressen.

* E-Mail: **<support@digidesk.de>**
* Telefon: **+49 (0) 5246 / 9099110**
* Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt)