Навигация

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

<
От версии < 20.1 >
отредактировано Андрей Рылов
на 03/02/2026 06:27
К версии < 2.1 >
отредактировано Андрей Рылов
на 23/12/2025 08:25
>
Изменить комментарий: Загрузить новое изображение recommendations.png

Комментарий

Подробности

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

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