Loymax, 2026

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

От версии < 19.1 >

отредактировано Андрей Рылов
на 30/01/2026 10:57

К версии < 13.1 >

отредактировано Андрей Рылов
на 30/12/2025 11:32

Изменить комментарий: К данной версии нет комментариев

Необработанный
Обработанный

Комментарий

Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Вложения (2 изменено, 0 добавлено, 1 удалено)

Подробности

Свойства страницы

Содержимое

@@ -1,5 +1,5 @@
  (% class="lead" %)
--Функциональность рекомендаций позволяет выводить в текст сообщений продукты, подобранные по одному из поддерживаемых алгоритмов на основе предпочтений клиентов.
++Функциональность рекомендаций позволяет выводить в текст сообщений товары, подобранные по одному из поддерживаемых алгоритмов на основе предпочтений клиентов.
  {{info}}
  Функциональность рекомендаций поддерживается только при настроенной интеграции с модулем [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]].
@@ -16,7 +16,7 @@
 . Маркетолог создаёт рекомендацию в АРМ.
 . Маркетолог вставляет код рекомендации в сообщение.
--1. При генерации сообщения Loymax Smart Communications отправляет в [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]] запрос, содержащий:
++1. При генерации сообщения Loymax Smart Communications отправляет в Loymax AI запрос, содержащий:
 *. идентификатор клиента,
 *. название алгоритма рекомендации,
 *. параметры алгоритма (например, сколько продуктов рекомендовать).
@@ -25,11 +25,11 @@
  == Настройка рекомендаций ==
--Чтобы просмотреть список созданных рекомендаций, на панели слева перейдите в раздел **Рекомендации**.
++Чтобы просмотреть список созданных рекомендаций, на панели слева нажмите на узел **Рекомендации**.
  |(% style="border-color:#ffffff; text-align:center" %){{lightbox image="recommendations.png" width="660"/}}
--В разделе **Рекомендации** доступны следующие действия:
++Вы можете совершать следующие действия с рекомендациями:
  * Создать новую рекомендацию ([[image:1.png]]).
  * Отсортировать таблицу по содержимому любого столбца ([[image:2.png]]).
@@ -42,13 +42,7 @@
  * **Код рекомендации** — короткий код, который будет использоваться для добавления рекомендаций в сообщения.
  * **Наименование рекомендации** — человекочитаемое имя, которое будет отображаться в списке настроенных рекомендаций.
