Glossary
Common terms used in the Malachyte docs and Portal
| Term | Meaning |
|---|---|
| Attributable sales | Sales credited to Malachyte using 7-day last-click attribution: a shopper clicked a product in a Malachyte component or search result, added it to their cart, and bought it within 7 days. |
| Brand | A separate brand or store under one Malachyte account. Switch brands from the menu in the top-left corner of the Portal. See Brands & Subdomains. |
| Bury | A rule action that ranks matching products lower. |
| Catalog | A store's product catalog. Only needed in API requests if the client's account has more than one. |
Category (category_id) | One product listing page (collection). For Shopify stores, it's the numeric collection ID. See Defining Categories. |
| Component | A recommendation, search, or listing experience set up in the Portal, with its own ID, strategy, and rules. See Components. |
| Component ID | The component's unique ID, sent in API requests as component_id (Recommendations) or search_component_id (Search and PLP). |
| Condition | A single check against product data inside a rule, for example Price < $50. |
| Daily sync | The once-a-day full import of the Shopify catalog. Changes made in between sync through Shopify webhooks. See Permissions & Syncs. |
| Global rule | A rule that applies to every search, or to every product listing page. |
| Hide | A rule action that removes matching products from results. |
| Only Show | A rule action that shows only the products matching its conditions. |
| Page-specific rule | A rule that applies to one product listing page. |
| Pin | A rule action that fixes a specific product to an exact position. |
| Playground | The area of the Portal where clients preview results and test rules before they go live. Previews don't include personalization. |
| Promote | A rule action that ranks matching products higher. |
| Rule | One action (Promote, Bury, Hide, Only Show, or Pin) plus one or more conditions. See Adding Rules. |
| Search filter | A shopper-facing filter on search or listing pages, like Color or Size. Different from the rules merchandisers set in the Portal. See Filters. |
| Search term rule | A rule that applies only when a shopper searches for a specific term. |
| Strategy | The logic a recommendation component uses to choose products, for example Recommended For You. |
| Subdomain | One site within a brand, for example a .com or .ca site. Rules and synonyms are set per subdomain. |
| Synonym | A set of search terms that return each other's results (interchangeable), or a term that returns another term's results but not the reverse (one-way). See Synonyms. |
| User vector | Malachyte's real-time profile of each shopper's intent, used to personalize rankings. |
user_id | The ID of a logged-in shopper. |
visitor_id | The ID that identifies a shopper's session. Required in API requests. |