Вычисляемые метрики

Вычисляемые метрики (calculated metrics) позволяют создавать собственные показатели на основе существующих метрик с помощью математических формул.

Синтаксис формулы

Формула записывается строкой с использованием:

• Названий существующих метрик в квадратных скобках: [clicks], [cost]
• Арифметических операторов: +, -, *, /
• Скобок для группировки: (, )
• Функций: ROUND(), ABS(), IF()

Примеры формул

CPC:        [cost] / [clicks]
CPL:        [cost] / [leads]
ROAS:       [revenue] / [cost] * 100
Прибыль:    [revenue] - [cost]
Маржа:      ([revenue] - [cost]) / [revenue] * 100

Конфигурация

Вычисляемая метрика задаётся объектом в массиве calculated_metrics:

{
  "calculated_metrics": [
    {
      "name": "CPL",
      "formula": "[cost] / [leads]",
      "type": "money",
      "description": "Цена за лид",
      "format": "decimal_2"
    }
  ]
}

Поле	Тип	Обязательное	Описание
name	строка	Да	Уникальное название метрики
formula	строка	Да	Математическая формула
type	строка	Нет	Тип результата: float, money, percentage, integer
description	строка	Нет	Описание метрики для интерфейса
format	строка	Нет	Формат: decimal_0, decimal_1, decimal_2, percent_1, percent_2

Доступные функции

Функция	Описание	Пример
ROUND(value, decimals)	Округление	ROUND([cpc], 2)
ABS(value)	Абсолютное значение	ABS([profit])
IF(condition, true_val, false_val)	Условное выражение	IF([clicks]>0, [cost]/[clicks], 0)

Условная логика

Функция IF поддерживает операторы сравнения: >, <, >=, <=, ==, !=:

{
  "name": "CPC с защитой от деления на ноль",
  "formula": "IF([clicks] > 0, [cost] / [clicks], 0)"
}

Порядок вычисления

1. Сначала извлекаются все стандартные метрики
2. Затем применяются фильтры и группировки
3. Вычисляемые метрики рассчитываются последними на основе уже сгруппированных данных
4. Поэтому вычисляемая метрика не может ссылаться на другую вычисляемую метрику

Ограничения

• Максимум 10 вычисляемых метрик на отчёт
• Формула не может содержать более 50 символов
• В формуле можно ссылаться только на метрики, уже добавленные в отчёт
• Вложенные вычисляемые метрики не поддерживаются

Связанные страницы

• Метрики
• Измерения
• Параметры