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

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

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

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

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

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

№ 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"
      }
    }
  }
}

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

attribute_display_name — Отображаемое имя

Тип: string

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

"subscription_plan": {
  "attribute_display_name": "Тариф"
}

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

attribute_category — Категория

Тип: string

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

"email": {
  "attribute_category": "Контакты"
}

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

attribute_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_format": "currency"
}

attribute_color — Цвет

Тип: color

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

"subscription_plan": {
  "attribute_color": "#28a745"
}

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

attribute_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

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

  • Используйте понятные названия — attribute_display_name должен быть понятен менеджерам и маркетологам
  • Группируйте логически — объединяйте связанные атрибуты в одну категорию
  • Выбирайте правильный формат — для денег используйте currency, для дат — date
  • Скрывайте служебные атрибуты — если атрибут нужен только для аналитики, но не для интерфейса, скройте его
  • Используйте цвета для важных атрибутов — например, выделите статус подписки или уровень риска
  • Документируйте метаданные — создайте внутреннюю вики с описанием всех атрибутов

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

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

support@instantbase.online Telegram