❓ Часто задаваемые вопросы

InstantBase — это платформа данных (CDP-класс), которая позволяет компаниям собирать, анализировать и использовать данные о поведении пользователей. Ключевое преимущество — скорость интеграции с любым стеком технологий через единый REST API и мгновенное получение бизнес-ценности без необходимости нанимать data-инженеров.

В отличие от классических систем аналитики, InstantBase:

• Не требует SDK — работает через простой REST API, совместимый с любым стеком
• Дает полный контроль над данными — вы сами определяете структуру событий и атрибутов
• Строит единый профиль клиента — объединяет данные из всех источников
• Позволяет сегментировать аудиторию по любым атрибутам
• Ориентирован на малый и средний бизнес — простой и понятный интерфейс

Интеграция занимает от 1 часа. Вам нужно:

1. Зарегистрироваться и получить API-ключ (1 минута)
2. Добавить несколько строк кода в ваше приложение (30-60 минут)
3. Отправить тестовое событие и убедиться, что данные приходят (5 минут)

Через 1-2 часа после отправки первых событий вы уже будете видеть данные в дашбордах.

Да, мы предоставляем 14 дней бесплатного доступа с полным функционалом. После регистрации вы можете увеличить триал до 21 дня, подтвердив телефон и Telegram. Никакой привязки карты не требуется.

У нас есть подробная документация, включающая:

• Быстрый старт — начало работы за 5 минут
• API Reference — полное описание всех эндпоинтов
• Метаданные — как добавить бизнес-логику в события
• Примеры для разных типов бизнеса — интернет-магазин, SaaS, игры
• SDK для популярных языков — JavaScript, Python, PHP, мобильные

Самый простой способ — использовать curl:

curl -X POST https://api.instantbase.online/v1/track \
  -H "X-API-Key: ваш_тестовый_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "test_event",
    "user_id": "test_user_123",
    "properties": {
      "source": "curl",
      "test_property": "Hello World!"
    }
  }'

Подробнее в разделе Первое событие.

Нет, SDK не обязателен. InstantBase работает через простой REST API, поэтому вы можете отправлять события с помощью любого HTTP-клиента. SDK лишь упрощают интеграцию, предоставляя готовые методы для типовых задач.

Мы предлагаем SDK для:

• JavaScript — для браузеров и Node.js
• Python — синхронный и асинхронный
• PHP — с поддержкой популярных фреймворков
• iOS и Android — нативные SDK для мобильных приложений

Для связывания профилей отправляйте события с обоими полями:

{
  "event": "purchase",
  "user_id": "user_123",
  "anonymous_id": "abc-123-def",
  "properties": {
    "revenue": 1499.99
  }
}

Система автоматически объединит анонимные события с авторизованным пользователем. Также можно использовать метод alias в наших SDK.

anonymous_id — это идентификатор неавторизованного пользователя. Он позволяет отслеживать действия пользователя до того, как он войдет в аккаунт или зарегистрируется.

В качестве anonymous_id можно использовать:

• ID сессии (session_id)
• Cookie-идентификатор
• Device ID (для мобильных приложений)
• Любой уникальный временный идентификатор

InstantBase поддерживает любые языки, умеющие отправлять HTTP-запросы. У нас есть официальные SDK для:

• JavaScript — браузеры, Node.js, React, Vue, Angular
• Python — Django, Flask, FastAPI, асинхронные приложения
• PHP — Laravel, Symfony, WordPress, Yii2
• Swift — iOS приложения
• Kotlin/Java — Android приложения

Если вашего языка нет в списке, вы всегда можете использовать прямой REST API.

У нас три основных тарифа и индивидуальный Enterprise:

• Start — 990 ₽/мес (500 000 событий, хранение 30 дней)
• Base — 3 490 ₽/мес (2 500 000 событий, хранение 30 дней)
• Pro — 9 900 ₽/мес (10 000 000 событий, хранение 90 дней)
• Enterprise — индивидуально (безлимит событий, хранение до 5 лет)

При оплате за год предоставляется скидка 24-30%.

Событие — это любое действие пользователя, которое вы отправляете через API. Один вызов API = одно событие.

Примеры событий:

• Просмотр страницы (page_view)
• Покупка (purchase)
• Регистрация (signup)
• Клик по кнопке (button_click)
• Открытие приложения (app_open)

При достижении 80% и 90% лимита вы получите уведомление в интерфейсе и на email. При превышении 100%:

• События продолжат собираться, но мы предложим перейти на следующий тариф
• При превышении более чем на 10% прием новых событий временно приостанавливается
• Доступ к дашбордам и аналитике сохраняется

Вы всегда можете перейти на более дорогой тариф в разделе "Биллинг".

Да, вы можете сменить тариф в любой момент в разделе "Биллинг".

• При переходе на более дорогой тариф — разница спишется пропорционально оставшимся дням текущего периода
• При переходе на более дешевый тариф — остаток сохранится на счету и будет учтен при следующем списании

Мы принимаем:

