API: Удержание
Когортный анализ, метрики возвращаемости и жизненный цикл клиентов
Удержание (Retention) показывает, какой процент пользователей возвращается в ваш продукт после первого визита. Это ключевая метрика для оценки качества продукта и долгосрочной ценности клиентов.
Основные понятия
Когорта
Группа пользователей, объединенных по времени первого визита (например, все пользователи, пришедшие 1 марта 2026).
Retention (Удержание)
Процент пользователей из когорты, которые вернулись в определенный день. Например, Retention Day 7 показывает, сколько пользователей вернулись на 7-й день после первого визита.
LTV (Lifetime Value)
Прогнозируемая прибыль, которую принесет клиент за все время использования продукта. Рассчитывается на основе удержания и среднего чека.
Визуализация удержания
График удержания
График показывает динамику удержания для ключевых дней (1, 7, 30) по последним когортам:
Когортная таблица
Классическое представление удержания, где каждая строка — когорта, а столбцы — дни жизни:
🟢 Высокое (>40%) 🟡 Среднее (20-40%) 🔴 Низкое (<20%)
Эндпоинты
1. Получение данных удержания
GET /api/retention?cohort_from=...&cohort_to=... — данные для построения когортной таблицы и графика удержания.
Параметры запроса
| Параметр | Описание | По умолчанию |
|---|---|---|
cohort_from |
Начальная дата для когорт (YYYY-MM-DD) | -30 дней |
cohort_to |
Конечная дата для когорт (YYYY-MM-DD) | сегодня |
app_id |
Фильтр по приложению | все приложения |
Пример запроса
curl -X GET "https://api.instantbase.ru/api/retention?cohort_from=2026-03-01&cohort_to=2026-03-19" \
-H "Cookie: session_id=ваша_сессия"Пример ответа
{
"cohorts": {
"2026-03-01": {
"total": 245,
"days": {
"0": 100,
"1": 42.5,
"2": 35.2,
"3": 32.1,
"4": 30.0,
"5": 28.4,
"6": 27.1,
"7": 26.3,
"14": 21.5,
"30": 18.2
}
},
"2026-03-02": {
"total": 312,
"days": {
"0": 100,
"1": 45.1,
"2": 38.4,
"3": 34.2,
"4": 31.5,
"5": 29.8,
"6": 27.6,
"7": 25.9
}
}
},
"period": {
"from": "2026-03-01",
"to": "2026-03-19"
}
}2. Получение агрегированных метрик удержания
GET /api/retention/summary?from=...&to=... — сводные метрики удержания за период.
Пример ответа
{
"success": true,
"retention_day1": 43.2,
"retention_day7": 26.5,
"retention_day30": 17.8,
"retention_day90": 9.3,
"average_lifetime_days": 24.5,
"ltv": 3240.50
}Интерпретация метрик удержания
| Показатель | Отлично | Хорошо | Средне | Плохо |
|---|---|---|---|---|
| Retention Day 1 | >50% | 40-50% | 30-40% | <30% |
| Retention Day 7 | >30% | 20-30% | 15-20% | <15% |
| Retention Day 30 | >20% | 15-20% | 10-15% | <10% |
Нужна помощь с анализом удержания?
Напишите нам, и мы поможем интерпретировать метрики