Перейти к основному содержимому

Analytics API

API для получения аналитических данных и метрик маркетплейса.

Обзор​

Analytics API предоставляет подробную статистику по продажам, пользователям, товарам и другим ключевым метрикам.

Основные метрики​

Продажи​

  • Общий оборот
  • Количество заказов
  • Средний чек
  • Конверсия

Товары​

  • Самые популярные товары
  • Остатки на складе
  • Рейтинги и отзывы

Пользователи​

  • Новые регистрации
  • Активные пользователи
  • Поведенческие метрики

Получение метрик​

Обзорная статистика​

// GET /api/analytics/overview?period=30d
{
  "revenue": {
    "total": 1500000,
    "change": "+15.5%",
    "period": "30d"
  },
  "orders": {
    "total": 450,
    "change": "+8.2%"
  },
  "customers": {
    "total": 1250,
    "new": 85,
    "change": "+12.1%"
  },
  "conversion_rate": {
    "value": 3.2,
    "change": "+0.5%"
  }
}

Продажи по периодам​

// GET /api/analytics/sales?period=7d&group_by=day
{
  "data": [
    {
      "date": "2024-01-01",
      "revenue": 50000,
      "orders": 15,
      "average_order": 3333
    },
    // ... остальные дни
  ],
  "summary": {
    "total_revenue": 350000,
    "total_orders": 105,
    "growth_rate": 8.5
  }
}

Популярные товары​

// GET /api/analytics/products/top?limit=10
{
  "products": [
    {
      "id": "uuid",
      "name": "iPhone 15",
      "sales_count": 45,
      "revenue": 4049550,
      "rank": 1,
      "change": "+5"
    }
  ]
}

Фильтры и группировка​

Временные периоды​

  • today - Сегодня
  • yesterday - Вчера
  • 7d - 7 дней
  • 30d - 30 дней
  • 90d - 90 дней
  • 1y - 1 год
  • custom - Произвольный период

Группировка данных​

  • hour - По часам
  • day - По дням
  • week - По неделям
  • month - По месяцам
  • quarter - По кварталам

Сегментация​

// GET /api/analytics/customers/segments
{
  "segments": [
    {
      "name": "VIP клиенты",
      "criteria": "lifetime_value > 100000",
      "count": 25,
      "revenue_share": 35.5
    },
    {
      "name": "Новые клиенты",
      "criteria": "days_since_registration <= 30",
      "count": 150,
      "revenue_share": 15.2
    }
  ]
}

Воронка продаж​

// GET /api/analytics/funnel
{
  "stages": [
    {
      "name": "Посетители",
      "count": 10000,
      "conversion": 100
    },
    {
      "name": "Просмотр товара",
      "count": 2500,
      "conversion": 25
    },
    {
      "name": "Добавление в корзину",
      "count": 800,
      "conversion": 8
    },
    {
      "name": "Оформление заказа",
      "count": 320,
      "conversion": 3.2
    }
  ]
}

Когортный анализ​

// GET /api/analytics/cohorts?type=retention
{
  "cohorts": [
    {
      "period": "2024-01",
      "users": 100,
      "retention": [100, 45, 32, 28, 25, 23]
    }
  ]
}

Экспорт данных​

// POST /api/analytics/export
{
  "type": "sales",
  "period": "30d",
  "format": "csv" | "xlsx" | "json",
  "email": "admin@example.com"
}

Дашборды​

// GET /api/analytics/dashboards
{
  "dashboards": [
    {
      "id": "uuid",
      "name": "Продажи",
      "widgets": [
        {
          "type": "metric",
          "title": "Выручка",
          "query": "/api/analytics/revenue"
        }
      ]
    }
  ]
}