🔖 Метаданные атрибутов

Настройте отображение атрибутов клиентов в интерфейсе — задавайте имена, категории, форматы и видимость

🎯 Для чего это нужно?

Метаданные атрибутов позволяют сделать таблицу клиентов удобной и информативной. Вы можете группировать атрибуты по категориям, задавать понятные названия, указывать формат отображения (валюта, проценты, даты) и управлять видимостью.

Как это выглядит в интерфейсе

Вот как таблица клиентов выглядит с настроенными метаданными:

№ UID Первый вход Последний вход Email Тариф LTV Последний IP
1 user_123 15.01.2026 19.03.2026 ivan@example.com Премиум 15 000 ₽ 192.168.1.1
2 user_456 01.02.2026 18.03.2026 petr@example.com Базовый 3 500 ₽ 10.0.0.1

Без метаданных вы бы видели технические названия: subscription_plan, lifetime_value и сырые значения.

Синтаксис

Метаданные атрибутов передаются в специальном объекте _metadata внутри поля attributes:

json 
{
  "event": "user_updated",
  "user_id": "user_123",
  "attributes": {
    "email": "user@example.com",
    "subscription_plan": "premium",
    "lifetime_value": 15000,
    "last_login": "2026-03-19",
    "is_active": true,
    
    "_metadata": {
      "email": {
        "attribute_display_name": "Email",
        "attribute_category": "Контакты"
      },
      "subscription_plan": {
        "attribute_display_name": "Тариф",
        "attribute_category": "Подписка",
        "attribute_format": "string",
        "attribute_color": "#28a745"
      },
      "lifetime_value": {
        "attribute_display_name": "LTV",
        "attribute_category": "Финансы",
        "attribute_format": "currency"
      },
      "last_login": {
        "attribute_display_name": "Последний вход",
        "attribute_category": "Активность",
        "attribute_format": "date"
      },
      "is_active": {
        "attribute_display_name": "Активен",
        "attribute_category": "Статус",
        "attribute_format": "boolean"
      }
    }
  }
}

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

display_name Отображаемое имя string

Описание: Человеко-читаемое название атрибута, которое будет отображаться в заголовках таблиц и интерфейсе.

Пример: 
"subscription_plan": {
  "attribute_display_name": "Тариф"
}

Без метаданных: subscription_plan
С метаданными: Тариф

category Категория string

Описание: Группирует атрибуты по категориям в интерфейсе. Например, в настройке колонок атрибуты будут сгруппированы по категориям.

Пример: 
"email": {
  "attribute_category": "Контакты"
},
"phone": {
  "attribute_category": "Контакты"
},
"subscription_plan": {
  "attribute_category": "Подписка"
}

Рекомендация: Используйте категории для логической группировки: "Контакты", "Финансы", "Подписка", "Активность", "Персональные данные".

format Формат отображения string

Описание: Определяет, как значение атрибута будет отформатировано в интерфейсе.

Доступные форматы:

Формат Описание Пример
currency Денежное значение 15 000 ₽
percent Проценты 23.5%
number Число с разделителями 1 234 567
date Дата в формате ДД.ММ.ГГГГ 19.03.2026
datetime Дата и время 19.03.2026 15:30
boolean Отображает "Да"/"Нет" Да
string Без форматирования premium
Примеры: 
"lifetime_value": {
  "attribute_display_name": "LTV",
  "attribute_format": "currency"
},
"conversion_rate": {
  "attribute_display_name": "Конверсия",
  "attribute_format": "percent"
},
"last_active": {
  "attribute_display_name": "Последняя активность",
  "attribute_format": "datetime"
},
"is_active": {
  "attribute_display_name": "Активен",
  "attribute_format": "boolean"
}
color Цвет color

Описание: Цвет, которым будет выделяться атрибут в интерфейсе (например, в виджетах и графиках).

Пример: 
"subscription_plan": {
  "attribute_display_name": "Тариф",
  "attribute_color": "#28a745"
}

