📌 Метаданные: Обзор
Добавьте бизнес-логику в ваши данные — отмечайте заказы, стройте воронки, настраивайте отображение
💡 Что такое метаданные?
Метаданные — это дополнительная информация о ваших событиях и атрибутах, которая позволяет InstantBase понимать бизнес-логику вашего продукта. С их помощью вы можете отметить событие как заказ, задать шаг воронки продаж, указать цвет для графика или настроить отображение атрибута в интерфейсе.
Зачем нужны метаданные?
Сырые данные
События без метаданных
Метаданные
Добавляем бизнес-логику
Готовая аналитика
Выручка, воронки, когорты
Без метаданных InstantBase видит только поток событий. С метаданными мы понимаем:
- Какие события являются заказами и приносят выручку
- Какие действия пользователя ведут к покупке (воронка)
- Какие пользователи "активировались" и начали использовать продукт
- Как красиво отображать события и атрибуты в интерфейсе
Где используются метаданные
Базовый синтаксис
Метаданные передаются в отдельном поле _metadata при отправке события:
json
{
"event": "page_view",
"user_id": "user_123",
"properties": {
"page": "/home"
},
"_metadata": {
"is_activation": true,
"funnel_sales_step": 1,
"funnel_sales_name": "Главная страница",
"event_display_name": "Просмотр главной",
"event_color": "#2A6DF4"
}
}Типы данных в метаданных
| Тип данных | Описание | Пример |
|---|---|---|
string |
Текстовое значение | "Просмотр товара" |
integer |
Целое число | 1, 2, 3 |
float |
Число с плавающей точкой | 3.14 |
boolean |
Логическое значение | true, false |
color |
Цвет в HEX-формате | "#FF5733" |
Стандартные метаданные
| Акроним | Тип | Описание | Применение |
|---|---|---|---|
is_order |
boolean | Помечает событие как заказ | Выручка, заказы, средний чек |
is_activation |
boolean | Помечает событие как активацию пользователя | Метрика активации, воронки |
funnel_sales_step |
integer | Номер шага в воронке продаж | Воронки продаж |
funnel_sales_name |
string | Название шага в воронке | Отображение в воронке |
event_display_name |
string | Отображаемое имя события | Интерфейс, графики |
event_color |
color | Цвет события на графиках | Визуализация |
event_description |
string | Описание события | Документация, подсказки |
attribute_display_name |
string | Отображаемое имя атрибута | Таблица клиентов |
attribute_category |
string | Категория атрибута | Группировка в интерфейсе |
attribute_color |
color | Цвет атрибута | Виджеты |
attribute_format |
string | Формат отображения | currency, percent, date |
attribute_visible_in_customers |
boolean | Показывать ли атрибут в таблице клиентов | Настройка интерфейса |
Примеры использования
Интернет-магазин
// Просмотр товара
{
"event": "product_view",
"_metadata": {
"funnel_sales_step": 1,
"funnel_sales_name": "Просмотр товара",
"event_display_name": "Просмотр товара",
"event_color": "#2A6DF4"
}
}
// Добавление в корзину
{
"event": "add_to_cart",
"_metadata": {
"funnel_sales_step": 2,
"funnel_sales_name": "Корзина",
"event_display_name": "Добавление в корзину",
"event_color": "#28a745"
}
}
// Покупка
{
"event": "purchase",
"_metadata": {
"funnel_sales_step": 3,
"funnel_sales_name": "Покупка",
"event_display_name": "Покупка",
"event_color": "#fd7e14",
"is_order": true
}
}SaaS-сервис
// Регистрация (активация)
{
"event": "signup",
"_metadata": {
"is_activation": true,
"event_display_name": "Регистрация",
"event_color": "#28a745"
}
}
// Создание проекта (ключевое действие)
{
"event": "project_created",
"_metadata": {
"funnel_sales_step": 1,
"funnel_sales_name": "Создание проекта",
"event_display_name": "Создание проекта",
"event_color": "#2A6DF4"
}
}
// Апгрейд подписки
{
"event": "subscription_upgraded",
"_metadata": {
"event_display_name": "Апгрейд тарифа",
"event_color": "#fd7e14"
}
}Настройка атрибутов клиента
{
"event": "user_updated",
"user_id": "user_123",
"attributes": {
"email": "user@example.com",
"subscription_plan": "premium",
"lifetime_value": 15000,
"last_login": "2026-03-19",
"_metadata": {
"email": {
"attribute_display_name": "Email",
"attribute_category": "Контакты"
},
"subscription_plan": {
"attribute_display_name": "Тариф",
"attribute_category": "Подписка",
"attribute_format": "string"
},
"lifetime_value": {
"attribute_display_name": "LTV",
"attribute_category": "Финансы",
"attribute_format": "currency"
},
"last_login": {
"attribute_display_name": "Последний вход",
"attribute_category": "Активность",
"attribute_format": "date"
}
}
}
}Преимущества использования метаданных
🎯 Точная аналитика
- Правильный расчет выручки
- Корректные воронки продаж
- Точные метрики активации
👁️ Удобный интерфейс
- Понятные названия событий
- Цветовая дифференциация
- Группировка атрибутов
🔄 Гибкость
- Адаптация под любой бизнес
- Изменение логики без кода
- Разные воронки для разных сценариев
📈 Глубокая аналитика
- Сегментация по атрибутам
- Когорты по активации
- Анализ воронок по шагам
Рекомендации
- Начинайте с малого — добавьте метаданные для ключевых событий (покупки, регистрации)
- Используйте понятные имена — названия шагов воронки должны быть понятны всей команде
- Документируйте метаданные — создайте внутреннюю вики с описанием всех используемых метаданных
- Проверяйте перед запуском — тестируйте метаданные на тестовых ключах
- Обновляйте метаданные при изменении логики — если добавили новый шаг в воронку, добавьте метаданные
Что дальше?
Нужна помощь с настройкой метаданных?
Напишите нам, и мы поможем настроить метаданные под ваш бизнес