Любимый товар

Функциональность позволяет персонализировать предложение на конкретный товар, выбранный клиентом. Это решает задачи:

точечные персональные промо (скидка на конкретный SKU);
повышенный кешбэк / бонусы на «любимый» товар.

Для фиксации выбранного товара используются атрибуты типа sku или product.
Значение такого атрибута — объект следующего вида:

{
  "ref_type": "sku",
  "ref_id": "171850"
}

ref_type — тип ссылки (sku или product);
ref_id — идентификатор товара согласно выбранному типу.

Готовые атрибуты в системе

В Sailplay уже заведён набор атрибутов, готовых к использованию:

favorite_product — любимый товар (sku)
favorite_product_ecomm — любимый товар в e‑commerce (sku)
favorite_product_retail — любимый товар в рознице (sku)

При необходимости можно завести дополнительный атрибут по инструкции из раздела Атрибуты клиентов, обязательно указав подтип reference.

Добавление атрибута клиенту

Для добавления используется метод
/api/v2/users/attributes/set-values-for-user/

Пример структуры параметра attributes:

[
  {
    "name": "favorite_product",
    "value": {
      "ref_type": "sku",
      "ref_id": "171850"
    }
  }
]

На текущий момент система поддерживает только один товар для одного reference‑атрибута
(is_array = false).

Процесс использования (end‑to‑end)

1. Подготовка

Убедитесь, что существует один из атрибутов: favorite_product, favorite_product_ecomm, favorite_product_retail
Для нового атрибута задайте ref_type (sku или product)

2. Выбор товара клиентом

На карточке товара или в корзине пользователь нажимает
«Сделать любимым» / «Выбрать для персональной скидки»
Фронтенд определяет SKU или ID товара и передаёт его в бэкенд

3. Привязка товара к клиенту через API

curl --request POST   --url https://api.sailplay.ru/api/v2/users/attributes/set-values-for-user/   --header 'Content-Type: application/x-www-form-urlencoded'   --data token=***   --data store_department_id=***   --data user_phone=79998880011   --data 'attributes=[{"name":"favorite_product","value":{"ref_type":"sku","ref_id":"171850"}}]'

Запрос перезапишет прежнее значение или создаст новое, если атрибут ранее отсутствовал.

4. Настройка акции в личном кабинете

Создайте или отредактируйте акцию
Тип вознаграждения: Скидка на товар → Предпочтения клиента
Выберите соответствующий reference‑атрибут
Настройте остальные параметры акции (размер скидки, период, приоритеты)

Если используются разные атрибуты для разных каналов — создайте отдельные акции.

5. Применение скидки при покупке

При расчёте корзины система:

считывает значение reference‑атрибута клиента;
сопоставляет ref_id с позициями заказа;
применяет скидку или кешбэк к совпавшим товарам.

6. Отображение выбранного товара клиенту

Получите значения атрибутов клиента:

curl --request GET   --url https://api.sailplay.ru/api/v2/users/attributes/get-values-by-user/   --header 'Content-Type: application/x-www-form-urlencoded'   --data token=***   --data store_department_id=***   --data user_phone=79998880011   --data 'attributes=favorite_product'

Ответ:

{
  "status": "ok",
  "result": {
    "favorite_product": [
      {
        "value": {
          "ref_type": "sku",
          "ref_id": "171850"
        }
      }
    ]
  }
}

На фронтенде отобразите карточку товара по ref_id из вашего каталога.

7. Обновление выбора

Для смены товара повторите шаг 3, передав новый ref_id.

Готовые атрибуты в системе​

Добавление атрибута клиенту​

Процесс использования (end‑to‑end)​

1. Подготовка​

2. Выбор товара клиентом​

3. Привязка товара к клиенту через API​

4. Настройка акции в личном кабинете​

5. Применение скидки при покупке​

6. Отображение выбранного товара клиенту​

7. Обновление выбора​

Рекомендации​