# Tracking Trace

# Conversion Trace – Anwenderdokumentation

## Übersicht

Das **Conversion Trace** Tool ermöglicht die Echtzeit-Überwachung und Analyse aller eingehenden Tracking-Requests (etrack/ebasket). Jeder Conversion-Versuch wird mit allen Details protokolliert – ob erfolgreich oder nicht.

**Erreichbar unter:** `Administration → Conversion Trace`**Direktlink:** `/admin/administration-ordertrace.do`

---

## Dashboard

Oben auf der Seite befinden sich vier Widgets, die einen schnellen Überblick geben:

<table id="bkmrk-widget-beschreibung-"><thead><tr><th>Widget</th><th>Beschreibung</th></tr></thead><tbody><tr><td>**24h Timeline**</td><td>Line Chart mit vier Linien: Success (grün), Errors (rot), No Match (grau), Total (hellgrau). Zeigt den Verlauf über die letzten 24 Stunden oder den gewählten Zeitraum.</td></tr><tr><td>**Errors (1h)**</td><td>Anzahl der echten Fehler in der letzten Stunde (z.B. `error`, `campaign_blocked`).</td></tr><tr><td>**Success (1h)**</td><td>Anzahl der erfolgreich erstellten Orders in der letzten Stunde.</td></tr><tr><td>**No Match**</td><td>Anzahl der Traces ohne Zuordnung. Kein Fehler – bedeutet nur, dass keine passende Kampagne/Aktion gefunden wurde.</td></tr></tbody></table>

> **Wichtig:** Alle Widgets reagieren auf die aktiven Filter. Wählt man z.B. eine bestimmte Kampagne, zeigen die Widgets nur noch Daten für diese Kampagne.

