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.

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

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.

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

Klick auf das Replay-Icon in der Actions-Spalte oder den Retracken-Button im Detail-Modal
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
Das Retrace-Log öffnet sich automatisch

Retrace-Log

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

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