Debugging & Troubleshooting¶

Dxtra Tag Manager includes a debug overlay for real-time visibility into tag execution, rule evaluation, and event tracking.

Enabling Debug Mode¶

Add #dxtra-debug to any URL on your site:

https://yourwebsite.com/any-page#dxtra-debug

Debug Overlay¶

The debug panel appears as a floating overlay with these tabs:

Tag Status Indicators¶

Click any tag to view loading time, error messages, dependencies, and which rules caused it to fire.

Rule Evaluation¶

The debug overlay shows rule evaluation in real time:

[12:34:56] Rule Group: "Page View Tracking"
  Rule: "All Pages"
    Event: Page View (fired)
    Condition: URL exists (true)
    No exceptions
    -> Action: Execute analytics tag
  Result: FIRED (executed 3 actions)

Verifying Installation¶

Open the browser console and check:

// Check if Tag Manager loaded
console.log('Dxtra loaded:', typeof window.dxtra !== 'undefined');

// Check if analytics API is available
console.log('Analytics ready:', typeof window.dxtraAnalytics?.track === 'function');

Send a Test Event¶

if (window.dxtraAnalytics) {
  window.dxtraAnalytics.track('debug_test', {
    timestamp: new Date().toISOString(),
    page: window.location.href
  });
  console.log('Test event sent');
}

Common Issues¶

Installation Issues¶

Rules Not Firing¶

1. Check event configuration -- verify the event name matches what the page sends
2. Validate conditions -- use debug mode to see condition evaluation results
3. Review exceptions -- ensure exceptions are not inadvertently blocking the rule
4. Test with manual events -- trigger a test event from the console

Rules Firing Too Often¶

1. Check repeatability settings -- disable repeatability or set a delay
2. Look for duplicate events -- SPA route changes can fire multiple page views
3. Check for multiple installations -- ensure the script is only included once

Tags Failing to Load¶

Check for CSP violations in the browser console:

window.addEventListener('securitypolicyviolation', function(e) {
  console.warn('CSP Violation:', e.violatedDirective, 'Blocked:', e.blockedURI);
});

Analytics Not Recording¶

1. Check consent status -- Dxtra's built-in analytics works without consent, but third-party tags require it
2. Verify the script variant -- use tm.js for full Tag Manager or analytics.js for analytics only
3. Check the dashboard -- data may take a few minutes to appear

Testing Workflow¶

Pre-Launch Checklist¶

1. Development: Test all tags and rules using debug mode
2. Staging: Deploy a finalized revision and verify with production-like conditions
3. Cross-browser: Test in Chrome, Firefox, Safari, and Edge
4. Mobile: Verify on mobile browsers
5. Consent flows: Test with consent granted, denied, and changed mid-session

Post-Launch Monitoring¶

• Monitor the browser console for [Dxtra] prefixed errors
• Check the analytics dashboard for data anomalies
• Verify conversion events are recording correctly

Support¶

If you cannot resolve an issue:

• Email: support@dxtra.ai (include "Tag Manager Debug" in subject)
• Include: screenshots from debug mode, console errors, and browser/OS details

Continue to Privacy Features for Dxtra Tag Manager's privacy-first design and compliance capabilities.