# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digidesk.de/moduldokumentationen/matomo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.