ElasticSuite provides an “Explain and Compare” page that gives you deep insights into your search relevance. It allows you to understand exactly how product scores are calculated, why certain products rank higher than others, and how your active search optimizers are impacting the final results.
You can access this tool by navigating to Smile ElasticSuite > Search Engine > Explain results in your Magento admin panel.
Configuration Form
| Parameter | Default value | Description |
|---|---|---|
| Store view | Default Store View | Defines the specific store view for which you want to analyze the results. (Note: Only store views can be selected here). |
| Request type | Catalog Product Search | Determines the context of the search you want to explain: • Catalog Product Search: Analyzes products displayed on a standard search results listing. • Catalog Product Autocomplete: Analyzes products suggested in the autocomplete dropdown. • Category Product View: Analyzes products displayed on a specific category listing page. |
| Query text | (Empty) | (Applicable for Catalog Product Search and Catalog Product Autocomplete). The exact search query or term you want to analyze. |
| Category Preview | (Empty) | (Applicable for Category Product View). A dropdown containing all categories from your catalog. Select the specific category you want to analyze. |
| Explain | (Button) | Clicking this button processes your configuration and displays the “Explain and compare” dashboard. |
Explain and Compare Dashboard
Once the configuration is submitted, the dashboard displays a comprehensive breakdown of your search or category results.
| Dashboard Section | Description |
|---|---|
| Synonyms and expansions | Displays any active thesaurus rules (synonyms or expansions) that were triggered by the analyzed search term. |
| Optimizers | Lists any active search optimizers that are currently influencing the products returned for this specific query. |
| Product listing | Shows the actual products returned by the query in their exact ranked order. Each product card provides key scoring information. |
Product Card Overview
Each product card in the listing features specific indicators to help you quickly understand its ranking:
| Indicator | Description |
|---|---|
| Locker Icon | Indicates that the product’s position has been manually pinned/sorted for this specific query or category. |
| Green Arrow | Indicates that the product has received a relevance boost from an active search optimizer. |
| Score | The final calculated relevance score of the product (including any optimizer multipliers). |
| Question Mark | Clicking this icon opens a detailed popup explaining exactly how this product’s final score was calculated. |
Detailed Score Breakdown
Clicking the question mark on any product card opens a detailed breakdown popup containing several informational tables.
Product information
Basic details including the product’s name, SKU, price, and current stock status.
Behavioral Data Table
(Note: This table is only visible if the Premium Behavioral Data tracking feature is enabled in your configuration).
This table provides a comprehensive breakdown of the real-user interaction metrics collected by the This table provides a comprehensive breakdown of the real-user interaction metrics collected by the Elasticsuite tracker for this specific product. Understanding these metrics is crucial if you are using Behavioral Optimizers, as this table shows the exact data the search engine uses to calculate dynamic relevance boosts.
| Metric Type | Description |
|---|---|
| Views | Displays the number of times this product has been viewed by users. |
| Sales | Displays the number of times this product has been purchased. |
| Conversion Rate | Shows the percentage of views that successfully resulted in a sale for this specific product. |
| Revenue | Displays the accumulated revenue generated by this product. |
For each of the metrics listed above, the table breaks down the data into specific timeframes based on your tracker configuration:
- Total: The all-time accumulated value or exact number for the metric.
- Daily: The metric calculated over your configured daily sliding window (e.g., averaged or cumulative over the last 30 days).
- Weekly: The metric calculated over your configured weekly sliding window (e.g., averaged or cumulative over the last 60 days).
Matches
| A detailed log of how the search terms matched the product’s attributes. • Field: The specific indexed attribute matched. • Term: The exact term matched. • Weight: The configured search weight of the matched field. • Score: The base score generated by this specific field match. * Field matches total:** The sum of all individual field scores. Boost: The multiplier applied by active optimizers. Total: The final product score ( Field matches total × Boost value). |
Field Explanation Table
This table provides technical insights into how the search engine processes and evaluates the individual fields for this product.
Indexed Content Table
This table details exactly how the product’s content is stored within the Elasticsearch/OpenSearch index, allowing you to verify the raw data the search engine “sees”.