To activate AI Semantic Search for your eCommerce environment, your catalog data must be set up successfully. Unlike AI Search RNN (legacy), the LLM-powered AI Semantic Search does not require analytics data for the initial set-up. This streamlined setup lets you integrate more quickly and start benefiting from AI Semantic Search in your eCommerce environment.
Your Crownpeak Technical Consultant will handle the setup of AI Semantic Search and notify you once it is ready to be used as part of your live search configuration.
Note: AI Semantic Search currently supports catalogs with English content only. Multi-language support will be introduced in an upcoming release.
Product Data (Required)
Your product catalog forms the basis for interpreting search queries and returning relevant results.
| Property | Requirement |
|---|---|
| Number of products | Minimum 5,000 |
| Format | CSV or JSON |
| Quality | Products should be clearly labeled with accurate categories, attributes, titles, and relevant descriptions |
| Images | Each product must include URL to a corresponding image with a minimum resolution of 400x400 |
Image Data (Required)
High-quality image data improves the effectiveness of AI Semantic Search, particularly in features like visually similar recommendations.
| Property | Requirement |
|---|---|
| Resolution | Minimum 1000 pixels on the longer side (width or height) |
| Number of images | Recommended average of 3 images per item |
| Format | PNG or JPG |
| Access | Images must be accessible for download (whitelisted IP or header-based access if needed) |
Tracker Implementation (Required)
Before starting the implementation to AI Semantic Search, you must implement the Front-End Tracker. This allows for tracking performance of the feature against business KPIs and enables A/B-Testing for AI Semantic Search.
For more information on implementing the Front-End Tracker, see the Setup Guide and the Implementation Guide. For more information on how to implement A/B Testing, see here.
Analytics Data/Search History (Optional)
While not mandatory, this data allows for fine-tuning the AI model by establishing links between customer search terms and the products they interacted with.
| Property | Requirement |
|---|---|
| Columns | - Search term - Product clicked (product ID, product URL, or other matchable identifier) - Search frequency (click count per search term-product pair) - Language (optional; needed if multiple languages are present) |
| Format | CSV (can be split across multiple files) |
| Encoding | UTF-8 |
| Number of rows | Minimum 1 million rows per language |
| Quality | - Raw, unprocessed search terms (no spelling corrections or cleanup) - Natural language phrases only (not product IDs) - Spaces must be preserved between words - Bots and non-human traffic should be filtered out as much as possible - Products must be matchable to items in the product data |
Next Steps
Once you have provided the required data:
You will be notified when AI Semantic Search has been successfully integrated into your search configuration.
No manual configuration is required on your side.
If you have any questions about the data, please reach out to your Crownpeak Technical Consultant.
Comments
0 comments
Please sign in to leave a comment.