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

is_order — Флаг заказа

Тип: boolean

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

Применение: События покупки в интернет-магазине, оплата подписки в SaaS, внутриигровые покупки, любые транзакции, приносящие доход.

{
  "event": "purchase",
  "_metadata": {
    "is_order": true
  }
}

is_activation — Флаг активации

Тип: boolean

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

Применение: Завершение регистрации, первая покупка, создание первого проекта, загрузка первых данных, прохождение туториала.

{
  "event": "signup_completed",
  "_metadata": {
    "is_activation": true
  }
}

Влияние на метрики: Используется для расчета процента активации новых клиентов (CR activation) и сегментации пользователей.

funnel_sales_step — Шаг воронки продаж

Тип: integer

Описание: Номер шага в воронке продаж. Позволяет построить воронку и увидеть конверсию между шагами.

Применение: Шаг 1: Просмотр товара, Шаг 2: Добавление в корзину, Шаг 3: Оформление заказа, Шаг 4: Покупка.

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

// Добавление в корзину
{
  "event": "add_to_cart",
  "_metadata": {
    "funnel_sales_step": 2,
    "funnel_sales_name": "Корзина"
  }
}

funnel_sales_name — Название шага воронки

Тип: string

Описание: Человеко-читаемое название шага воронки. Отображается в интерфейсе вместо технического имени события.

{
  "event": "add_to_cart",
  "_metadata": {
    "funnel_sales_step": 2,
    "funnel_sales_name": "Добавление в корзину"
  }
}

Рекомендация: Используйте короткие, понятные названия (2-3 слова), которые будут хорошо смотреться в воронке.

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

Тип: string

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

{
  "event": "purchase",
  "_metadata": {
    "event_display_name": "Покупка товара"
  }
}

Где используется: В таблице событий, на графиках и в легендах, в списке топ-событий, в настройках воронок.

event_color — Цвет события

Тип: color

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

{
  "event": "purchase",
  "_metadata": {
    "event_color": "#28a745"
  }
}

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

Рекомендация: Используйте разные цвета для разных типов событий, чтобы графики были нагляднее:

• 🔵 Синий — просмотры, навигация
• 🟢 Зеленый — позитивные действия (покупки, регистрации)
• 🟠 Оранжевый — важные события
• 🔴 Красный — ошибки, отмены

event_description — Описание события

Тип: string

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

{
  "event": "purchase",
  "_metadata": {
    "event_description": "Отправляется после успешной оплаты заказа. Содержит информацию о товарах и сумме."
  }
}

order_revenue_field — Поле с суммой заказа

Тип: string

Описание: Указывает, в каком поле properties содержится сумма заказа. По умолчанию система ищет поле revenue.

{
  "event": "purchase",
  "properties": {
    "total_amount": 1499.99
  },
  "_metadata": {
    "is_order": true,
    "order_revenue_field": "total_amount"
  }
}

Полезно, если: В вашей системе сумма хранится под другим именем (например, total, amount, price).

order_id_field — Поле с ID заказа

Тип: string

Описание: Указывает, в каком поле properties содержится уникальный идентификатор заказа. По умолчанию — order_id.

{
  "event": "purchase",
  "properties": {
    "order_number": "ORD-2025-001"
  },
  "_metadata": {
    "is_order": true,
    "order_id_field": "order_number"
  }
}

order_items_field — Поле с товарами

Тип: string

Описание: Указывает, в каком поле properties содержится массив товаров. По умолчанию — items.

{
  "event": "purchase",
  "properties": {
    "products": [...]
  },
  "_metadata": {
    "is_order": true,
    "order_items_field": "products"
  }
}

Результат: После указания этого поля товары попадут в таблицу order_items и будут доступны в блоке "Популярные товары".

order_status_field — Поле со статусом заказа

Тип: string

Описание: Указывает, в каком поле properties содержится статус заказа. По умолчанию — status.

{
  "event": "purchase",
  "properties": {
    "payment_status": "completed"
  },
  "_metadata": {
    "is_order": true,
    "order_status_field": "payment_status"
  }
}

Возможные статусы: Система автоматически распознает статусы completed, pending, cancelled, refunded и отображает их соответствующим цветом.

Нужна помощь с настройкой метаданных?

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