Loymax, 2026

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

От версии < 10.1 >

отредактировано Андрей Рылов
на 26/12/2025 14:35

К версии < 13.1 >

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

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

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

Комментарий

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

Подробности

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

Содержимое

@@ -1,8 +1,8 @@
  (% class="lead" %)
--Функционал рекомендаций позволяет выводить в текст сообщений товары, подобранные по одному из поддерживаемых алгоритмов на основе прошлых действий данного клиента.
++Функциональность рекомендаций позволяет выводить в текст сообщений товары, подобранные по одному из поддерживаемых алгоритмов на основе предпочтений клиентов.
  {{info}}
--Функционал рекомендаций поддерживается только при настроенной интеграции с модулем Loymax AI.
++Функциональность рекомендаций поддерживается только при настроенной интеграции с модулем [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]].
  {{/info}}
  (% class="box" %)
@@ -21,7 +21,7 @@
 *. название алгоритма рекомендации,
 *. параметры алгоритма (например, сколько продуктов рекомендовать).
 . Loymax AI возвращает массив продуктов, сформированный по указанному алгоритму.
--1. Loymax Smart Communications отправляет сообщение с рекомендациями.
++1. Loymax Smart Communications отправляет персонализированное сообщение с рекомендациями.
  == Настройка рекомендаций ==
@@ -47,7 +47,7 @@
  Настройте параметры рекомендации. Набор доступных параметров зависит от выбранного алгоритма.
  * **Количество рекомендаций** — количество продуктов, которые будет возвращать модуль Loymax AI.
--* **Рассчитывать на основе** — источник, из которого Loymax Smart Communications будет брать продукты (для расчёта рекомендаций по алгоритмам //Совместные покупки//, //Похожие товары//) или категории (для расчёта рекомендаций по алгоритму //Популярные товары в категории//).
++* **Рассчитывать на основе** — источник, из которого 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"]]).
  )))|(% style="border-color:white; text-align:center; width:30%" %){{lightbox image="recommendation_edit.png" width="400"/}}
  === Настройка ручных рекомендаций ===
@@ -69,11 +69,9 @@
  * **Продвинутые настройки соответствия** ([[image:5.png]]). Нажмите **+ Добавить соответствие** в правой части окна, чтобы добавить поле, по которому требуется отфильтровать выдачу алгоритма. Продвинутые настройки соответствия задаются отдельно для каждой целевой категории (т.е. распространяются на все рекомендуемые категории).
  {{success}}
--Для полей с числовыми типами данных, а также с типом данных "дата" доступен флажок **Точное соответствие**. Если он установлен, продукт будет рекомендован только при полном совпадении значения со значением соответствующего атрибута целевого продукта.
--
--Для полей с типами данных "строка" и "логическое" всегда требуется точное соответствие.
--
--Если флажок **Точное соответствие** снят, продукт попадёт в рекомендации, если он отличается от целевого продукта по значению атрибута не более чем на 15%.
++* Для полей с числовыми типами данных, а также с типом данных "дата" доступен флажок **Точное соответствие**. Если он установлен, продукт будет рекомендован только при полном совпадении значения со значением соответствующего атрибута целевого продукта.
++* Для полей с типами данных "строка" и "логическое" всегда требуется точное соответствие.
++* Если флажок **Точное соответствие** снят, продукт попадёт в рекомендации, если он отличается от целевого продукта по значению атрибута не более чем на 15%.
  {{/success}}
  )))|(% style="border-color:white; text-align:center; width:30%" %){{lightbox image="recommendation_manual.png" width="400"/}}
@@ -81,10 +81,8 @@
  Для отображения рекомендаций в сообщениях необходимо использовать конструкции [[шаблонизатора>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]].
--Рассмотрим пример добавления рекомендаций в сообщения. Мы хотим отправить клиентам email-рассылку с рекомендациями по алгоритму //Совместные покупки// (для этого в Системе создана рекомендация с кодом ##sov_pok##). У некоторых клиентов еще нет истории покупок, поэтому для них будем выдавать рекомендации по алгоритму //Популярные товары// (для этого в Системе создана рекомендация с кодом ##popular##).
++Рассмотрим пример добавления рекомендаций в сообщения. Мы хотим отправить клиентам email-рассылку с рекомендациями по алгоритму //Совместные покупки// (для этого в Системе создана рекомендация с кодом ##sov_pok##). У некоторых клиентов ещё нет истории покупок, поэтому для них будем выдавать рекомендации по алгоритму //Популярные товары// (для этого в Системе создана рекомендация с кодом ##popular##).
--Для удобства работы определим переменную и проверим, можем ли мы рекомендовать клиенту хотя бы три продукта по алгоритму //Совместные покупки//.
--
  {{code}}
  {% set Rec=client.recommendations.sov_pok %}
  {% if not Rec or Rec|length < 3 %}
@@ -93,106 +93,96 @@
  {{/code}}