• Банковские карты (Visa, Mastercard, МИР)
• Электронные кошельки
• Для юридических лиц — выставление счета с НДС

Тестовые ключи имеют префикс test_ и предназначены для разработки и отладки. Они:

• Не влияют на лимиты основного тарифа
• Имеют общий лимит 50 000 событий в месяц на компанию
• Позволяют экспериментировать без риска испортить статистику

Production ключи (prod_) учитываются в вашем тарифе и должны использоваться только в рабочем коде.

Срок хранения зависит от тарифа:

• Start и Base — 30 дней
• Pro — 90 дней
• Enterprise — до 5 лет (индивидуально)

Вы всегда можете экспортировать данные в CSV из интерфейса или через API.

Да, доступны несколько способов выгрузки:

• Экспорт в CSV — из таблиц "Клиенты", "Заказы", "События"
• API — все данные доступны через API (эндпоинты /api/customers, /api/events и др.)
• Вебхуки — получайте данные в реальном времени

LTV (Lifetime Value) рассчитывается автоматически на основе когортного анализа. Формула расчета:

LTV = (Средний чек × Частота покупок) / Churn Rate

Вы можете увидеть LTV в разделе "Удержание" или рассчитать его по формуле на основе экспортированных данных.

Для настройки воронки продаж нужно добавить метаданные к событиям:

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

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

Подробнее в разделе Настройка воронок.

География определяется по IP-адресу пользователя. Если страна не определена, это может быть связано с:

• Использованием VPN или прокси
• Локальными IP-адресами (127.0.0.1, 10.0.0.0/8 и т.д.)
• Ошибками в базе геоданных

Мы используем базу данных ipinfo.io и периодически обновляем ее.

InstantBase обеспечивает многоуровневую защиту данных:

• Изоляция данных — каждая компания получает отдельную базу данных
• Шифрование — все данные передаются по HTTPS, API-ключи хранятся в зашифрованном виде
• Аутентификация — поддержка 2FA, разные уровни доступа для пользователей
• Аудит — логирование всех действий в системе
• GDPR-ready — возможность удалить данные по запросу

Тестовые ключи предназначены для разработки и отладки. Они:

• Имеют отдельный лимит (50 000 событий в месяц)
• Не влияют на основную статистику и лимиты тарифа
• Позволяют экспериментировать без риска
• Имеют префикс test_ и выделяются в интерфейсе

Рекомендуется использовать тестовые ключи на этапе разработки, а production ключи — только в рабочем коде.

Для включения 2FA:

1. Зайдите в раздел "Профиль" → "Безопасность"
2. Нажмите "Настроить 2FA"
3. Отсканируйте QR-код в приложении Google Authenticator или аналогичном
4. Введите код из приложения для подтверждения
5. Сохраните резервные коды в надежном месте

Для удаления компании свяжитесь с поддержкой по email support@instantbase.online. Процедура удаления:

• Подтверждение владельца аккаунта
• Удаление всех данных компании в течение 30 дней
• Невозможность восстановления после удаления

В личном кабинете вы также можете временно деактивировать аккаунт.

Метаданные — это дополнительная информация о событиях и атрибутах, которая позволяет InstantBase понимать бизнес-логику вашего продукта. С их помощью вы можете:

• Помечать события как заказы (is_order: true)
• Задавать шаги воронки продаж (funnel_sales_step)
• Отмечать активации пользователей (is_activation: true)
• Настраивать отображение атрибутов в интерфейсе

Подробнее в разделе Метаданные.

Действуют следующие лимиты:

• Production ключи — 1000 запросов в минуту
• Test ключи — 200 запросов в минуту
• Пакетная отправка — до 100 событий в одном запросе

При превышении лимита API возвращает статус 429 (Too Many Requests) с заголовком Retry-After.

При временных ошибках (5xx) API автоматически повторит запрос. Наши SDK имеют встроенную логику повторных попыток (по умолчанию 3 раза). Если ошибка сохраняется, мы рекомендуем:

• Сохранить событие в локальную очередь
• Повторить отправку позже
• Проверить статус сервера на странице status.instantbase.online

Да, начиная с версии 1.5.0 поддерживается пакетная отправка до 100 событий в одном запросе. Это позволяет:

• Снизить нагрузку на сеть
• Уменьшить количество HTTP-запросов
• Оптимизировать производительность

Используйте метод track_batch() в наших SDK или отправляйте массив событий напрямую (скоро).

Передавайте версию приложения в каждом событии в поле app_version:

{
  "event": "app_open",
  "user_id": "user_123",
  "app_version": "2.1.0",
  "properties": {
    "platform": "ios"
  }
}

После этого вы сможете фильтровать данные по версиям в разделе "Активность".

Да, InstantBase отлично подходит для отслеживания серверных событий. Используйте наши SDK для Node.js, Python или PHP, либо отправляйте прямые HTTP-запросы. Серверные события ничем не отличаются от клиентских — вы также можете передавать любые свойства и метаданные.