# ⏱ Атрибуция и период хранения

Gravity Field позволяет управлять временем, в которое пользователь должен выполнить условия, и временем, сколько он будет оставаться в аудитории после этого. Эти два параметра — **ключевые для понимания того, кто и когда попадает в аудиторию**.

---

## 🕒 Окно атрибуции

**Окно атрибуции** — это период, в течение которого пользователь должен выполнить **все условия аудитории**, чтобы быть в неё зачисленным.
Измеряется в календарном времени или в рамках сессии.

### 📌 Доступные значения:
- `current session` — условия должны быть выполнены в рамках одной сессии
- `one day`
- `one week`
- `two weeks`
- `one month`
- `three months`
- `one year`

> В интерфейсе указывается один вариант на всю аудиторию. Условия не имеют индивидуальных окон.

Вы выбираете его в поле:  
**`All conditions must be met within`**

Это определяет, **в течение какого времени должны быть выполнены ВСЕ условия**, указанные в аудитории. Если условия не выполнены в рамках выбранного периода — пользователь не попадёт в сегмент.

### 🧩 Когда использовать `current session`

- Для условий, основанных на аффинитивности (`User affinity`)
- Для сценариев “реагирования” на текущие действия (например, нажатие на баннер, посещение страницы)
- Для realtime-сегментов: "купил и сразу бросил корзину", "начал интересоваться товаром", "зашёл на определённую страницу"

---

### 🧩 Когда использовать длительные окна (неделя / месяц / год)

- Для фиксации поведения в прошлом: покупка, регистрация, событие
- Для накопительных условий: `Products purchased → more than → 3`
- Для анализа повторных действий: "купил 2 раза за месяц", "приходил 4 раза за год"

---

**Примеры:**
- Пользователь должен **совершить 2 покупки и прийти из соцсетей в течение одной недели** — только тогда он попадёт в аудиторию.
```
Products purchased → at least → 2  
Traffic source → is → social  
Attribution window: one week
```

## 📆 Период хранения
**Период хранения** — это срок, в течение которого пользователь остаётся в аудитории, даже если больше не выполняет её условия.

Вы задаёте его в поле:  
**`Keep visitors within this Audience for`**

Это значение определяет, **как долго пользователь останется в аудитории**, даже если он перестанет выполнять условия.

Если пользователь **выполнил условия и попал в аудиторию**, но потом **перестал соответствовать**, он:
- остаётся в аудитории на заданный период
- может быть использован в персонализации, кампаниях, аналитике

### ✅ Когда использоват длинный retention (30–365 дней)

- Для A/B-тестов и аналитики
- Для стабильного таргетинга: “покупатели”, “VIP”, “повторные”
- Чтобы избежать выпадения пользователя из сегмента между визитами

### ✅ Когда использоват нулевой retention (`0`)

- Если пользователь должен быть в аудитории **только в момент выполнения условий**
- Для сегментов с быстрым откликом: “нажал кнопку”, “бросил корзину”, “зашёл в категорию”

---

### 🧠 Комбинации и паттерны

- `Attribution: one week` + `Retention: 30`  
  → фиксируем поведение за неделю, храним 30 дней

- `Attribution: session` + `Retention: 0`  
  → аудитория живая, только на время визита

- `Attribution: month` + `Retention: 365`  
  → накопительный сегмент (например, крупные покупатели) с долгим сроком хранения

---

**Примеры:**
- Хранить “интерес к товару” ещё 30 дней после визита → введите `30`
- Исключать сразу при несоответствии → введите `0`

---

> 🧩 Эти настройки работают вместе:  
> сначала проверяются условия внутри выбранного окна,  
> затем пользователь остаётся в аудитории на заданный срок — если условия были выполнены.

---

## 🧮 Типичные комбинации и сценарии

Ниже — таблица с часто используемыми комбинациями окна атрибуции и периода хранения, а также пояснением, в каких случаях они применяются.

| Окно атрибуции (Attribution window) | Период хранения (Retention period) | Когда использовать                                                      |
|------------------------------------|------------------------------------|--------------------------------------------------------------------------|
| `current session`                  | `0`                                | Для реактивных сценариев: "сейчас на сайте", "нажал", "посмотрел"       |
| `current session`                  | `7`                                | Пользователь проявил интерес → таргетировать в течение недели           |
| `one day`                          | `1–7`                              | Совершил действие за день → использовать в ближайшие дни                |
| `one week`                         | `30`                               | Поведение за неделю, сохраняем аудиторию на месяц                       |
| `one month`                        | `90`                               | Покупки, события, накопительное поведение → использовать до 3 мес.      |
| `three months`                     | `180–365`                          | Повторные покупатели, сезонные интересы, дорогие покупки                |
| `one year`                         | `365`                              | Годовая лояльность, большие покупки, воронки retargeting                |

> 💡 Не бойтесь использовать длинное хранение — это не “замораживает” поведение, а даёт стабильный сегмент для анализа и повторной активации.

> 💡 Эти значения — ориентиры. Для максимальной точности стоит опираться на вашу аналитику, реальные ретеншн-кривые и цикл покупки по категориям.

---

## 🧭 Где задаются эти параметры в интерфейсе

### 🕒 Окно атрибуции — *All conditions must be met within*

- **Находится** в основной секции условий аудитории
- **UI элемент:** селект (выпадающий список)
- **Подпись в интерфейсе:**  
  `All conditions must be met within [период] for a visitor to belong to this Audience`

### 📆 Период хранения — *Keep visitors within this Audience for*

- **Находится** в блоке **Advanced settings** при создании аудитории
- **UI элемент:** поле ввода числа (`input`)
- **Подпись в интерфейсе:**  
  `Keep visitors within this Audience for [X] days`