Our Custom Installation is for customers who are not on any of the shopping platforms that PureClarity has a direct plugin with.
Not sure if that applies to you? Check our platform-specific integrations including Magento, WooCommerce, Shopify, BigCommerce, X-Cart, and Drupal.
Custom integration illustration

​
When You Need Custom Integration

Choose custom integration if you’re using:
  • Custom-built ecommerce platforms
  • Legacy systems without modern plugin support
  • Headless commerce setups
  • Multi-platform architectures
  • Enterprise systems with specific requirements
  • Any platform not covered by our direct integrations

​
Comprehensive Documentation

Everything you’ll need to get up and running with a custom PureClarity integration is available in our comprehensive custom documentation: 📚 Complete Custom Integration Documentation

​
What’s Included

Our custom documentation covers:

​
Getting Started

  • Implementation methods: Client-side vs server-side approaches
  • Authentication: Setting up API access and credentials
  • Initial setup: Account configuration and basic requirements

​
Data Feeds

  • Product feeds: Complete product catalog synchronization
  • Category feeds: Category structure and metadata
  • Brand feeds: Brand information and associations
  • User feeds: Customer data and segmentation
  • Order feeds: Purchase history and transaction data

​
Client-Side Implementation

  • JavaScript SDK: Frontend tracking and personalization
  • Zone implementation: Adding recommendation areas
  • Event tracking: User behavior and interaction monitoring
  • Currency handling: Multi-currency support

​
Server-Side Implementation

  • API endpoints: Direct server-to-server communication
  • Real-time personalization: Server-side recommendation delivery
  • Advanced use cases: Custom business logic integration

​
Advanced Features

  • Segmentation: Customer targeting and personalization
  • A/B testing: Campaign optimization and testing
  • Analytics integration: Performance tracking and reporting
  • Custom templates: Tailored recommendation displays

​
Development Resources

​
SDKs and Libraries

PHP SDK: GitHub Repository
  • Complete PHP implementation
  • Data feed management
  • Event tracking
  • API communication
JavaScript Library: Included in custom documentation
  • Frontend personalization
  • User tracking
  • Zone management
  • Real-time recommendations

​
API Reference

Complete API documentation includes:
  • RESTful endpoints for all operations
  • Request/response formats with examples
  • Authentication methods and security
  • Rate limiting and best practices
  • Error handling and troubleshooting

​
Implementation Approaches

​
Client-Side Integration

Perfect for:
  • Quick implementation with minimal backend changes
  • Standard ecommerce setups
  • Marketing-led personalization initiatives

​
Server-Side Integration

Ideal for:
  • High-performance requirements
  • Custom business logic integration
  • Advanced personalization scenarios
  • Enterprise-grade implementations

​
Hybrid Approach

Best for:
  • Complex architectures requiring both methods
  • Gradual migration from existing systems
  • Multi-channel commerce setups

​
Support and Services

​
Technical Support

  • Email support: support@pureclarity.com
  • Developer resources: Comprehensive documentation and examples
  • Community support: Developer forums and knowledge base

​
Professional Services

For complex implementations, we offer:
  • Custom development assistance
  • Integration consulting and planning
  • Performance optimization services
  • Training and onboarding for your development team

​
Getting Started Process

  1. Review Documentation: Start with the custom integration docs
  2. Plan Your Integration: Choose client-side, server-side, or hybrid approach
  3. Set Up Development Environment: Get API credentials and test environment
  4. Implement Core Features: Start with product feeds and basic tracking
  5. Add Advanced Features: Implement segmentation, campaigns, and analytics
  6. Test and Optimize: Performance testing and optimization
  7. Go Live: Deploy to production with monitoring
Start with a minimal viable implementation focusing on product feeds and basic zones, then gradually add advanced features as you become familiar with the platform.

​
Success Stories

Many successful implementations have been built using our custom integration:
  • Enterprise retailers with complex multi-brand setups
  • B2B platforms with custom pricing logic
  • Subscription services with unique recommendation needs
  • Marketplace platforms with multiple vendor requirements

​
Next Steps

  1. Explore the Documentation: Visit https://pureclarity.stoplight.io/ to get started
  2. Contact Our Team: Reach out to support@pureclarity.com for implementation guidance
  3. Plan Your Integration: Determine which approach best fits your platform and requirements
Custom integrations require development resources and technical expertise. Ensure you have the necessary technical team or consider our professional services for complex implementations.