Skip to main content
Creating zones in PureClarity enables you to define specific areas on your website where personalized content, recommendations, and campaigns will appear. Proper zone setup is essential for effective personalization deployment.
Zones act as containers for your personalized content, requiring both configuration in PureClarity and implementation in your website’s HTML structure.

​
Accessing Zone Management

Navigate to Settings > Zones to access the zone configuration interface where you can create, edit, and manage all your personalization zones. The zone management dashboard provides:
  • Overview of existing zones: Complete list of configured zones
  • Zone performance metrics: Usage and effectiveness data
  • Configuration tools: Add, edit, delete, and organize zones
  • Implementation guidance: Technical details for website integration

​
Creating a New Zone

​
Basic Zone Configuration

Zone Name: Create a descriptive, user-friendly name that clearly indicates the zone’s purpose and location
  • Examples: “Home Page Hero Image”, “Product Page Cross-Sells”, “Cart Page Upsells”
  • Use consistent naming conventions across your organization
  • Include page type and position for clarity
Reference ID: Assign a unique technical identifier for implementation
  • Homepage zones: HP-01, HP-02, HP-03, etc.
  • Product page zones: PP-01, PP-02, etc.
  • Mobile-specific zones: HPM-01, PPM-01, etc.
  • Category page zones: CP-01, CP-02, etc.
Use systematic reference ID patterns that make it easy for developers to understand zone placement and purpose. Consider including device type indicators (M for mobile, D for desktop) when needed.

​
Page Type Definition

Specify target pages: Define which page types the zone should appear on: Common page types:
  • Homepage: Main landing page and site entry point
  • Product pages: Individual product detail pages
  • Category pages: Product category and collection listings
  • Cart/basket pages: Shopping cart and checkout process
  • Search results: Product search result pages
  • Content pages: Blog posts, articles, and informational content
Page targeting options:
  • Universal zones: Appear across multiple page types
  • Specific page zones: Limited to particular page types or URLs
  • Conditional zones: Display based on customer behavior or characteristics
  • Dynamic zones: Adapt content based on page context

​
Zone Organization and Tagging

Tags and categories: Organize zones for easier management
  • By function: Recommendations, promotions, content
  • By location: Header, footer, sidebar, main content
  • By priority: Primary, secondary, testing zones
  • By team: Marketing, merchandising, development
Documentation: Include notes about zone purpose, targeting strategy, and implementation details

​
Technical Implementation Requirements

​
HTML Integration

Each zone requires implementation as a <div> element in your website’s HTML: 
<div data-pureclarity="bmz:[ZONE-ID]"></div>
Implementation considerations:
  • Zone placement: Position zones where content should appear
  • Page template integration: Add zones to appropriate template files
  • Responsive design: Ensure zones work across all device types
  • Performance optimization: Minimize impact on page load times

​
Platform-Specific Implementation

Shopify:
  • Online Store 2.0: Use app blocks for easy zone management
  • Vintage themes: Manual liquid template modification required
  • Zone snippets: Include PureClarity zone code in theme files
Magento:
  • Widget system: Add zones through Magento’s widget interface
  • Template integration: Direct zone code insertion in template files
  • Block management: Use Magento’s layout system for zone placement
WooCommerce:
  • Plugin integration: Zones managed through PureClarity plugin
  • Theme hooks: Automatic zone insertion via WordPress hooks
  • Manual placement: Custom zone positioning for specific needs
Always test zone implementation across different page types and devices before launching campaigns to ensure proper display and functionality.

​
Zone Strategy and Planning

​
Strategic Zone Placement

High-impact locations:
  • Above the fold: Prime visibility zones for key messages
  • Product context: Zones near product information for relevant recommendations
  • Decision points: Cart and checkout areas for final conversion optimization
  • Navigation areas: Header and sidebar zones for consistent messaging
Content flow integration:
  • Natural placement: Zones that feel part of the organic content flow
  • Non-intrusive positioning: Avoid disrupting core user experience
  • Progressive disclosure: Zones that reveal information as users scroll
  • Context-sensitive areas: Zones that adapt to page content and user behavior

​
Zone Hierarchy and Priorities

Primary zones: Main personalization areas with highest visibility and impact Secondary zones: Supporting content areas for additional engagement Testing zones: Experimental areas for new content and strategies Seasonal zones: Temporary areas for time-limited campaigns and promotions

​
Multi-Device Considerations

Responsive design: Zones that adapt appropriately across screen sizes Mobile optimization: Specific zones optimized for mobile user experience Device-specific content: Different content strategies for different devices Performance considerations: Mobile-optimized zones for faster loading

​
Zone Management Best Practices

​
Naming Conventions

Consistent patterns: Use standardized naming across all zones Descriptive clarity: Names that immediately convey zone purpose and location Team communication: Names that work for both technical and marketing teams Future scalability: Naming patterns that accommodate business growth

​
Reference ID Systems

Logical organization: ID patterns that group related zones Sequential numbering: Systematic approach to zone numbering Platform compatibility: IDs that work across all implementation platforms Documentation standards: Clear documentation of ID meanings and usage

​
Performance Monitoring

Zone effectiveness: Track which zones drive the most engagement and conversions Content performance: Monitor how different content types perform in each zone User experience impact: Ensure zones enhance rather than detract from user experience Technical performance: Monitor zone impact on page load times and site performance

​
Common Zone Configuration Scenarios

​
E-commerce Recommendations

Homepage zones:
  • HP-01: Hero area for featured products or promotions
  • HP-02: Trending products section
  • HP-03: Personalized recommendations based on browsing history
Product page zones:
  • PP-01: Related products and alternatives
  • PP-02: Frequently bought together recommendations
  • PP-03: Complete the look or accessory suggestions
Cart page zones:
  • BP-01: Last-minute add-ons and upsells
  • BP-02: Free shipping threshold messaging
  • BP-03: Recently viewed items for reconsideration

​
Content and Promotions

Promotional zones:
  • PROMO-01: Site-wide promotional banners
  • PROMO-02: Category-specific offers
  • PROMO-03: Seasonal or time-limited promotions
Content zones:
  • CONTENT-01: Educational articles and guides
  • CONTENT-02: Brand storytelling and values
  • CONTENT-03: User-generated content and reviews

​
Troubleshooting Zone Issues

​
Common Implementation Problems

Zone not displaying:
  • Verify HTML implementation is correct
  • Check zone ID matches exactly
  • Ensure page type targeting is appropriate
  • Confirm PureClarity script is loaded
Content not appearing:
  • Verify campaigns are targeting the correct zone
  • Check campaign and segment targeting criteria
  • Ensure content meets minimum display requirements
  • Review campaign scheduling and activation status
Performance issues:
  • Optimize zone placement for page loading
  • Reduce number of zones per page if necessary
  • Check for JavaScript conflicts or errors
  • Monitor and adjust zone update frequency

​
Optimization Strategies

Zone performance analysis:
  • Regular review of zone effectiveness and engagement
  • A/B testing of zone placement and content
  • User behavior analysis to optimize zone positioning
  • Conversion tracking to measure zone impact on business goals
Continuous improvement:
  • Regular zone audit and cleanup
  • Performance optimization based on data insights
  • Strategic zone expansion based on successful patterns
  • Team training on zone best practices and optimization
Proper zone setup creates the foundation for successful personalization, enabling targeted content delivery that enhances customer experience while driving measurable business results. Take time to plan zone strategy carefully and implement with attention to both technical requirements and user experience considerations.