# Matomo

URL: https://docs.ablyft.com/de/developers/integrations/matomo/

> Sende die Experiments und Variations, denen ein Visitor zugewiesen wurde, an Matomo Tag Manager und vergleiche die Variations in Matomo.



ABlyft hat eine eingebaute Matomo-Integration. Ist sie aktiv, legt ABlyft ein Event mit Experiment und Variation in den
Data Layer des Matomo Tag Managers ab. Ein Tag in deinem Matomo-Tag-Manager-Container macht daraus ein Matomo-Event, sodass
du die Variations neben deinen übrigen Reports vergleichen kannst.

## Was du brauchst

* Der Matomo-Tag-Manager-Container ist auf den Seiten installiert, auf denen deine Experiments laufen.
* Ein Trigger und ein Tag im Container, die auf das ABlyft-Event reagieren (siehe [Wo du die Daten in Matomo siehst](#where-you-see-the-data-in-matomo)).

## Integration aktivieren

1. Öffne **Project → Integrations**.
2. Suche die Karte **Matomo** und stelle den Schalter von **Not active** auf **Activated**.
3. Bestätige. ABlyft veröffentlicht das Project neu.

Für diese Integration gibt es keine Einstellungen.

## Das bekommst du

ABlyft legt ein Event mit diesen Feldern im Data Layer des Matomo Tag Managers ab:

| Feld            | Wert                 |
| --------------- | -------------------- |
| `event`         | `custom_event`       |
| `eventCategory` | `ab_test`            |
| `eventAction`   | Name des Experiments |
| `eventName`     | Name der Variation   |

Nur Namen, keine IDs. Das Event wird bei **User bucketed** abgelegt: einmal, wenn der Visitor in diesem Browser zum
ersten Mal einer Variation zugewiesen wird. Bei späteren Seitenaufrufen wird es nicht wiederholt. Das Event sendet von
sich aus nichts an Matomo. Ein Tag in deinem Container muss darauf reagieren.

Lädt das Tool etwas später, versucht ABlyft es für kurze Zeit erneut.

Du brauchst ein anderes Format? [Baue eine Custom Integration](https://docs.ablyft.com/de/developers/integrations/custom-integrations/).

## Wo du die Daten in Matomo siehst

Das Event erreicht deine Reports nur, wenn der Container darauf reagiert. Im Matomo Tag Manager:

1. Erstelle einen Trigger vom Typ **Custom Event** mit dem Event-Namen `custom_event`.
2. Erstelle drei Variablen vom Typ **Data Layer** mit den Namen `eventCategory`, `eventAction` und `eventName`.
3. Erstelle ein Matomo-Analytics-Tag, das ein **Event** trackt, und nutze die drei Variablen für Category, Action und
   Name. Verwende den Trigger aus Schritt 1.
4. Veröffentliche den Container.

Danach erscheinen die Events in den Matomo-Reports mit der Category `ab_test`, dem Experiment-Namen als Action und dem
Variation-Namen als Name. Für den Vergleich nutzt du diese Werte in Matomo-Segmenten, zum Beispiel ein Segment pro
Variation, und wendest die Segmente nebeneinander an. Matomo berechnet
keine statistische Signifikanz. Dafür nutzt du ABlyft **Results**.

## Einrichtung prüfen

1. Öffne deine Website mit einem Experiment, dem du zugewiesen wirst. Nutze ein neues privates Fenster, weil das Event nur
   bei der ersten Zuweisung in einem Browser passiert.
2. Prüfe im Preview-Modus des Matomo Tag Managers, ob dein Trigger auslöst, und danach das Event in Matomo.

> **Hinweise:** Die Integration läuft nicht, wenn Tracking für den Visitor deaktiviert ist (Opt-out oder Do Not Track). Matomo braucht
> in deinem Consent-Tool unter Umständen eine eigene Consent-Kategorie.

[Matomo-Dokumentation](https://developer.matomo.org/guides/tagmanager/datalayer)