Overview
Install Malachyte directly in your Shopify store
Malachyte integrates directly with Shopify to provide real-time product personalization, search intelligence, and behavioral analytics across the shopping journey. This document outlines the technical integration between Shopify and Malachyte’s platform, including data flow, app installation, event tracking, and administrative controls. It is intended to supplement your privacy, security, and technical due diligence materials.
Integration Summary
| Component | Description |
|---|---|
| Custom App Installation | Secure installation via Shopify with scoped permissions |
| Product Catalog Sync | Daily product data synchronization` |
| Product Updates | Real-time updates to product attributes (title, price, availability, tags, collections, publish status) via Shopify webhooks |
| Pixel-Based Tracking | Privacy-conscious tracking of customer behavior via Shopify Theme Extension |
| Onsite Experience Blocks | Context-aware injection of recommendation & Search |
| Merchant Admin Portal | Unified dashboard to monitor and manage integration settings |
Note: The current implementation uses a custom Shopify app. In a future version (V2), Malachyte will migrate to a Shopify Extension-based model for deeper integration, simplified permissions, and improved maintainability.
How It Works: Data & Experience Flow
Collaborator Code Shared
- Malachyte sends collaborator request to merchant
Initial GCP Project Provisioning
- Automatically created using Terraform
Product Data Synchronization
- Full catalog pulled upon installation
- Shopify webhooks maintain real-time sync for all updates
- ML Models are trained
Behavioral Event Tracking
- Theme App Extension tracks on-site events:
- Views
- Add-to-cart
- Search
- Checkout
- Purchase
- Event data is streamed to Malachyte for analytics and personalization
Personalized Onsite Experiences
- Dynamic components injected into theme:
- Homepage carousels
- PDP recommendations
- Checkout upsells
- Each component is mapped to a pre-defined recommendation or search strategy
Frontend Experience Management
Personalized recommendation and search components are rendered dynamically via Shopify Theme Blocks.
Supported Placements
- Homepage: Hero banners and top-level trending carousels.
- Product Detail Page (PDP): Cross-sells and "frequently bought together" logic.
- Collection Pages: Dynamic sorting and category-specific recommendations.
- Cart & Checkout Flows: High-intent upsells to increase AOV.
- Predictive Search: Real-time type-ahead suggestions.
- Search Pages: Fully personalized results based on query intent.
Customization
Components can be edited within the Malachyte Portal, allowing merchants to define specific merchandising rules (e.g., pinning products or boosting brands) directly within the recommendation logic.
Design Principles & Best Practices
- Standardized Integration: Fully compliant with Shopify’s embedded app and theme extension standards, ensuring no core theme file interference.
- Global Scalability: Architected to support multi-region storefronts and large-scale multilingual catalogs.
- Performance First: Asynchronous loading of components ensures zero impact on Lighthouse scores and page load speeds.