🎯 Настройка воронок

Стройте воронки продаж, отслеживайте конверсию между шагами и оптимизируйте пользовательский путь

Пример воронки интернет-магазина

Как это работает в InstantBase

Воронки строятся на основе метаданных, которые вы добавляете к событиям. Для каждого события, которое является шагом воронки, нужно указать:

• funnel_sales_step — номер шага в воронке (1, 2, 3...)
• funnel_sales_name — название шага (например, "Просмотр товара")

// Шаг 1: Просмотр товара
{
  "event": "product_view",
  "_metadata": {
    "funnel_sales_step": 1,
    "funnel_sales_name": "Просмотр товара"
  }
}

// Шаг 2: Добавление в корзину
{
  "event": "add_to_cart",
  "_metadata": {
    "funnel_sales_step": 2,
    "funnel_sales_name": "Корзина"
  }
}

// Шаг 3: Оформление заказа
{
  "event": "checkout_start",
  "_metadata": {
    "funnel_sales_step": 3,
    "funnel_sales_name": "Оформление"
  }
}

// Шаг 4: Покупка
{
  "event": "purchase",
  "_metadata": {
    "funnel_sales_step": 4,
    "funnel_sales_name": "Покупка",
    "is_order": true
  }
}

Создание воронки

Способ 1: Через метаданные (автоматически)

При отправке событий с метаданными funnel_sales_step система автоматически создает системную воронку для каждого приложения. Шаги будут отсортированы по номеру.

Способ 2: Через интерфейс

1. Перейдите в раздел "Заказы" → "Воронка продаж"
2. Нажмите кнопку "Настроить воронку"
3. В модальном окне вы увидите список всех событий
4. Отметьте события, которые должны быть шагами воронки
5. Порядок шагов определяется порядком выбора (первое выбранное — шаг 1)
6. Нажмите "Сохранить"

API для работы с воронками

Получение данных воронки

GET /api/funnels/get-data?from=...&to=... — данные для построения воронки за указанный период.

Параметры запроса

Пример ответа

{
  "success": true,
  "funnel_id": 1,
  "funnel_name": "Воронка продаж",
  "data": [
    {
      "step": 1,
      "name": "product_view",
      "display_name": "Просмотр товара",
      "count": 1542,
      "percentage": 100,
      "drop_percentage": 0
    },
    {
      "step": 2,
      "name": "add_to_cart",
      "display_name": "Корзина",
      "count": 362,
      "percentage": 23.5,
      "drop_percentage": 76.5
    },
    {
      "step": 3,
      "name": "checkout_start",
      "display_name": "Оформление",
      "count": 236,
      "percentage": 15.3,
      "drop_percentage": 34.8
    },
    {
      "step": 4,
      "name": "purchase",
      "display_name": "Покупка",
      "count": 186,
      "percentage": 12.1,
      "drop_percentage": 21.2
    }
  ],
  "total_users": 1542
}

Обновление шагов воронки

POST /api/funnels/update-steps — обновление шагов системной воронки.

Тело запроса

{
  "steps": ["product_view", "add_to_cart", "checkout_start", "purchase"]
}

Получение списка доступных событий

GET /api/events/list — список всех событий для выбора шагов воронки.

Метрики воронки

Примеры воронок для разных бизнесов

🛍️ Интернет-магазин

{
  "event": "product_view",
  "_metadata": {
    "funnel_sales_step": 1,
    "funnel_sales_name": "Просмотр товара"
  }
}

{
  "event": "add_to_cart",
  "_metadata": {
    "funnel_sales_step": 2,
    "funnel_sales_name": "Корзина"
  }
}

{
  "event": "checkout_start",
  "_metadata": {
    "funnel_sales_step": 3,
    "funnel_sales_name": "Оформление"
  }
}

{
  "event": "purchase",
  "_metadata": {
    "funnel_sales_step": 4,
    "funnel_sales_name": "Покупка",
    "is_order": true
  }
}

☁️ SaaS-сервис

{
  "event": "signup",
  "_metadata": {
    "funnel_sales_step": 1,
    "funnel_sales_name": "Регистрация",
    "is_activation": true
  }
}

{
  "event": "email_confirmed",
  "_metadata": {
    "funnel_sales_step": 2,
    "funnel_sales_name": "Подтверждение email"
  }
}

{
  "event": "project_created",
  "_metadata": {
    "funnel_sales_step": 3,
    "funnel_sales_name": "Создание проекта"
  }
}

{
  "event": "subscription_upgraded",
  "properties": {
    "amount": 9900
  },
  "_metadata": {
    "funnel_sales_step": 4,
    "funnel_sales_name": "Апгрейд",
    "is_order": true
  }
}

{
  "event": "game_start",
  "_metadata": {
    "funnel_sales_step": 1,
    "funnel_sales_name": "Запуск игры"
  }
}

{
  "event": "tutorial_complete",
  "_metadata": {
    "funnel_sales_step": 2,
    "funnel_sales_name": "Туториал"
  }
}

{
  "event": "level_5_reached",
  "_metadata": {
    "funnel_sales_step": 3,
    "funnel_sales_name": "5 уровень"
  }
}

{
  "event": "first_purchase",
  "properties": {
    "amount": 299
  },
  "_metadata": {
    "funnel_sales_step": 4,
    "funnel_sales_name": "Первая покупка",
    "is_order": true
  }
}