What debug mode helps with
- Confirming whether events are reaching Trace.
- Understanding event type/status in real time.
- Isolating install, consent, or conversion trigger issues.
Enable debug mode
- Open a site route in the dashboard.
- Append
?debug=true to the URL. - Open debug sidebar/console.
- Trigger test events on your site.
How to use the stream
- Watch for incoming events and status transitions.
- Filter by event type to isolate one problem area.
- Match timestamps with your browser/network activity.
Recommended workflow
- Trigger one known action at a time.
- Confirm it appears in debug stream.
- If missing, inspect script install and consent state.
- If present but not reporting correctly, inspect conversion configuration.
Troubleshooting
- No stream events at all: verify site selection and debug mode URL.
- Only heartbeat/system entries: snippet may be loaded but not firing expected events.
- Events appear with errors: inspect payload shape and conversion mapping rules.
Still need help?
Contact our support team and we will get back to you as soon as we can.
support@usetrace.io