Changes for page Recommendations

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.zanina
	1	+XWiki.VeraRetyeva

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 [[Loymax AI>>doc:Main.Loymax_AI.WebHome]] module is configured.
	5	+Product recommendation functionality is only available when integration with the [[Retail Engine AI>>doc:Main.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 Loymax Platform.
	17	+1. The marketer creates a recommendation in the Retail Engine Loyalty Platform.
18	18	1. The marketer inserts the recommendation code into a message.
19		-1. When generating the message, Loymax Smart Communications sends a request to [[Loymax AI>>doc:Main.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.
	19	+1. When generating the message, Smart Communications sends a request to [[Retail Engine AI>>doc:Main.Loymax_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.
22	22
23		-== Creating recommendations using Loymax AI algorithms ==
	23	+== Creating recommendations using Retail Engine 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
...	...	@@ -45,18 +45,18 @@
45	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	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	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.
	48	+** [[Manual recommendations>>||anchor="HCreatingmanualrecommendations"]]. Algorithm that recommends products based on category-matching rules without using the Retail Engine 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 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).
	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.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 Loymax 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 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 Loymax Smart Communications retrieves target products.
	69	+* **Calculate based on** ([[image:3.png]]). As with other algorithms, this is the source from which 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.
...	...	@@ -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 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.
	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.
104	104
105	105	{{code language="twig"}}
106	106	{% set count_recs=0 %}