# 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: | Widget | Beschreibung | |--------|-------------| | **24h Timeline** | 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. | | **Errors (1h)** | Anzahl der echten Fehler in der letzten Stunde (z.B. `error`, `campaign_blocked`). | | **Success (1h)** | Anzahl der erfolgreich erstellten Orders in der letzten Stunde. | | **No Match** | Anzahl der Traces ohne Zuordnung. Kein Fehler – bedeutet nur, dass keine passende Kampagne/Aktion gefunden wurde. | > **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 | Filter | Typ | Beschreibung | |--------|-----|-------------| | **Search** | Freitext | Durchsucht Order-ID, Ordertoken, IP-Hash, Error-Reason und Result-Detail gleichzeitig. | | **Result** | Dropdown | Filtert nach Ergebnis-Typ (z.B. `order_created`, `no_match`, `duplicate`, `freezed`, `error`, `campaign_blocked`). | | **Order Created** | Dropdown | Filtert ob eine Order erstellt wurde (Yes/No). | | **Match Method** | Dropdown | Filtert nach Matching-Methode (z.B. `ActionID`, `VoucherCode`). | | **Campaign** | Dropdown mit Suche | Filtert nach Kampagne. Das Dropdown hat ein **Suchfeld** – einfach Kampagnen-ID oder Namen eintippen zum Filtern. | | **Time Range** | DateTime Range Picker | Zeitraum-Filter mit Quick-Select Presets und Custom Range (siehe unten). | > **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: | Spalte | Beschreibung | |--------|-------------| | **Time** | Zeitstempel des Tracking-Requests (sortierbar) | | **Result** | Ergebnis als farbiger Badge | | **Order** | Order-ID als Link zur Transaktionsliste (falls Order erstellt) | | **Campaign** | Kampagnen-ID und Name | | **Token** | Ordertoken | | **Match** | Matching-Methode (z.B. ActionID, VoucherCode) | | **Error / Detail** | Fehlermeldung oder Result-Detail | | **Actions** | Detail, Retracken, Link kopieren | ### Result-Typen und Bedeutung | Result | Farbe | Bedeutung | |--------|-------|-----------| | `order_created` | Grün | Order wurde erfolgreich erstellt | | `duplicate` | Amber/Gelb | Doppelte Order erkannt | | `freezed` | Cyan/Eisblau | Order ist eingefroren | | `no_match` | Grau | Keine passende Kampagne/Aktion gefunden (kein Fehler!) | | `error` | Rot | Technischer Fehler | | `campaign_blocked` | Rot | Kampagne ist blockiert | ### 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 & 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