[![](https://docs.easy-m.de/uploads/images/gallery/2026-03/scaled-1680-/image-1773676571153.png)](https://docs.easy-m.de/uploads/images/gallery/2026-03/image-1773676571153.png)

---

## Filter

Die Filterleiste befindet sich unterhalb der Widgets und kann über den **Filters**-Header ein-/ausgeklappt werden. Die Zahl neben "Filters" zeigt die Anzahl der aktiven Filter.

### Verfügbare Filter

<table id="bkmrk-filter-typ-beschreib"><thead><tr><th>Filter</th><th>Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>**Search**</td><td>Freitext</td><td>Durchsucht Order-ID, Ordertoken, IP-Hash, Error-Reason und Result-Detail gleichzeitig.</td></tr><tr><td>**Result**</td><td>Dropdown</td><td>Filtert nach Ergebnis-Typ (z.B. `order_created`, `no_match`, `duplicate`, `freezed`, `error`, `campaign_blocked`).</td></tr><tr><td>**Order Created**</td><td>Dropdown</td><td>Filtert ob eine Order erstellt wurde (Yes/No).</td></tr><tr><td>**Match Method**</td><td>Dropdown</td><td>Filtert nach Matching-Methode (z.B. `ActionID`, `VoucherCode`).</td></tr><tr><td>**Campaign**</td><td>Dropdown mit Suche</td><td>Filtert nach Kampagne. Das Dropdown hat ein **Suchfeld** – einfach Kampagnen-ID oder Namen eintippen zum Filtern.</td></tr><tr><td>**Time Range**</td><td>DateTime Range Picker</td><td>Zeitraum-Filter mit Quick-Select Presets und Custom Range (siehe unten).</td></tr></tbody></table>

> **Tipp:** Die Dropdown-Filter (Result, Order Created, Match Method, Campaign) lösen sofort eine Suche aus – kein extra Klick auf "Search" nötig.

### Time Range Picker

Der Time Range Picker kombiniert Schnellauswahl und individuelle Eingabe:

**Quick Select Presets:**

- Last 1h, 3h, 6h, 12h, 24h, 48h, 7d
- Today, Yesterday

**Custom Range:**

- Zwei DateTime-Felder (From/To) für freie Zeitraum-Eingabe
- "Apply" zum Bestätigen, "Clear" zum Zurücksetzen

Der aktive Preset wird blau hervorgehoben und im Feld als Label angezeigt (z.B. "Last 24h"). Das X im Feld setzt den Zeitfilter schnell zurück.

[![](https://docs.easy-m.de/uploads/images/gallery/2026-03/scaled-1680-/image-1773676728672.png)](https://docs.easy-m.de/uploads/images/gallery/2026-03/image-1773676728672.png)

---

## Trace-Tabelle

Die Tabelle zeigt alle Traces mit folgenden Spalten:

<table id="bkmrk-spalte-beschreibung-"><thead><tr><th>Spalte</th><th>Beschreibung</th></tr></thead><tbody><tr><td>**Time**</td><td>Zeitstempel des Tracking-Requests (sortierbar)</td></tr><tr><td>**Result**</td><td>Ergebnis als farbiger Badge</td></tr><tr><td>**Order**</td><td>Order-ID als Link zur Transaktionsliste (falls Order erstellt)</td></tr><tr><td>**Campaign**</td><td>Kampagnen-ID und Name</td></tr><tr><td>**Token**</td><td>Ordertoken</td></tr><tr><td>**Match**</td><td>Matching-Methode (z.B. ActionID, VoucherCode)</td></tr><tr><td>**Error / Detail**</td><td>Fehlermeldung oder Result-Detail</td></tr><tr><td>**Actions**</td><td>Detail, Retracken, Link kopieren</td></tr></tbody></table>

### Result-Typen und Bedeutung

<table id="bkmrk-result-farbe-bedeutu"><thead><tr><th>Result</th><th>Farbe</th><th>Bedeutung</th></tr></thead><tbody><tr><td>`order_created`</td><td>Grün</td><td>Order wurde erfolgreich erstellt</td></tr><tr><td>`duplicate`</td><td>Amber/Gelb</td><td>Doppelte Order erkannt</td></tr><tr><td>`freezed`</td><td>Cyan/Eisblau</td><td>Order ist eingefroren</td></tr><tr><td>`no_match`</td><td>Grau</td><td>Keine passende Kampagne/Aktion gefunden (kein Fehler!)</td></tr><tr><td>`error`</td><td>Rot</td><td>Technischer Fehler</td></tr><tr><td>`campaign_blocked`</td><td>Rot</td><td>Kampagne ist blockiert</td></tr></tbody></table>

### Sortierung

Klick auf die Spaltenköpfe **Time**, **Order**, **Campaign** oder **Match** sortiert die Tabelle. Ein weiterer Klick kehrt die Richtung um.

### Pagination

Unter der Tabelle kann die Seitengröße gewählt werden (25, 50, 100, 200) und zwischen Seiten geblättert werden.

---

## Detail-Ansicht

Klick auf das **Info-Icon** (i) in der Actions-Spalte öffnet die Detail-Ansicht eines Traces.

### Enthaltene Informationen

- **Order ID** – mit Link zur Transaktionsliste
- **Campaign** – ID und Name
- **Trigger** – ID und Name (korrekt pro Kampagne zugeordnet)
- **Match Method**
- **Error-Details** – falls vorhanden, rot hervorgehoben
- **Order Token** und **IP Hash**
- **User Agent** – Browser/Device des Nutzers
- **Matching Cascade** – zeigt alle Matching-Schritte und welcher erfolgreich war
- **Patches Applied** – angewendete Tracking-Patches
- **Duplicate Check** – Details zur Duplikat-Prüfung (JSON)
- **Device Info** – Geräteinformationen (JSON)
- **Connection Info** – Verbindungsdetails (JSON)
- **Request Parameters** – alle übergebenen Tracking-Parameter (JSON)

*\[Insert Screenshot: Detail-Modal eines Traces\]*

---

## Retracken

Die **Retracken**-Funktion ermöglicht es, einen Tracking-Request erneut auszuführen – mit dem vollständigen Original-Kontext.

### So funktioniert's

1. Klick auf das **Replay-Icon** in der Actions-Spalte oder den **Retracken**-Button im Detail-Modal
2. Der Original-Request wird mit allen gespeicherten Parametern erneut ausgeführt: 
    - Originaler User-Agent
    - Cookies (falls gespeichert)
    - IP-Adresse via X-Forwarded-For
    - Referer-Header
    - Alle Request-Parameter + `t=json` für JSON-Response
3. Das **Retrace-Log** öffnet sich automatisch

### Retrace-Log

Das Log-Popup zeigt:

- **Ergebnis** – Großer Header mit Success (grün) oder kein Sale (amber)
- **Order-ID** – Falls eine neue Order erstellt wurde, mit Link
- **Original Trace** – Übersicht des ursprünglichen Traces (ID, Result, Order, Method, Time)
- **Request** – Kompletter ausgehender Request: 
    - HTTP Method und URL
    - Headers (User-Agent, Accept, X-Forwarded-For, Referer)
    - Cookies
    - Alle Parameter als JSON
- **Response Headers** – HTTP Response Headers vom Tracking-Server
- **Response Body** – Komplette JSON-Antwort

> **Achtung:** Retracken führt den Request tatsächlich aus! Bei einem erfolgreichen Retrace wird eine echte Order erstellt.

*\[Insert Screenshot: Retrace-Log mit erfolgreichem Result\]*

---

## Live-Modus

Der **LIVE**-Button oben rechts aktiviert den Echtzeit-Modus.

### Features

- **Polling alle 3 Sekunden** – neue Traces werden automatisch geladen
- **Animierter Einlauf** – neue Zeilen gleiten von oben rein mit grünem Glow-Effekt
- **NEW Badge** – neue Traces erhalten einen grünen "NEW"-Badge (verschwindet nach 5 Sek.)
- **Sound-Notification** – ein dezenter Ton bei neuen Einträgen
- **Progress Bar** – schmaler Balken unter dem Header zeigt den Countdown bis zum nächsten Poll
- **Live Stats** – grüne Leiste zeigt Anzahl neuer Einträge und letztes Ergebnis
- **Countdown** – neben dem LIVE-Button wird der Countdown bis zum nächsten Refresh angezeigt

### Hinweise

- Im Live-Modus wird immer nach **Timestamp DESC** sortiert (neueste zuerst)
- Aktive Filter werden auch im Live-Modus berücksichtigt
- Erneuter Klick auf LIVE deaktiviert den Modus

[![](https://docs.easy-m.de/uploads/images/gallery/2026-03/scaled-1680-/image-1773676830471.png)](https://docs.easy-m.de/uploads/images/gallery/2026-03/image-1773676830471.png)

---

## Tipps &amp; Tricks

- **Schnelle Order-Suche:** Einfach die Order-ID ins Search-Feld eingeben
- **Von Transaktionsliste verlinken:** In der Transaktionsliste gibt es einen Link-Button der direkt zum Trace dieser Order führt
- **Direktlink mit Order-ID:** `/admin/administration-ordertrace.do?order_id=12345` öffnet den Trace-Viewer direkt gefiltert auf diese Order
- **Link kopieren:** Das Copy-Icon in der Actions-Spalte kopiert einen Direktlink zum Trace in die Zwischenablage
- **Dashboard beobachten:** Mit dem Live-Modus und dem Dashboard lässt sich die Conversion-Performance in Echtzeit überwachen