Навигация

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

<
От версии < 17.1 >
отредактировано Андрей Рылов
на 30/01/2026 10:24
К версии < 23.1
отредактировано Андрей Рылов
на 06/02/2026 09:40
Изменить комментарий: Renamed back-links.

Комментарий

Подробности

Свойства страницы
Название
... ... @@ -1,1 +1,1 @@
1 -Рекомендации
1 +Товарные рекомендации
Родительский документ
... ... @@ -1,1 +1,1 @@
1 -Sandbox.WebHome
1 +Main.Using.Smart_Communications.WebHome
Содержимое
... ... @@ -1,8 +1,8 @@
1 1  (% class="lead" %)
2 -Функциональность рекомендаций позволяет выводить в текст сообщений продукты, подобранные по одному из поддерживаемых алгоритмов на основе предпочтений клиентов.
2 +Функциональность товарных рекомендаций позволяет выводить в текст сообщений продукты, подобранные по одному из поддерживаемых алгоритмов на основе предпочтений клиентов.
3 3  
4 4  {{info}}
5 -Функциональность рекомендаций поддерживается только при настроенной интеграции с модулем [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]].
5 +Функциональность товарных рекомендаций поддерживается только при настроенной интеграции с модулем [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]].
6 6  {{/info}}
7 7  
8 8  (% class="box" %)
... ... @@ -16,14 +16,11 @@
16 16  
17 17  1. Маркетолог создаёт рекомендацию в АРМ.
18 18  1. Маркетолог вставляет код рекомендации в сообщение.
19 -1. При генерации сообщения Loymax Smart Communications отправляет в [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]] запрос, содержащий:
20 -1*. идентификатор клиента,
21 -1*. название алгоритма рекомендации,
22 -1*. параметры алгоритма (например, сколько продуктов рекомендовать).
19 +1. При формировании сообщения Loymax Smart Communications отправляет в [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]] запрос рекомендованных продуктов.
23 23  1. Loymax AI возвращает массив продуктов, сформированный по указанному алгоритму.
24 24  1. Loymax Smart Communications отправляет персонализированное сообщение с рекомендациями.
25 25  
26 -== Настройка рекомендаций ==
23 +== Создание рекомендаций с использованием алгоритмов Loymax AI ==
27 27  
28 28  Чтобы просмотреть список созданных рекомендаций, на панели слева перейдите в раздел **Рекомендации**.
29 29  
... ... @@ -43,40 +43,41 @@
43 43  * **Код рекомендации** — короткий код, который будет использоваться для добавления рекомендаций в сообщения.
44 44  * **Наименование рекомендации** — человекочитаемое имя, которое будет отображаться в списке настроенных рекомендаций.
45 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"]]. Алгоритм, прогнозирующий будущие покупки клиента исходя из его истории и предлагающий продукты на основании данного прогноза.
43 +** [[Популярные товары>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B22"]]. Алгоритм, предлагающий самые популярные продукты из всего каталога, независимо от истории клиента.
44 +** [[Популярные товары в категории>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B43243A43044243543343E44043843822"]]. Алгоритм, предлагающий самые популярные продукты из категорий, к которым проявлял интерес клиент (просматривал, покупал, заказывал).
45 +** [[Похожие товары>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E44543E43643843544243E43243044044B22"]]. Алгоритм, предлагающий продукты, похожие на те, к которым проявлял интерес клиент.
46 +** [[Совместные покупки>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]]. Алгоритм, предлагающий продукты, которые часто покупают вместе с продуктами, к которым проявлял интерес клиент.
47 +** [[Персональные товарные рекомендации>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43544044143E43D43043B44C43D44B43544243E43243044043D44B43544043543A43E43C43543D43443044643843822"]]. Алгоритм, прогнозирующий будущие покупки клиента исходя из его истории и предлагающий продукты на основании данного прогноза.
51 51  ** [[Ручные рекомендации>>||anchor="H41D43044144244043E43943A43044044344743D44B44544043543A43E43C43543D434430446438439"]]. Алгоритм, предлагающий продукты на основании правил соответствия категорий без использования модуля Loymax AI.
52 52  
53 53  Настройте параметры рекомендации. Набор доступных параметров зависит от выбранного алгоритма.
54 54  
55 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"]]).
53 +* **Рассчитывать на основе** — источник, из которого Loymax Smart Communications будет брать продукты (для расчёта рекомендаций по алгоритмам [[Совместные покупки>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]], [[Похожие товары>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E44543E43643843544243E43243044044B22"]]) или категории (для расчёта рекомендаций по алгоритму [[Популярные товары в категории>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B43243A43044243543343E44043843822"]]).
57 57  )))|(% style="border-color:white; text-align:center; width:30%" %){{lightbox image="recommendation_edit.png" width="400"/}}
58 58  
59 -=== Настройка ручных рекомендаций ===
56 +== Создание ручных рекомендаций ==
60 60  
61 61  |(% style="border-color:white; width:70%" %)(((
62 62  Ручные рекомендации отличаются от всех остальных алгоритмов тем, что расчёт рекомендаций полностью осуществляется на стороне Loymax Smart Communications. Ручные рекомендации рассчитываются раз в сутки в соответствии с настроенными параметрами.
63 63  
64 -Для продуктов, относящихся к заданной **Целевой категории** и полученных из заданного источника (поле **Рассчитывать на основе**), подбираются продукты из **Рекомендованных категорий**, которые чаще всего присутствуют в чеках вместе с целевым продуктом. Алгоритм вернёт N наиболее популярных продуктов, где N — значение, заданное в поле **Количество**.
61 +При расчёте ручных рекомендаций Система проверяет заданный источник (поле **Рассчитывать на основе**) на наличие продуктов, относящихся к заданной **Целевой категории**. Затем Система подбирает продукты из **Рекомендованных категорий**, которые чаще всего присутствуют в чеках вместе с целевым продуктом. Алгоритм вернёт N наиболее популярных продуктов, где N — значение, заданное в поле **Количество**.
65 65  
66 66  Рекомендации можно дополнительно ограничить: если заданы **Продвинутые настройки соответствия**, алгоритм будет предлагать только продукты, у которых значения заданных параметров соответствуют значениям параметров целевого продукта.
67 67  
68 68  Для ручных рекомендаций доступны следующие настройки:
69 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]]). Нажмите **+ Добавить соответствие** в правой части окна, чтобы добавить поле, по которому требуется отфильтровать выдачу алгоритма. Продвинутые настройки соответствия задаются отдельно для каждой целевой категории (т.е. распространяются на все рекомендуемые категории).
67 +* **Рекомендовать продукты на основе региона** ([[image:1.png]]). В зависимости от данной настройки, рекомендуемые продукты будут фильтроваться по значению поля **Регион** либо в [[профиле клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41F44043E44443843B44C43A43B43843543D442430"]], либо в последней web-сессии клиента.
68 +* **Период расчета** ([[image:2.png]]). Период, за который будут анализироваться чеки, чтобы определить продукты, чаще всего покупаемые вместе с целевыми.
69 +* **Рассчитывать на основе** ([[image:3.png]]). Аналогично остальным алгоритмам, источник, из которого Loymax Smart Communications будет брать целевые продукты.
70 +* **Целевая категория** ([[image:4.png]]). Категория, к продуктам из которой будут рассчитываться рекомендации. Чтобы добавить целевую категорию, нажмите **+ Добавить соответствие** в левом нижнем углу окна.
71 +* **Рекомендуемая категория** ([[image:5.png]]). Категория, продукты из которой будут предлагаться в качестве рекомендаций. К одной целевой категории можно выбрать несколько рекомендуемых. Чтобы добавить рекомендуемую категорию, нажмите **+ Добавить категорию**.
72 +* **Количество** ([[image:5.png]]). Количество продуктов из данной рекомендуемой категории, которое вернёт алгоритм. Количество задаётся отдельно для каждой рекомендуемой категории.
73 +* **Продвинутые настройки соответствия** ([[image:6.png]]). Нажмите **+ Добавить соответствие** в правой части окна, чтобы добавить поле, по которому требуется отфильтровать выдачу алгоритма. Продвинутые настройки соответствия задаются отдельно для каждой целевой категории (т.е. распространяются на все рекомендуемые категории).
76 76  
77 77  {{success}}
78 -* Для полей с числовыми типами данных, а также с типом данных "дата" доступен флажок **Точное соответствие**. Если он установлен, продукт будет рекомендован только при полном совпадении значения со значением соответствующего атрибута целевого продукта.
79 -* Для полей с типами данных "строка" и "логическое" всегда требуется точное соответствие.
76 +* Для полей с числовыми типами данных, а также с типом данных **дата** доступен флажок **Точное соответствие**. Если он установлен, продукт будет рекомендован только при полном совпадении значения со значением соответствующего атрибута целевого продукта.
77 +* Для полей с типами данных **строка** и **логическое** всегда требуется точное соответствие.
80 80  * Если флажок **Точное соответствие** снят, продукт попадёт в рекомендации, если он отличается от целевого продукта по значению атрибута не более чем на 15%.
81 81  {{/success}}
82 82  )))|(% style="border-color:white; text-align:center; width:30%" %){{lightbox image="recommendation_manual.png" width="400"/}}
... ... @@ -85,10 +85,12 @@
85 85  
86 86  Для отображения рекомендаций в сообщениях необходимо использовать конструкции [[шаблонизатора>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]].
87 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##).
86 +Рассмотрим пример добавления рекомендаций в сообщения. Требуется отправить клиентам email-рассылку с рекомендациями по алгоритму [[Совместные покупки>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]] (для этого в Системе создана рекомендация с кодом ##sov_pok##). У некоторых клиентов ещё нет истории покупок, поэтому для них будут выдаваться рекомендации по алгоритму [[Популярные товары>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B22"]] (для этого в Системе создана рекомендация с кодом ##popular##).
89 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"]].
88 +Вёрстка письма предполагает размещение от 3 до 9 карточек продукта — от одного до трёх рядов по три карточки. Рекомендовать можно только те продукты, которые можно заказать в Интернет-магазине. Также необходимо вывести в сообщение цену продукта, а если цена менялась — старую и новую цену.
91 91  
90 +1. Определим переменную ##Rec## и запишем в нее массив объектов Продукт (##product##), подобранных по алгоритму [[Совместные покупки>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]], а если клиент не совершил достаточного количества покупок, то по алгоритму [[Популярные товары>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B22"]].
91 +
92 92  {{code language="twig"}}
93 93  {% set Rec=client.recommendations.sov_pok %}
94 94  {% if not Rec or Rec|length < 3 %}
... ... @@ -98,10 +98,9 @@
98 98  {{/code}}
99 99  
100 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 подходящих для добавления в сообщение.
101 +1. Отфильтруем массив рекомендованных продуктов, оставив только те, которые можно купить в интернет-магазине (значение логического пользовательского [[поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] ##eComAvailable## — ##true##). Для этого определим переменную ##filteredRec##, в которую будут записываться отфильтрованные рекомендации.
102 +1. Для вывода в сообщение понадобится не более 9 продуктов (три ряда по три продукта). Определим переменную ##count_recs##, которая будет служить в качестве счётчика: при каждом добавлении продукта в массив отфильтрованных рекомендаций значение счётчика будет увеличиваться на 1.
103 +1. Переберём все продукты и добавим в массив те из них, которые не были добавлены ранее (на случай, если модуль Loymax AI вернул один и тот же продукт дважды) и которые доступны для заказа в интернет-магазине. Также проверим значение счётчика и добавим продукт, только если ещё не набралось 9 рекомендаций.
105 105  
106 106  {{code language="twig"}}
107 107  {% set count_recs=0 %}
... ... @@ -114,9 +114,9 @@
114 114  {% endfor %}
115 115  {{/code}}
116 116  
117 -(% start="4" %)
116 +(% start="5" %)
118 118  1. Разобьём отфильтрованные рекомендации на группы по три.
119 -1. Если в процессе фильтрации мы получили количество подходящих продуктов, не кратное 3, в последней группе будет меньше 3 продуктов (например, 7=3+3+1). Проверим и выведем в сообщение только те группы, в которых ровно три продукта.
118 +1. Если в процессе фильтрации получилось количество подходящих продуктов, не кратное 3, в последней группе будет меньше 3 продуктов (например, 7=3+3+1). Проверим и выведем в сообщение только те группы, в которых ровно три продукта.
120 120  1. Для каждого продукта выведем наименование и изображение.
121 121  
122 122  {{code language="twig"}}
... ... @@ -127,7 +127,7 @@
127 127   {{ recommendation.image_url }}
128 128  {{/code}}
129 129  
130 -(% start="7" %)
129 +(% start="8" %)
131 131  1. Далее реализуем такой сценарий:
132 132  1*. если цена продукта менялась (значения полей текущей цены в интернет-магазине и старой цены не равны), выведем старую и новую цену;
133 133  1*. если цена продукта не менялась и поле цены в интернет-магазине заполнено, выведем текущую цену;
... ... @@ -182,6 +182,6 @@
182 182  (((
183 183  **Читайте также:**
184 184  
185 -* [[Рекомендации>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome]]
184 +* [[Алгоритмы товарных рекомендаций>>doc:Main.General_information.Loymax_AI.Commercial_recommendations.WebHome]]
186 186  * [[Шаблонизатор сообщений>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]]
187 187  )))
recommendation_manual.png
Размер
... ... @@ -1,1 +1,1 @@
1 -23.1 KB
1 +25.2 KB
Содержимое
Создано 22/12/2025 14:34
Отредактировано 06/02/2026 09:40

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