++Теперь переменная ##Rec## хранит массив объектов Продукт (##product##), подобранных по алгоритму //Совместные покупки//, а если клиент не совершил достаточного количества покупок, то по алгоритму //Популярные товары//.
--{% set count_recs=0 %}{% set filteredRecommendation=[] %}
--{% for recommendation in clientRecommendation %}
--{% set item=recommendation %}
--{% if item not in filteredRecommendation and item.eComAvailable=='Y' and count_recs < 9 %}
-- {% set filteredRecommendation=filteredRecommendation|merge([item]) %}
-- {% set count_recs=count_recs + 1 %}
--{% endif %}
--{% endfor %}
--{% for batchrecommendation in filteredRecommendation|batch(3) %}##
--(% style="font-family:Menlo,Monaco,Consolas,~"Courier New~",monospace; white-space:pre" %){% if batchrecommendation|length == 3 %}(%%)##
++Отфильтруем массив рекомендованных продуктов, оставив только те, которые можно купить в интернет-магазине (значение логического пользовательского [[поля>>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 %}
++{% endfor %}
++{{/code}}
--(% class="box" %)
--(((
--##{% set clientRecommendation=client.recommendations('RelatedPurchases') %}##
--)))
++Теперь разобьём отфильтрованные рекомендации на группы по три.
--* (((
--=== Получение товарных рекомендаций методом "Популярные" ===
--)))
++Если в процессе фильтрации мы получили количество подходящих продуктов, не кратное 3, в последней группе будет меньше 3 продуктов (например, 7=3+3+1). Проверим и выведем в сообщение только те группы, в которых ровно три продукта.
--Если после обработки целевым методом товаров нет или недостаточно, то выполняется запрос по методу **Популярные**:
++Для каждого продукта выведем наименование и изображение.
--(% class="box" %)
--(((
--##{% if not clientRecommendation or clientRecommendation|length < 3 %}
--    {% set clientRecommendation=client.recommendations('Popular') %}
--{% endif %}##
--)))
++{{code}}
++{% for batch in filteredRec|batch(3) %}
++    {% if batch|length==3 %}
++        {% for recommendation in batch %}}
++          {{ recommendation.name }}
++          {{ recommendation.image_url }}
++{{/code}}
--В результате создаётся массив отфильтрованных товаров, которые соответствуют условиям ниже:
++Далее реализуем такой сценарий:
--(% class="box" %)
--(((
--##{% set count_recs=0 %}
--{% set filteredRecommendation=[] %}
--{% for recommendation in clientRecommendation %}
--    {% set item=recommendation %}##
--)))
++* если цена продукта менялась (значения полей текущей цены в интернет-магазине и старой цены не равны), выведем старую и новую цену;
++* если цена продукта не менялась и поле цены в интернет-магазине заполнено, выведем текущую цену;
++* если поле цены в интернет-магазине не заполнено, выведем "Цена уточняется".
--Далее из массива товаров выбираются только те товары, в которых атрибут ##eComAvailable=='Y'##. Аналогичным образом товары добавляются в массив отсортированных до тех пор, пока не наберётся 9 штук:
++{{code}}
++{% if recommendation.priceim and recommendation.oldprice and recommendation.priceim != recommendation.oldprice %}
++  Цена: {{ recommendation.priceim }}
++  Старая цена: {{ recommendation.oldprice_19 }}
++{% elseif recommendation.priceim %}
++  Цена: {{ recommendation.priceim }}
++{% else %}
++  Цена уточняется
++{% endif %}
++{% endfor %}
++{{/code}}
--(% class="box" %)
--(((
--     ## {% if item not in filteredRecommendation and item.eComAvailable=='Y' and count_recs < 9 %}
--        {% set filteredRecommendation=filteredRecommendation|merge([item]) %}
--        {% set count_recs=count_recs + 1 %}
++В итоге получим следующую конструкцию:
++
++{{showhide showmessage="Показать пример" hidemessage="Скрыть пример"}}
++{{code}}
++{% set Rec=client.recommendations.sov_pok %}
++{% if not Rec or Rec|length < 3 %}
++  {% 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 %}
++{% 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 %}
++            Цена: {{ recommendation.priceim }}
++            Старая цена: {{ recommendation.oldprice_19 }}
++          {% elseif recommendation.priceim %}
++            Цена: {{ recommendation.priceim }}
++          {% else %}
++            Цена уточняется
++          {% endif %}
++        {% endfor %}
      {% endif %}
--{% endfor %}##
--)))
++{% endfor %}
++{{/code}}
++{{/showhide}}
--* (((
--=== Вывод товаров ===
--)))
--
--Товары выводятся строго по 3 штуки на 1 строку:
--
  (% class="box" %)
  (((
--##{% for batchrecommendation in filteredRecommendation|batch(3) %}
--    {% if batchrecommendation|length==3 %}
--        {% for recommendation in batchrecommendation %}}##
--)))
++**Читайте также:**
--* (((
--=== Вывод цен ===
++* [[Рекомендации>>doc:Main.General_information.Loymax_Loyalty.recommendation_systems.Commercial_recommendations.WebHome]]
++* [[Шаблонизатор сообщений>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]]
  )))
--
--Если заполнены атрибуты старой и новой цены и они отличаются друг от друга, то выводятся обе цены:
--
--(% class="box" %)
--(((
--##{% if recommendation.priceim and recommendation.oldprice_19 and recommendation.priceim != recommendation.oldprice_19 %}
--    ~{~{ recommendation.priceim }}
--    ~{~{ recommendation.oldprice_19 }}##
--)))
--
--Если заполнен атрибут цены Интернет-магазина (##priceim)##, выводится цена Интернет-магазина:
--
--(% class="box" %)
--(((
--##{% elseif recommendation.priceim %}
--    ~{~{ recommendation.priceim }}##
--)))
--
--Если нет данных, то отображается "n/a":
--
--(% class="box" %)
--(((
--##{% else %}
--    n/a
--{% endif %}##
--)))

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

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

Навигация

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

Комментарий

Подробности