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)
- Preview on-site messages, including drafts, before publishing them
- 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=trueto the end of the URL - Press Enter to reload the page
- Debug toolbar appears in top-left corner
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 campaign and on-site message previews
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
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: Features:- 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 - Messages
Preview an on-site message on your real store before publishing it. In the message editor, click Preview on my store, log in to the toolbar, then under Zones, Messages, click Preview beside the message.- The preview shows the message straight away, whatever its audience and trigger, so you can check messages for hard-to-reach segments.
- It shows the last saved version, including drafts and paused messages.
- Only you see it, and it isn’t counted as a view.
Zones - Popups (legacy)
Popups from the old popup editor can still be previewed here until you replace them. See Legacy popups.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
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
- Preview each on-site message
- 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
