Diagnostics
The Diagnostics section helps you troubleshoot issues with consent capture, region detection, and integration.
Running diagnostics
- Navigate to Diagnostics
- Enter a URL or select from recent pages
- Click Run Diagnostics
The diagnostic tool checks:
- CMP snippet installation
- Configuration loading
- Region detection
- Consent Mode signals
- Cookie behavior
Diagnostic checks
Snippet installation
| Check | Description |
|---|---|
| Snippet present | CMP script tag found in page |
| Load order | Script loads before analytics |
| Site key match | Site key matches configuration |
| CDN reachable | CDN endpoint responds |
Configuration
| Check | Description |
|---|---|
| Config fetched | Configuration loaded from registry |
| Schema valid | Configuration passes validation |
| Version current | Using latest config version |
| ETag caching | Proper cache headers |
Region detection
| Check | Description |
|---|---|
| Region detected | Visitor region identified |
| Rules applied | Correct region rules active |
| Fallback used | Default rules applied if needed |
Consent Mode
| Check | Description |
|---|---|
| Default set | gtag('consent', 'default', ...) called |
| Update sent | Consent state updated after decision |
| Signals correct | All four signals properly set |
| GA4 receiving | Google Analytics receiving signals |
Interpreting results
Green checkmarks
Everything working correctly.
Yellow warnings
Non-critical issues that may affect behavior:
- Slow configuration fetch
- Deprecated configuration options
- Missing optional settings
Red errors
Critical issues requiring attention:
- Snippet not installed
- Configuration not loading
- Region detection failing
- Consent Mode not working
Common issues
"Snippet not found"
The CMP script tag is missing. Add to your page:
<script src="https://YOUR-CDN/dw-cmp.min.js" data-site-key="YOUR_KEY" defer></script>
"Configuration failed to load"
Possible causes:
- Site key doesn't exist
- CDN is blocked by ad blocker
- CORS misconfiguration
"Consent Mode not updating"
Ensure:
- Google tag is installed
- CMP loads before gtag
- No JavaScript errors blocking execution
Real-time debugging
Enable debug mode on your site:
localStorage.setItem('dw-cmp-debug', 'true');
This logs detailed information to the browser console.