Навигация

Изменения документа Товарные рекомендации

<
От версии < 6.3 >
отредактировано Андрей Рылов
на 25/12/2025 08:43
К версии < 17.1 >
отредактировано Андрей Рылов
на 30/01/2026 10:24
>
Изменить комментарий: Загрузить новое изображение 6.png

Комментарий

Подробности

Свойства страницы
Содержимое
... ... @@ -1,28 +1,35 @@
1 1  (% class="lead" %)
2 -Функционал рекомендаций позволяет выводить в текст сообщений товары, подобранные по одному из поддерживаемых алгоритмов на основе прошлых действий данного клиента.
2 +Функциональность рекомендаций позволяет выводить в текст сообщений продукты, подобранные по одному из поддерживаемых алгоритмов на основе предпочтений клиентов.
3 3  
4 4  {{info}}
5 -Функционал рекомендаций поддерживается только при настроенной интеграции с модулем Loymax AI.
5 +Функциональность рекомендаций поддерживается только при настроенной интеграции с модулем [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]].
6 6  {{/info}}
7 7  
8 +(% class="box" %)
9 +(((
10 +**Содержание:**
11 +
12 +{{toc depth="3" start="2"/}}
13 +)))
14 +
8 8  Общий процесс генерации рекомендаций выглядит следующим образом:
9 9  
10 10  1. Маркетолог создаёт рекомендацию в АРМ.
11 11  1. Маркетолог вставляет код рекомендации в сообщение.
12 -1. При генерации сообщения Loymax Smart Communications отправляет в Loymax AI запрос, содержащий:
19 +1. При генерации сообщения Loymax Smart Communications отправляет в [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]] запрос, содержащий:
13 13  1*. идентификатор клиента,
14 14  1*. название алгоритма рекомендации,
15 15  1*. параметры алгоритма (например, сколько продуктов рекомендовать).
16 16  1. Loymax AI возвращает массив продуктов, сформированный по указанному алгоритму.
17 -1. Loymax Smart Communications отправляет сообщение с рекомендациями.
24 +1. Loymax Smart Communications отправляет персонализированное сообщение с рекомендациями.
18 18  
19 19  == Настройка рекомендаций ==
20 20  
21 -Чтобы просмотреть список созданных рекомендаций, на панели слева нажмите на узел **Рекомендации**.
28 +Чтобы просмотреть список созданных рекомендаций, на панели слева перейдите в раздел **Рекомендации**.
22 22  
23 23  |(% style="border-color:#ffffff; text-align:center" %){{lightbox image="recommendations.png" width="660"/}}
24 24  
25 -Вы можете совершать следующие действия с рекомендациями:
32 +В разделе **Рекомендации** доступны следующие действия:
26 26  
27 27  * Создать новую рекомендацию ([[image:1.png]]).
28 28  * Отсортировать таблицу по содержимому любого столбца ([[image:2.png]]).
... ... @@ -33,14 +33,148 @@
33 33  |(% style="border-color:white; width:70%" %)(((
34 34  Заполните обязательные поля рекомендации:
35 35  
36 -* **Код рекомендации** — код, который будет использоваться для добавления рекомендаций в сообщения.
43 +* **Код рекомендации** — короткий код, который будет использоваться для добавления рекомендаций в сообщения.
37 37  * **Наименование рекомендации** — человекочитаемое имя, которое будет отображаться в списке настроенных рекомендаций.
38 -* **Алгоритм рекомендации** — выберите требуемый алгоритм из списка. Подробнее о поддерживаемых алгоритмах см. в [[отдельной статье>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome]].
45 +* **Алгоритм рекомендации** — выберите требуемый алгоритм из списка:
46 +** [[Популярные товары>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B22"]]. Алгоритм, предлагающий самые популярные продукты из всего каталога, независимо от истории клиента.
47 +** [[Популярные товары в категории>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B43243A43044243543343E44043843822"]]. Алгоритм, предлагающий самые популярные продукты из категорий, к которым проявлял интерес клиент (просматривал, покупал, заказывал).
48 +** [[Похожие товары>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E44543E43643843544243E43243044044B22"]]. Алгоритм, предлагающий продукты, похожие на те, к которым проявлял интерес клиент.
49 +** [[Совместные покупки>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]]. Алгоритм, предлагающий продукты, которые часто покупают вместе с продуктами, к которым проявлял интерес клиент.
50 +** [[Персональные товарные рекомендации>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43544044143E43D43043B44C43D44B43544243E43243044043D44B43544043543A43E43C43543D43443044643843822"]]. Алгоритм, прогнозирующий будущие покупки клиента исходя из его истории и предлагающий продукты на основании данного прогноза.
51 +** [[Ручные рекомендации>>||anchor="H41D43044144244043E43943A43044044344743D44B44544043543A43E43C43543D434430446438439"]]. Алгоритм, предлагающий продукты на основании правил соответствия категорий без использования модуля Loymax AI.
39 39  
40 40  Настройте параметры рекомендации. Набор доступных параметров зависит от выбранного алгоритма.
41 41  
42 42  * **Количество рекомендаций** — количество продуктов, которые будет возвращать модуль Loymax AI.
43 -* **Рассчитывать на основе** — источник, из которого Loymax Smart Communications будет брать продукты/категории для расчёта рекомендаций по алгоритмам //Совместные покупки//, //Популярные товары в категории//, //Похожие товары.//
56 +* **Рассчитывать на основе** — источник, из которого Loymax Smart Communications будет брать продукты (для расчёта рекомендаций по алгоритмам [[Совместные покупки>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]], [[Похожие товары>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E44543E43643843544243E43243044044B22"]]) или категории (для расчёта рекомендаций по алгоритму [[Популярные товары в категории>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B43243A43044243543343E44043843822"]]).
44 44  )))|(% style="border-color:white; text-align:center; width:30%" %){{lightbox image="recommendation_edit.png" width="400"/}}
45 45  
59 +=== Настройка ручных рекомендаций ===
60 +
61 +|(% style="border-color:white; width:70%" %)(((
62 +Ручные рекомендации отличаются от всех остальных алгоритмов тем, что расчёт рекомендаций полностью осуществляется на стороне Loymax Smart Communications. Ручные рекомендации рассчитываются раз в сутки в соответствии с настроенными параметрами.
63 +
64 +Для продуктов, относящихся к заданной **Целевой категории** и полученных из заданного источника (поле **Рассчитывать на основе**), подбираются продукты из **Рекомендованных категорий**, которые чаще всего присутствуют в чеках вместе с целевым продуктом. Алгоритм вернёт N наиболее популярных продуктов, где N — значение, заданное в поле **Количество**.
65 +
66 +Рекомендации можно дополнительно ограничить: если заданы **Продвинутые настройки соответствия**, алгоритм будет предлагать только продукты, у которых значения заданных параметров соответствуют значениям параметров целевого продукта.
67 +
68 +Для ручных рекомендаций доступны следующие настройки:
69 +
70 +* **Период расчета** ([[image:1.png]]). Период, за который будут анализироваться чеки, чтобы определить продукты, чаще всего покупаемые вместе с целевыми.
71 +* **Рассчитывать на основе** ([[image:2.png]]). Аналогично остальным алгоритмам, источник, из которого Loymax Smart Communications будет брать целевые продукты.
72 +* **Целевая категория** ([[image:3.png]]). Категория, к продуктам из которой будут рассчитываться рекомендации. Чтобы добавить целевую категорию, нажмите **+ Добавить соответствие** в левом нижнем углу окна.
73 +* **Рекомендуемая категория** ([[image:4.png]]). Категория, продукты из которой будут предлагаться в качестве рекомендаций. К одной целевой категории можно выбрать несколько рекомендуемых. Чтобы добавить рекомендуемую категорию, нажмите **+ Добавить категорию**.
74 +* **Количество** ([[image:4.png]]). Количество продуктов из данной рекомендуемой категории, которое вернёт алгоритм. Количество задаётся отдельно для каждой рекомендуемой категории.
75 +* **Продвинутые настройки соответствия** ([[image:5.png]]). Нажмите **+ Добавить соответствие** в правой части окна, чтобы добавить поле, по которому требуется отфильтровать выдачу алгоритма. Продвинутые настройки соответствия задаются отдельно для каждой целевой категории (т.е. распространяются на все рекомендуемые категории).
76 +
77 +{{success}}
78 +* Для полей с числовыми типами данных, а также с типом данных "дата" доступен флажок **Точное соответствие**. Если он установлен, продукт будет рекомендован только при полном совпадении значения со значением соответствующего атрибута целевого продукта.
79 +* Для полей с типами данных "строка" и "логическое" всегда требуется точное соответствие.
80 +* Если флажок **Точное соответствие** снят, продукт попадёт в рекомендации, если он отличается от целевого продукта по значению атрибута не более чем на 15%.
81 +{{/success}}
82 +)))|(% style="border-color:white; text-align:center; width:30%" %){{lightbox image="recommendation_manual.png" width="400"/}}
83 +
46 46  == Подстановка рекомендаций в сообщение ==
85 +
86 +Для отображения рекомендаций в сообщениях необходимо использовать конструкции [[шаблонизатора>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]].
87 +
88 +Рассмотрим пример добавления рекомендаций в сообщения. Мы хотим отправить клиентам email-рассылку с рекомендациями по алгоритму [[Совместные покупки>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]] (для этого в Системе создана рекомендация с кодом ##sov_pok##). У некоторых клиентов ещё нет истории покупок, поэтому для них будем выдавать рекомендации по алгоритму [[Популярные товары>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B22"]] (для этого в Системе создана рекомендация с кодом ##popular##).
89 +
90 +1. Определим переменную ##Rec## и запишем в нее массив объектов Продукт (##product##), подобранных по алгоритму [[Совместные покупки>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]], а если клиент не совершил достаточного количества покупок, то по алгоритму [[Популярные товары>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B22"]].
91 +
92 +{{code language="twig"}}
93 +{% set Rec=client.recommendations.sov_pok %}
94 +{% if not Rec or Rec|length < 3 %}
95 + {% set Rec=client.recommendations.popular %}
96 +{% endif %}
97 +
98 +{{/code}}
99 +
100 +(% start="2" %)
101 +1. Отфильтруем массив рекомендованных продуктов, оставив только те, которые можно купить в интернет-магазине (значение логического пользовательского [[поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] ##eComAvailable## — ##true##). Кроме того, для вывода в сообщение нам понадобится не более 9 продуктов (три ряда по три продукта).
102 +Для этого определим две новые переменные: в массив ##filteredRec## будут записываться отфильтрованные рекомендации, а переменная ##count_recs## будет служить в качестве счётчика.
103 +1. Переберём все продукты и добавим в массив те из них, которые не были добавлены ранее (на случай, если модуль Loymax AI вернул один и тот же продукт дважды) и которые доступны для заказа в интернет-магазине.
104 +При добавлении продукта в массив отфильтрованных рекомендаций значение переменной-счётчика увеличивается на 1. Таким образом, есть два сценария выхода из цикла: либо мы перебрали все продукты, либо мы отобрали 9 подходящих для добавления в сообщение.
105 +
106 +{{code language="twig"}}
107 +{% set count_recs=0 %}
108 +{% set filteredRec=[] %}
109 +{% for product in Rec %}
110 + {% if product not in filteredRec and product.eComAvailable=='Y' and count_recs < 9 %}
111 +  {% set filteredRec=filteredRec|merge([product]) %}
112 +  {% set count_recs=count_recs + 1 %}
113 + {% endif %}
114 +{% endfor %}
115 +{{/code}}
116 +
117 +(% start="4" %)
118 +1. Разобьём отфильтрованные рекомендации на группы по три.
119 +1. Если в процессе фильтрации мы получили количество подходящих продуктов, не кратное 3, в последней группе будет меньше 3 продуктов (например, 7=3+3+1). Проверим и выведем в сообщение только те группы, в которых ровно три продукта.
120 +1. Для каждого продукта выведем наименование и изображение.
121 +
122 +{{code language="twig"}}
123 +{% for batch in filteredRec|batch(3) %}
124 +   {% if batch|length==3 %}
125 +      {% for recommendation in batch %}
126 + {{ recommendation.name }}
127 + {{ recommendation.image_url }}
128 +{{/code}}
129 +
130 +(% start="7" %)
131 +1. Далее реализуем такой сценарий:
132 +1*. если цена продукта менялась (значения полей текущей цены в интернет-магазине и старой цены не равны), выведем старую и новую цену;
133 +1*. если цена продукта не менялась и поле цены в интернет-магазине заполнено, выведем текущую цену;
134 +1*. если поле цены в интернет-магазине не заполнено, выведем "Цена уточняется".
135 +
136 +{{code language="twig"}}
137 +{% if recommendation.priceim and recommendation.oldprice and recommendation.priceim != recommendation.oldprice %}
138 +   Цена: {{ recommendation.priceim }}
139 +   Старая цена: {{ recommendation.oldprice }}
140 +{% elseif recommendation.priceim %}
141 +   Цена: {{ recommendation.priceim }}
142 +{% else %}
143 +   Цена уточняется
144 +{% endif %}
145 +{% endfor %}
146 +{{/code}}
147 +
148 +В итоге получим следующую конструкцию:
149 +
150 +{{code language="twig"}}
151 +{% set Rec=client.recommendations.sov_pok %}
152 +{% if not Rec or Rec|length < 3 %}
153 + {% set Rec=client.recommendations.popular %}
154 +{% endif %}
155 +{% set count_recs=0 %}
156 +{% set filteredRec=[] %}
157 +{% for product in Rec %}
158 + {% if product not in filteredRec and product.eComAvailable=='Y' and count_recs < 9 %}
159 +  {% set filteredRec=filteredRec|merge([product]) %}
160 +  {% set count_recs=count_recs + 1 %}
161 + {% endif %}
162 +{% endfor %}
163 +{% for batch in filteredRec|batch(3) %}
164 +   {% if batch|length==3 %}
165 +      {% for recommendation in batch %}
166 + {{ recommendation.name }}
167 + {{ recommendation.image_url }}
168 + {% if recommendation.priceim and recommendation.oldprice and recommendation.priceim != recommendation.oldprice %}
169 +   Цена: {{ recommendation.priceim }}
170 +   Старая цена: {{ recommendation.oldprice }}
171 + {% elseif recommendation.priceim %}
172 +   Цена: {{ recommendation.priceim }}
173 + {% else %}
174 +   Цена уточняется
175 + {% endif %}
176 + {% endfor %}
177 + {% endif %}
178 +{% endfor %}
179 +{{/code}}
180 +
181 +(% class="box" %)
182 +(((
183 +**Читайте также:**
184 +
185 +* [[Рекомендации>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome]]
186 +* [[Шаблонизатор сообщений>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]]
187 +)))
recommendations.png
Размер
... ... @@ -1,1 +1,1 @@
1 -14.2 KB
1 +23.1 KB
Содержимое
4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.arylov
Размер
... ... @@ -1,0 +1,1 @@
1 +1.4 KB
Содержимое
5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.arylov
Размер
... ... @@ -1,0 +1,1 @@
1 +1.4 KB
Содержимое
6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.arylov
Размер
... ... @@ -1,0 +1,1 @@
1 +1.1 KB
Содержимое
recommendation_manual.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.arylov
Размер
... ... @@ -1,0 +1,1 @@
1 +23.1 KB
Содержимое
Создано 22/12/2025 14:34
Отредактировано 06/02/2026 09:40

Новости
Обновления
Облако тегов
Словарь
Наш блог
YouTube и Rutube
Telegram