# 🧬 Affinity-профиль

Профиль аффинитивности пользователя собирается для каждого пользователя на основании:

Событий
Ценности атрибутов товара

При любом из типов интеграции на пользовательском уровне мы сохраняем и агрегируем все значения свойств товара, с которым взаимодействовал пользователь. Эти значения используются для вычисления оценки аффинитивности для каждого из этих свойств. Данные оценки суммируются по количеству взаимодействий с товаром, отдавая предпочтение недавним действиям и действиям, отражающим повышенный интерес.

Аффинитивность собирается по следующим событиям:

Page view
Product View
Add to Cart
Purchase
Add to favorites

# 📦 Товарный фид и атрибуты

По умолчанию Affinity Score считается по полю categories (вся иерархия).
Чтобы учитывать другие поля (например, brand, color, gender), их необходимо указать через менеджера по персонализации.
Рекомендуемое количество атрибутов — до 5, максимум — 10.

# ⚙️ События и вес

Событие	Вес действия
Просмотр товара	2
Добавление в избранное	2
Добавление в корзину	4
Покупка	6

Также учитываются коэффициенты давности:

Срок взаимодействия	Коэффициент
До 2 дней	8
До 30 дней	2
До 180 дней	1

# 🔍 Пример оценки по типу действия

Если пользователь 4 раза посмотрел товар, 1 раз добавил в корзину и 1 раз купил:

(4 × 2 × 1) + (1 × 4 × 20) + (1 × 6 × 60) = 8 + 80 + 360 = 448

# 🔍 Пример оценки с учётом давности

Сессия	Действие	Вес	Коэфф.	Итог
15 дней назад	Просмотр × 4	2	2	16
15 дней назад	В корзину ×1	4	2	8
Сейчас	Покупка ×1	6	8	48
				72

# 📌 Где используется Affinity-профиль?

В стратегиях с алгоритмом User Affinity
Для выбора fallback-товаров, если основной алгоритм не дал результата
При закреплении товаров (Pin), если нужный SKU не найден
В построении аудиторий на основе предпочтений

# 🧱 Требования к фиду

Выбрать атрибуты для сбора предпочтений (color, size, brand…)
Убедиться в:
- Однородности значений (например: Белый, белый → белый)
- Заполненности большинства товаров по этим атрибутам
- Дискретности значений (ограниченный список, без уникальных ID)

# ⏱ Срок хранения и обновления

События хранятся до 180 дней
Оценки обновляются автоматически при каждом взаимодействии

# ❓ FAQ

# Какие поля можно использовать для построения Affinity-профиля?

Только те, что содержат дискретные значения — например, brand, color, gender, style. Нельзя использовать поля с уникальными или числовыми значениями (например, price, sku, name).

# Где настраиваются поля, участвующие в профиле?

По умолчанию используется categories. Остальные поля настраиваются вручную через Менеджера по Персонализации. Максимум — 10 полей (оптимально — до 5).

# Когда начинается сбор Affinity-профиля?

Сразу после первого действия пользователя на сайте (просмотр, добавление в избранное, в корзину, покупка).

# Какой срок хранения предпочтений?

Данные об интересах пользователя хранятся и участвуют в расчётах до 180 дней.

# Можно ли сбросить или обновить Affinity-профиль вручную?

Нет, профиль обновляется автоматически на основе пользовательских действий.

# Какие действия учитываются?

Просмотр товара (Product View)
Добавление в избранное (Add to Favorites)
Добавление в корзину (Add to Cart)
Покупка (Purchase)
Просмотр страницы (Page View)

❗️Фильтрация не учитывается

# Как Affinity влияет на рекомендации?

Affinity используется в:

Алгоритме User Affinity (все страницы)
Фолбеке, если основной алгоритм не дал результата
При выборе товара в Pin, если SKU не найден в фиде или стратегии

# Могут ли быть использованы товары, которых больше нет в наличии?

В Affinity-профиле они учитываются, но при расчёте рекомендаций система исключает товары, у которых in_stock = false, если это указано в настройках стратегии.

# Как Affinity работает на разных устройствах?

Если реализована идентификация пользователя (через cuid) — поведение агрегируется между устройствами.