Retail Engine, 2026

Changes for page Recommendations

From version 13.1
edited by Anastasia Zanina
on 2026/09/08 03:26
Change comment: Renamed back-links.
To version 9.1
edited by Anastasia Zanina
on 2026/03/25 10:03
Change comment: Renamed back-links.

Summary

Details

Page properties
Content
... ... @@ -2,7 +2,7 @@
2 2  Product recommendation functionality allows you to include products selected by one of the supported algorithms based on customer preferences directly in message content.
3 3  
4 4  {{info}}
5 -Product recommendation functionality is only available when integration with the [[Retail Engine AI>>doc:Main.Retail_Engine_AI.WebHome]] module is configured.
5 +Product recommendation functionality is only available when integration with the [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]] module is configured.
6 6  {{/info}}
7 7  
8 8  (% class="box" %)
... ... @@ -14,13 +14,13 @@
14 14  
15 15  The general recommendation generation process works as follows:
16 16  
17 -1. The marketer creates a recommendation in the Retail Engine Loyalty Platform.
17 +1. The marketer creates a recommendation in the Loymax Platform.
18 18  1. The marketer inserts the recommendation code into a message.
19 -1. When generating the message, Smart Communications sends a request to [[Retail Engine AI>>doc:Main.Retail_Engine_AI.WebHome]] for recommended products.
20 -1. Retail Engine AI returns an array of products generated using the specified algorithm.
21 -1. Smart Communications sends a personalized message containing the recommendations.
19 +1. When generating the message, Loymax Smart Communications sends a request to [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]] for recommended products.
20 +1. Loymax AI returns an array of products generated using the specified algorithm.
21 +1. Loymax Smart Communications sends a personalized message containing the recommendations.
22 22  
23 -== Creating recommendations using Retail Engine AI algorithms ==
23 +== Creating recommendations using Loymax AI algorithms ==
24 24  
25 25  To view the list of created recommendations, go to the **Recommendations** section in the left-hand panel.
26 26  
... ... @@ -40,23 +40,23 @@
40 40  * **Recommendation code** — a short code used to insert recommendations into messages.
41 41  * **Recommendation name** — a human-readable name displayed in the list of configured recommendations.
42 42  * **Recommendation algorithm** — select the desired algorithm from the list:
43 -** [[Popular products>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsA0algorithm"]]. Algorithm that recommends the most popular products from the entire catalog, regardless of the customer’s history.
44 -** [[Popular products in category>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsinCategoryalgorithm"]]. Algorithm that recommends the most popular products from categories the customer has shown interest in (viewed, purchased, or ordered).
45 -** [[Similar products>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HSimilarProductsalgorithm"]]. Algorithm that recommends products similar to those the customer has shown interest in.
46 -** [[Frequently bought together>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]]. Algorithm that recommends products frequently purchased together with products the customer has shown interest in.
47 -** [[Personalized product recommendations>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HPersonalizedProductRecommendationsalgorithm"]]. Algorithm that predicts a customer’s future purchases based on their history and recommends products accordingly.
48 -** [[Manual recommendations>>||anchor="HCreatingmanualrecommendations"]]. Algorithm that recommends products based on category-matching rules without using the Retail Engine AI module.
43 +** [[Popular products>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsA0algorithm"]]. Algorithm that recommends the most popular products from the entire catalog, regardless of the customer’s history.
44 +** [[Popular products in category>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsinCategoryalgorithm"]]. Algorithm that recommends the most popular products from categories the customer has shown interest in (viewed, purchased, or ordered).
45 +** [[Similar products>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HSimilarProductsalgorithm"]]. Algorithm that recommends products similar to those the customer has shown interest in.
46 +** [[Frequently bought together>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]]. Algorithm that recommends products frequently purchased together with products the customer has shown interest in.
47 +** [[Personalized product recommendations>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HPersonalizedProductRecommendationsalgorithm"]]. Algorithm that predicts a customer’s future purchases based on their history and recommends products accordingly.
48 +** [[Manual recommendations>>||anchor="HCreatingmanualrecommendations"]]. Algorithm that recommends products based on category-matching rules without using the Loymax AI module.
49 49  
50 50  Configure the recommendation parameters. The available parameters depend on the selected algorithm.
51 51  
52 -* **Number of recommendations** — the number of products Retail Engine AI will return.
53 -* **Calculate based on** — the source from which Smart Communications will take products (for calculating recommendations using the [[Frequently bought together>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]] and [[Similar products>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HSimilarProductsalgorithm"]] algorithms) or categories (for calculating recommendations using the [[Popular products in category>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsinCategoryalgorithm"]] algorithm).
52 +* **Number of recommendations** — the number of products Loymax AI will return.
53 +* **Calculate based on** — the source from which Loymax Smart Communications will take products (for calculating recommendations using the [[Frequently bought together>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]] and [[Similar products>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HSimilarProductsalgorithm"]] algorithms) or categories (for calculating recommendations using the [[Popular products in category>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsinCategoryalgorithm"]] algorithm).
54 54  )))|(% style="border-color:white; text-align:center; width:30%" %){{lightbox image="recommendation_edit.png" width="400"/}}
55 55  
56 56  == Creating manual recommendations ==
57 57  
58 58  |(% style="border-color:white; width:70%" %)(((
59 -Manual recommendations differ from all other algorithms in that the calculation is performed entirely within Smart Communications. Manual recommendations are calculated once per day according to the configured parameters.
59 +Manual recommendations differ from all other algorithms in that the calculation is performed entirely within Loymax Smart Communications. Manual recommendations are calculated once per day according to the configured parameters.
60 60  
61 61  When calculating manual recommendations, the system checks the specified source (**Calculate based on** field) for products belonging to the defined **Target category**. Then, the system selects products from **Recommended categories** that most frequently appear together with the target product in receipts. The algorithm returns N of the most popular products, where N is the value set in the **Number** field.
62 62  
... ... @@ -66,7 +66,7 @@
66 66  
67 67  * **Recommend products based on region** ([[image:1.png]]). Depending on this setting, recommended products will be filtered by the **Region** field either in the [[customer profile>>doc:Main.Smart_Communications.SMC_Use.Customers.All_clients.WebHome||anchor="HCustomerprofile"]] or in the customer’s latest web session.
68 68  * **Calculation period** ([[image:2.png]]). The period over which receipts will be analyzed to identify products most frequently purchased together with the target products.
69 -* **Calculate based on** ([[image:3.png]]). As with other algorithms, this is the source from which Smart Communications retrieves target products.
69 +* **Calculate based on** ([[image:3.png]]). As with other algorithms, this is the source from which Loymax Smart Communications retrieves target products.
70 70  * **Target category** ([[image:4.png]]). The category containing products for which recommendations will be calculated. To add a target category, click **+ Add match** in the bottom-left corner of the window.
71 71  * **Recommended category** ([[image:5.png]]). The category containing products that will be recommended. Multiple recommended categories can be selected for a single target category. To add a recommended category, click **+ Add category**.
72 72  * **Number** ([[image:5.png]]). The number of products from this recommended category the algorithm will return. This number is set separately for each recommended category.
... ... @@ -83,11 +83,11 @@
83 83  
84 84  To display recommendations in messages, you must use [[template engine>>doc:Main.Smart_Communications.SMC_Use.Mass_messaging.Template_engine.WebHome]] constructs.
85 85  
86 -Consider an example of adding recommendations to a message. An email campaign needs to be sent to customers with recommendations using the [[Frequently bought together>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]] algorithm (a recommendation with code ##together## has been created in the system for this purpose). For customers without sufficient purchase history, recommendations will be provided using the [[Popular products>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsA0algorithm"]] algorithm (a recommendation with code ##popular## has been created in the system for this purpose).
86 +Consider an example of adding recommendations to a message. An email campaign needs to be sent to customers with recommendations using the [[Frequently bought together>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]] algorithm (a recommendation with code ##together## has been created in the system for this purpose). For customers without sufficient purchase history, recommendations will be provided using the [[Popular products>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsA0algorithm"]] algorithm (a recommendation with code ##popular## has been created in the system for this purpose).
87 87  
88 88  The email layout assumes displaying 3 to 9 product cards—1 to 3 rows of 3 cards each. Only products available for ordering in the online store should be recommended. Additionally, the product price must be displayed in the message, and if the price has changed, both the old and new prices should be shown.
89 89  
90 -1. Define a variable ##Rec## and assign it an array of Product (##product##) objects selected by the [[Frequently bought together>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]] algorithm. If the customer hasn’t made enough purchases, fall back to the [[Popular products>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsA0algorithm"]] algorithm.
90 +1. Define a variable ##Rec## and assign it an array of Product (##product##) objects selected by the [[Frequently bought together>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HBoughtTogetheralgorithm"]] algorithm. If the customer hasn’t made enough purchases, fall back to the [[Popular products>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome||anchor="HPopularProductsA0algorithm"]] algorithm.
91 91  
92 92  {{code language="twig"}}
93 93  {% set Rec=client.recommendations.together %}
... ... @@ -100,7 +100,7 @@
100 100  (% start="2" %)
101 101  1. Filter the array of recommended products to keep only those available for purchase in the online store (the boolean custom [[field>>doc:Main.Smart_Communications.SMC_Use.Settings_SC.Data_field.WebHome]] ##eComAvailable## equals ##true##). To do this, define a variable ##filteredRec## to store the filtered recommendations.
102 102  1. No more than 9 products (three rows of three) should be displayed in the message. Define a variable ##count_recs## as a counter: each time a product is added to the filtered recommendations array, increment the counter by 1.
103 -1. Iterate through all products and add to the array only those that haven’t already been added (in case Retail Engine AI returned the same product twice) and that are available for ordering in the online store. Also, check the counter value and add the product only if fewer than 9 recommendations have been collected.
103 +1. Iterate through all products and add to the array only those that haven’t already been added (in case Loymax AI returned the same product twice) and that are available for ordering in the online store. Also, check the counter value and add the product only if fewer than 9 recommendations have been collected.
104 104  
105 105  {{code language="twig"}}
106 106  {% set count_recs=0 %}
... ... @@ -181,6 +181,6 @@
181 181  (((
182 182  **See also:**
183 183  
184 -* [[Product recommendation algorithms>>doc:Main.Retail_Engine_AI.Commercial_recommendations.WebHome]]
184 +* [[Product recommendation algorithms>>doc:Main.Loymax_AI.Commercial_recommendations.WebHome]]
185 185  * [[Message template engine>>doc:Main.Smart_Communications.SMC_Use.Mass_messaging.Template_engine.WebHome]]
186 186  )))
Created 2026/02/11 07:35
Last edited 2026/09/08 04:43

News
Updates
Tag cloud
Glossary
Site