Toolbar Capabilities
Core Functions
Zone Management:- View all zones present on current page
- Check zone rendering status and results
- Locate zones visually on the page
- Preview campaigns (including inactive/unpublished)
- Test popups before going live
- Monitor events sent to PureClarity
- Debug tracking implementations
- Validate custom integrations
The debug toolbar is particularly valuable for custom implementations and development work.
Getting Started
Enabling the Debug Toolbar
Add the debug parameter to your store URL:- Navigate to your store in a browser
- Add
?pc_debug=true
to the end of the URL - Press Enter to reload the page
- Debug toolbar appears in top-left corner
If your URL already has query parameters, use
&pc_debug=true
instead.Disabling the Debug Toolbar
To close the toolbar:- Click the X at the top of the menu
- This stops debug mode completely
- Page returns to normal operation
Toolbar Interface
Default Display
- Appears as minimized icon in top-left corner
- Stays out of the way until needed
- Click to expand full interface
Positioning and Movement
Toolbar is fully draggable:- Click and drag the blue border at the top
- Drag using the PureClarity logo
- Reposition anywhere on screen for convenience
- Close main panel to show menu only
- Minimize to return to icon state
- Expand/collapse as needed during testing
Authentication
Logging In
To access full toolbar functionality, log in using your PureClarity admin credentials.
- Enter same credentials used for admin panel
- Page refreshes after successful login
- Full preview capabilities become available
- Access to campaigns and popups
Toolbar Panels
Overview Panel
Key information displayed: Access Key- Your PureClarity store identifier
- Useful for verifying correct account connection
- Page type sent to PureClarity in page_view events
- Shows “No page type provided” if missing
- Critical for proper zone rendering
- Unique identifier for current user
- Changes when users log in/out
- Useful for debugging user-specific issues
- Unique session identifier
- Different on each visit
- Helps track session-based behavior
User and Session IDs are essential for debugging personalization and tracking issues.
Zones Overview
Zone status display:- Lists all zones present on current page
- Shows whether results were found for each zone
- Quick validation of zone implementation
- Identify missing or broken zones
- Verify zone placement and configuration
- Check zone-to-content mapping
Zones - Campaigns
Campaign preview capabilities:Preview any campaign configured for a zone, including inactive and unpublished campaigns.
- Active campaign display - See currently running campaigns
- Campaign switching - Preview different campaigns for testing
- Segment override - Ignore segment conditions for testing
- Real-time reload - Refresh campaigns after admin changes
- Zone location - Find zone placement on page
- Select zone to test
- Choose campaign to preview
- Verify display and functionality
- Make adjustments in admin if needed
- Reload to see changes
Zones - Popups
Popup testing features: Preview options:- Test inactive or unpublished popups
- Override segment conditions for testing
- Verify popup design and functionality
- Check timing and trigger conditions
Perfect for testing popups targeting hard-to-replicate segments before making them live.
Events Overview
Event monitoring and debugging:Displays all events that the clientscript has received on the current page.
- Tracking events sent to PureClarity
- Manual zone retrieval calls
- Currency change events
- Preview function calls
- Full event data display
- Large data sets show copy button
- Click to copy complete event data
- Paste into text editor for detailed analysis
Event monitoring is especially valuable for custom platform implementations and custom tracking setups.
Best Practices
Development Workflow
- Enable toolbar during development and testing phases
- Test all zones to ensure proper implementation
- Preview campaigns before publishing
- Validate events for custom implementations
- Disable toolbar before production deployment
Testing Strategy
Systematic testing:- Test each zone individually
- Verify all campaign types
- Check popup functionality
- Monitor event tracking accuracy
- Use segment override to test targeted content
- Verify segment conditions work correctly
- Test edge cases and boundary conditions
Troubleshooting
Common debugging tasks:- Verify correct access keys
- Check page type implementation
- Validate zone placement
- Debug event tracking issues
- Test cross-device functionality