Shopify Integration with Marqo
This guide will help you integrate Marqo's powerful search capabilities with your Shopify store. Marqo provides a seamless integration that enhances your store's search functionality with advanced features like semantic search, filtering, and relevance tuning.
Prerequisites
- An active Shopify store
- Admin access to your Shopify instance
- A Marqo account (if you don't have one, sign up here)
- Marqo Pixel installed on your store (see Pixel Installation Guide)
- A Marqo API key (available in your Marqo Console)
Integration Steps
1. Download Required Files
Before beginning the integration, you'll need to download two key components:
- Webhook Handler: Download the Shopify Webhook Handler
- This component manages real-time updates from your Shopify store
-
Ensures your Marqo search index stays in sync with your product catalog
-
Indexing Script: Download the Shopify Indexing Script
- This script handles the initial product data import
- Can be used for periodic full reindexing if needed
2. Set Up Webhook Handler
The webhook handler ensures your Marqo search index stays up-to-date with your Shopify store:
- Deploy the webhook handler to your preferred hosting environment
- Configure the following environment variables:
MARQO_API_KEY
: Your Marqo API keyMARQO_ENDPOINT
: Your Marqo endpoint URLSHOPIFY_SHOP_DOMAIN
: Your Shopify store domain-
SHOPIFY_ACCESS_TOKEN
: Your Shopify admin API access token -
Set up the following Shopify webhooks in your store's admin panel:
- Product creation
- Product updates
- Product deletion
- Inventory updates
3. Initial Data Indexing
To populate your Marqo search index with your existing product data:
- Extract the downloaded indexing script to your local machine
-
Configure the script with your credentials:
export MARQO_API_KEY="your_api_key" export MARQO_ENDPOINT="your_endpoint" export SHOPIFY_SHOP_DOMAIN="your-store.myshopify.com" export SHOPIFY_ACCESS_TOKEN="your_access_token"
-
Run the indexing script:
python shopify_indexer.py
-
Monitor the script's output to ensure all products are indexed successfully
4. Verify Integration
To ensure everything is working correctly:
- Test the search functionality on your store's frontend
- Verify that search results are being returned from Marqo
- Make a test product update in Shopify
- Confirm the update is reflected in Marqo search results within a few minutes
Troubleshooting
If you encounter any issues during the integration:
- Verify that your Marqo API key is correct
- Ensure the webhook handler is properly configured and running
- Check that your Shopify webhooks are properly set up
- Verify that your firewall allows connections to the Marqo endpoint
- Check the webhook handler logs for any error messages
- Contact Marqo Support if issues persist
Support
For any questions or issues with the integration, please contact our support team:
- Email: support@marqo.ai
- Support Portal: https://marqo.zendesk.com/hc/en-us/requests/new