Формат: HEX-код цвета (например, #2A6DF4, #FF5733, #28a745)

visible_in_customers Видимость в таблице клиентов boolean

Описание: Определяет, будет ли атрибут доступен для отображения в таблице клиентов. По умолчанию все атрибуты видны.

Пример (скрыть атрибут): 
"internal_notes": {
  "attribute_display_name": "Внутренние заметки",
  "attribute_visible_in_customers": false
}
📌 Важно: Даже если атрибут скрыт, он продолжает храниться в профиле пользователя и может использоваться в аналитике. Просто он не показывается в интерфейсе.

Таблица всех метаданных атрибутов

Акроним Тип Описание По умолчанию
attribute_display_name string Отображаемое имя —
attribute_category string Категория для группировки "Другие"
attribute_format string Формат отображения "string"
attribute_color color Цвет в интерфейсе —
attribute_visible_in_customers boolean Видимость в таблице true

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

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

{
  "event": "customer_data",
  "user_id": "user_123",
  "attributes": {
    "email": "customer@shop.ru",
    "phone": "+79001234567",
    "total_spent": 150000,
    "orders_count": 23,
    "last_order_date": "2026-03-15",
    "preferred_category": "electronics",
    "is_vip": true,
    
    "_metadata": {
      "email": {
        "attribute_display_name": "Email",
        "attribute_category": "Контакты"
      },
      "phone": {
        "attribute_display_name": "Телефон",
        "attribute_category": "Контакты"
      },
      "total_spent": {
        "attribute_display_name": "Всего потрачено",
        "attribute_category": "Финансы",
        "attribute_format": "currency"
      },
      "orders_count": {
        "attribute_display_name": "Количество заказов",
        "attribute_category": "Активность",
        "attribute_format": "number"
      },
      "last_order_date": {
        "attribute_display_name": "Последний заказ",
        "attribute_category": "Активность",
        "attribute_format": "date"
      },
      "preferred_category": {
        "attribute_display_name": "Любимая категория",
        "attribute_category": "Предпочтения"
      },
      "is_vip": {
        "attribute_display_name": "VIP клиент",
        "attribute_category": "Статус",
        "attribute_format": "boolean",
        "attribute_color": "#fd7e14"
      }
    }
  }
}

☁️ SaaS-сервис

{
  "event": "company_data",
  "user_id": "company_456",
  "attributes": {
    "company_name": "ООО Ромашка",
    "plan": "enterprise",
    "users_count": 45,
    "monthly_revenue": 450000,
    "trial_ends": "2026-04-01",
    "account_manager": "Иван Петров",
    "churn_risk": 0.15,
    
    "_metadata": {
      "company_name": {
        "attribute_display_name": "Компания",
        "attribute_category": "Основное"
      },
      "plan": {
        "attribute_display_name": "Тариф",
        "attribute_category": "Подписка",
        "attribute_color": "#2A6DF4"
      },
      "users_count": {
        "attribute_display_name": "Сотрудников",
        "attribute_category": "Статистика",
        "attribute_format": "number"
      },
      "monthly_revenue": {
        "attribute_display_name": "Ежемесячная выручка",
        "attribute_category": "Финансы",
        "attribute_format": "currency"
      },
      "trial_ends": {
        "attribute_display_name": "Триал до",
        "attribute_category": "Подписка",
        "attribute_format": "date"
      },
      "account_manager": {
        "attribute_display_name": "Менеджер",
        "attribute_category": "Поддержка"
      },
      "churn_risk": {
        "attribute_display_name": "Риск оттока",
        "attribute_category": "Аналитика",
        "attribute_format": "percent",
        "attribute_color": "#dc3545"
      }
    }
  }
}

🎮 Игры

{
  "event": "player_data",
  "user_id": "player_789",
  "attributes": {
    "nickname": "DragonSlayer",
    "level": 42,
    "guild": "Knights of Round",
    "premium_currency": 1500,
    "free_currency": 5000,
    "last_login": "2026-03-19T15:30:00Z",
    "achievements_count": 156,
    "is_online": true,
    
    "_metadata": {
      "nickname": {
        "attribute_display_name": "Никнейм",
        "attribute_category": "Основное"
      },
      "level": {
        "attribute_display_name": "Уровень",
        "attribute_category": "Прогресс",
        "attribute_format": "number",
        "attribute_color": "#fd7e14"
      },
      "guild": {
        "attribute_display_name": "Гильдия",
        "attribute_category": "Социальное"
      },
      "premium_currency": {
        "attribute_display_name": "Кристаллы",
        "attribute_category": "Ресурсы",
        "attribute_format": "number",
        "attribute_color": "#2A6DF4"
      },
      "free_currency": {
        "attribute_display_name": "Монеты",
        "attribute_category": "Ресурсы",
        "attribute_format": "number",
        "attribute_color": "#28a745"
      },
      "last_login": {
        "attribute_display_name": "Последний вход",
        "attribute_category": "Активность",
        "attribute_format": "datetime"
      },
      "achievements_count": {
        "attribute_display_name": "Достижений",
        "attribute_category": "Прогресс",
        "attribute_format": "number"
      },
      "is_online": {
        "attribute_display_name": "В сети",
        "attribute_category": "Статус",
        "attribute_format": "boolean",
        "attribute_color": "#28a745"
      }
    }
  }
}

Управление видимостью в интерфейсе

Пользователи могут дополнительно настраивать видимость атрибутов через интерфейс:

  1. В разделе "Клиенты" нажмите кнопку "Настроить колонки"
  2. Вы увидите все доступные атрибуты, сгруппированные по категориям
  3. Отметьте галочками те атрибуты, которые хотите видеть в таблице
  4. Можно менять порядок колонок перетаскиванием
  5. Настройки сохраняются в localStorage вашего браузера
💡 Совет: Используйте категории, чтобы сделать интерфейс настройки колонок удобным. Например, создайте категории "Контакты", "Финансы", "Подписка".

История изменений атрибутов

InstantBase автоматически сохраняет историю изменений всех атрибутов. Чтобы увидеть историю:

  1. В таблице клиентов найдите нужного пользователя
  2. Кликните на значение атрибута (оно должно быть подсвечено как ссылка)
  3. Откроется модальное окно с историей изменений

В истории отображается:

Рекомендации

Что дальше?

🏷️ Метаданные событий

Настройка метаданных для событий

Перейти →

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

Построение воронок продаж с помощью метаданных

Перейти →

Нужна помощь с настройкой атрибутов?

Напишите нам, и мы поможем настроить метаданные под ваш бизнес

support@instantbase.online Telegram