The PureClarity Debug Toolbar is an essential development tool that enables you to preview, test, and debug PureClarity implementations directly on your website.

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
Content Preview:
  • Preview campaigns (including inactive/unpublished)
  • Test popups before going live
Development Debugging:
  • 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:
https://www.your-store.com?pc_debug=true
Steps:
  1. Navigate to your store in a browser
  2. Add ?pc_debug=true to the end of the URL
  3. Press Enter to reload the page
  4. 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:
  1. Click the X at the top of the menu
  2. This stops debug mode completely
  3. 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
Panel management:
  • 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.
Login process:
  1. Enter same credentials used for admin panel
  2. Page refreshes after successful login
  3. Full preview capabilities become available
  4. 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
  • Page type sent to PureClarity in page_view events
  • Shows “No page type provided” if missing
  • Critical for proper zone rendering
PureClarity User ID
  • Unique identifier for current user
  • Changes when users log in/out
  • Useful for debugging user-specific issues
PureClarity Session ID
  • 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
Zone management:
  • 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.
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
Testing workflow:
  1. Select zone to test
  2. Choose campaign to preview
  3. Verify display and functionality
  4. Make adjustments in admin if needed
  5. 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.
Event types tracked:
  • Tracking events sent to PureClarity
  • Manual zone retrieval calls
  • Currency change events
  • Preview function calls
Data handling:
  • 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

  1. Enable toolbar during development and testing phases
  2. Test all zones to ensure proper implementation
  3. Preview campaigns before publishing
  4. Validate events for custom implementations
  5. Disable toolbar before production deployment

Testing Strategy

Systematic testing:
  • Test each zone individually
  • Verify all campaign types
  • Check popup functionality
  • Monitor event tracking accuracy
Segment testing:
  • 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