--* **Алгоритм рекомендации** — выберите требуемый алгоритм из списка:
--** [[Популярные товары>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B22"]]. Алгоритм, предлагающий самые популярные продукты из всего каталога, независимо от истории клиента.
--** [[Популярные товары в категории>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43E43F44343B44F44043D44B43544243E43243044044B43243A43044243543343E44043843822"]]. Алгоритм, предлагающий самые популярные продукты из категорий, к которым проявлял интерес клиент (просматривал, покупал, заказывал).
--** [[Похожие товары>>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="H41043B43343E44043844243C2242143E43243C43544144243D44B43543F43E43A44343F43A43822"]]. Алгоритм, предлагающий продукты, которые часто покупают вместе с продуктами, к которым проявлял интерес клиент.
--** [[Персональные товарные рекомендации>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome||anchor="H41043B43343E44043844243C2241F43544044143E43D43043B44C43D44B43544243E43243044043D44B43544043543A43E43C43543D43443044643843822"]]. Алгоритм, прогнозирующий будущие покупки клиента исходя из его истории и предлагающий продукты на основании данного прогноза.
--** [[Ручные рекомендации>>||anchor="H41D43044144244043E43943A43044044344743D44B44544043543A43E43C43543D434430446438439"]]. Алгоритм, предлагающий продукты на основании правил соответствия категорий без использования модуля Loymax AI.
++* **Алгоритм рекомендации** — выберите требуемый алгоритм из списка. Подробнее о поддерживаемых алгоритмах см. в [[отдельной статье>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome]].
  Настройте параметры рекомендации. Набор доступных параметров зависит от выбранного алгоритма.
@@ -67,13 +67,12 @@
  Для ручных рекомендаций доступны следующие настройки:
--* **Рекомендовать продукты на основе региона** ([[image:1.png]]). В зависимости от данной настройки, рекомендуемые продукты будут фильтроваться по значению поля **Регион** либо в [[профиле клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41F44043E44443843B44C43A43B43843543D442430"]], либо в последней web-сессии клиента.
--* **Период расчета** ([[image:2.png]]). Период, за который будут анализироваться чеки, чтобы определить продукты, чаще всего покупаемые вместе с целевыми.
--* **Рассчитывать на основе** ([[image:3.png]]). Аналогично остальным алгоритмам, источник, из которого Loymax Smart Communications будет брать целевые продукты.
--* **Целевая категория** ([[image:4.png]]). Категория, к продуктам из которой будут рассчитываться рекомендации. Чтобы добавить целевую категорию, нажмите **+ Добавить соответствие** в левом нижнем углу окна.
--* **Рекомендуемая категория** ([[image:5.png]]). Категория, продукты из которой будут предлагаться в качестве рекомендаций. К одной целевой категории можно выбрать несколько рекомендуемых. Чтобы добавить рекомендуемую категорию, нажмите **+ Добавить категорию**.
--* **Количество** ([[image:5.png]]). Количество продуктов из данной рекомендуемой категории, которое вернёт алгоритм. Количество задаётся отдельно для каждой рекомендуемой категории.
--* **Продвинутые настройки соответствия** ([[image:6.png]]). Нажмите **+ Добавить соответствие** в правой части окна, чтобы добавить поле, по которому требуется отфильтровать выдачу алгоритма. Продвинутые настройки соответствия задаются отдельно для каждой целевой категории (т.е. распространяются на все рекомендуемые категории).
++* **Период расчета** ([[image:1.png]]). Период, за который будут анализироваться чеки, чтобы определить продукты, чаще всего покупаемые вместе с целевыми.
++* **Рассчитывать на основе** ([[image:2.png]]). Аналогично остальным алгоритмам, источник, из которого Loymax Smart Communications будет брать целевые продукты.
++* **Целевая категория** ([[image:3.png]]). Категория, к продуктам из которой будут рассчитываться рекомендации. Чтобы добавить целевую категорию, нажмите **+ Добавить соответствие** в левом нижнем углу окна.
++* **Рекомендуемая категория** ([[image:4.png]]). Категория, продукты из которой будут предлагаться в качестве рекомендаций. К одной целевой категории можно выбрать несколько рекомендуемых. Чтобы добавить рекомендуемую категорию, нажмите **+ Добавить категорию**.
++* **Количество** ([[image:4.png]]). Количество продуктов из данной рекомендуемой категории, которое вернёт алгоритм. Количество задаётся отдельно для каждой рекомендуемой категории.
++* **Продвинутые настройки соответствия** ([[image:5.png]]). Нажмите **+ Добавить соответствие** в правой части окна, чтобы добавить поле, по которому требуется отфильтровать выдачу алгоритма. Продвинутые настройки соответствия задаются отдельно для каждой целевой категории (т.е. распространяются на все рекомендуемые категории).
  {{success}}
  * Для полей с числовыми типами данных, а также с типом данных "дата" доступен флажок **Точное соответствие**. Если он установлен, продукт будет рекомендован только при полном совпадении значения со значением соответствующего атрибута целевого продукта.
@@ -86,62 +86,63 @@
  Для отображения рекомендаций в сообщениях необходимо использовать конструкции [[шаблонизатора>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]].
--Рассмотрим пример добавления рекомендаций в сообщения. Мы хотим отправить клиентам 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##).
++Рассмотрим пример добавления рекомендаций в сообщения. Мы хотим отправить клиентам email-рассылку с рекомендациями по алгоритму //Совместные покупки// (для этого в Системе создана рекомендация с кодом ##sov_pok##). У некоторых клиентов ещё нет истории покупок, поэтому для них будем выдавать рекомендации по алгоритму //Популярные товары// (для этого в Системе создана рекомендация с кодом ##popular##).
--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"]].
--
--{{code language="twig"}}
++{{code}}
  {% set Rec=client.recommendations.sov_pok %}
  {% if not Rec or Rec|length < 3 %}
--   {% set Rec=client.recommendations.popular %}
++  {% set Rec=client.recommendations.popular %}
  {% endif %}
  {{/code}}
--(% start="2" %)
--1. Отфильтруем массив рекомендованных продуктов, оставив только те, которые можно купить в интернет-магазине (значение логического пользовательского [[поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] ##eComAvailable## — ##true##). Кроме того, для вывода в сообщение нам понадобится не более 9 продуктов (три ряда по три продукта).
--Для этого определим две новые переменные: в массив ##filteredRec## будут записываться отфильтрованные рекомендации, а переменная ##count_recs## будет служить в качестве счётчика.
--1. Переберём все продукты и добавим в массив те из них, которые не были добавлены ранее (на случай, если модуль Loymax AI вернул один и тот же продукт дважды) и которые доступны для заказа в интернет-магазине.
--При добавлении продукта в массив отфильтрованных рекомендаций значение переменной-счётчика увеличивается на 1. Таким образом, есть два сценария выхода из цикла: либо мы перебрали все продукты, либо мы отобрали 9 подходящих для добавления в сообщение.
++Теперь переменная ##Rec## хранит массив объектов Продукт (##product##), подобранных по алгоритму //Совместные покупки//, а если клиент не совершил достаточного количества покупок, то по алгоритму //Популярные товары//.
--{{code language="twig"}}
++Отфильтруем массив рекомендованных продуктов, оставив только те, которые можно купить в интернет-магазине (значение логического пользовательского [[поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] ##eComAvailable## — ##true##). Кроме того, для вывода в сообщение нам понадобится не более 9 продуктов (три ряда по три продукта).
++
++Для этого определим две новых переменные: в массив ##filteredRec## мы будем записывать отфильтрованные рекомендации, а переменная ##count_recs## будет служить в качестве счётчика.
++
++Переберём все продукты и добавим в массив те из них, которые не были добавлены ранее (таким образом обеспечивается дедупликация продуктов) и которые доступны для заказа в интернет-магазине. Каждый раз, когда мы добавляем продукт в массив отфильтрованных рекомендаций, значение переменной-счётчика увеличивается на 1. Таким образом, есть два сценария выхода из цикла: либо мы перебрали все продукты, либо мы отобрали 9 подходящих для добавления в сообщение. сбоощение
++
++{{code}}
  {% set count_recs=0 %}
  {% set filteredRec=[] %}
  {% for product in Rec %}
--   {% if product not in filteredRec and product.eComAvailable=='Y' and count_recs < 9 %}
--     {% set filteredRec=filteredRec|merge([product]) %}
--     {% set count_recs=count_recs + 1 %}
--   {% endif %}
++  {% if product not in filteredRec and product.eComAvailable=='Y' and count_recs < 9 %}
++    {% set filteredRec=filteredRec|merge([product]) %}
++    {% set count_recs=count_recs + 1 %}
++  {% endif %}
  {% endfor %}
  {{/code}}
--(% start="4" %)
--1. Разобьём отфильтрованные рекомендации на группы по три.
--1. Если в процессе фильтрации мы получили количество подходящих продуктов, не кратное 3, в последней группе будет меньше 3 продуктов (например, 7=3+3+1). Проверим и выведем в сообщение только те группы, в которых ровно три продукта.
--1. Для каждого продукта выведем наименование и изображение.
++Теперь разобьём отфильтрованные рекомендации на группы по три.
--{{code language="twig"}}
++Если в процессе фильтрации мы получили количество подходящих продуктов, не кратное 3, в последней группе будет меньше 3 продуктов (например, 7=3+3+1). Проверим и выведем в сообщение только те группы, в которых ровно три продукта.
++
++Для каждого продукта выведем наименование и изображение.
++
++{{code}}
  {% for batch in filteredRec|batch(3) %}
--   {% if batch|length==3 %}
--      {% for recommendation in batch %}
--         {{ recommendation.name }}
--         {{ recommendation.image_url }}
++    {% if batch|length==3 %}
++        {% for recommendation in batch %}}
++          {{ recommendation.name }}
++          {{ recommendation.image_url }}
  {{/code}}
--(% start="7" %)
--1. Далее реализуем такой сценарий:
--1*. если цена продукта менялась (значения полей текущей цены в интернет-магазине и старой цены не равны), выведем старую и новую цену;
--1*. если цена продукта не менялась и поле цены в интернет-магазине заполнено, выведем текущую цену;
--1*. если поле цены в интернет-магазине не заполнено, выведем "Цена уточняется".
++Далее реализуем такой сценарий:
--{{code language="twig"}}
++* если цена продукта менялась (значения полей текущей цены в интернет-магазине и старой цены не равны), выведем старую и новую цену;
++* если цена продукта не менялась и поле цены в интернет-магазине заполнено, выведем текущую цену;
++* если поле цены в интернет-магазине не заполнено, выведем "Цена уточняется".
++
++{{code}}
  {% if recommendation.priceim and recommendation.oldprice and recommendation.priceim != recommendation.oldprice %}
--   Цена: {{ recommendation.priceim }}
--   Старая цена: {{ recommendation.oldprice }}
++  Цена: {{ recommendation.priceim }}
++  Старая цена: {{ recommendation.oldprice_19 }}
  {% elseif recommendation.priceim %}
--   Цена: {{ recommendation.priceim }}
++  Цена: {{ recommendation.priceim }}
  {% else %}
--   Цена уточняется
++  Цена уточняется
  {% endif %}
  {% endfor %}
  {{/code}}
@@ -148,36 +148,38 @@
  В итоге получим следующую конструкцию:
--{{code language="twig"}}
++{{showhide showmessage="Показать пример" hidemessage="Скрыть пример"}}
++{{code}}
  {% set Rec=client.recommendations.sov_pok %}
  {% if not Rec or Rec|length < 3 %}
--   {% set Rec=client.recommendations.popular %}
++  {% set Rec=client.recommendations.popular %}
  {% endif %}
  {% set count_recs=0 %}
  {% set filteredRec=[] %}
  {% for product in Rec %}
--   {% if product not in filteredRec and product.eComAvailable=='Y' and count_recs < 9 %}
--     {% set filteredRec=filteredRec|merge([product]) %}
--     {% set count_recs=count_recs + 1 %}
--   {% endif %}
++  {% if product not in filteredRec and product.eComAvailable=='Y' and count_recs < 9 %}
++    {% set filteredRec=filteredRec|merge([product]) %}
++    {% set count_recs=count_recs + 1 %}
++  {% endif %}
  {% endfor %}
  {% for batch in filteredRec|batch(3) %}
--   {% if batch|length==3 %}
--      {% for recommendation in batch %}
--         {{ recommendation.name }}
--         {{ recommendation.image_url }}
--         {% if recommendation.priceim and recommendation.oldprice and recommendation.priceim != recommendation.oldprice %}
++    {% if batch|length==3 %}
++        {% for recommendation in batch %}}
++          {{ recommendation.name }}
++          {{ recommendation.image_url }}
++          {% if recommendation.priceim and recommendation.oldprice and recommendation.priceim != recommendation.oldprice %}
              Цена: {{ recommendation.priceim }}
--            Старая цена: {{ recommendation.oldprice }}
--         {% elseif recommendation.priceim %}
++            Старая цена: {{ recommendation.oldprice_19 }}
++          {% elseif recommendation.priceim %}
              Цена: {{ recommendation.priceim }}
--         {% else %}
++          {% else %}
              Цена уточняется
--         {% endif %}
--      {% endfor %}
--   {% endif %}
++          {% endif %}
++        {% endfor %}
++    {% endif %}
  {% endfor %}
  {{/code}}
++{{/showhide}}
  (% class="box" %)
  (((

6.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.arylov

Размер

...	...	@@ -1,1 +1,0 @@
1		-1.1 KB

Содержимое

recommendation_manual.png

Размер

@@ -1,1 +1,1 @@
--25.2 KB
++23.1 KB

Содержимое

recommendations.png

Размер

@@ -1,1 +1,1 @@
--23.1 KB
++14.2 KB

Содержимое

Создано 22/12/2025 14:34
Отредактировано 06/02/2026 09:40

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

Навигация

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

Комментарий

Подробности