Пользовательские метрики

Пользовательская метрика — колонка отчёта, которую трекер считает по вашей формуле из встроенных метрик, например profit / clicks. Метрики создаются на вкладке Настройки → Метрики, они общие для всей команды и появляются в списке колонок конструктора отчётов. Раздел Настройки видят владелец и администратор.

Создание метрики

1. Откройте Настройки → Метрики.
2. Нажмите + Метрика. Откроется окно «Кастомная метрика».
3. Заполните поля — см. Поля окна.
4. Нажмите Сохранить.

Метрика появится в таблице с колонками Название, Ключ, Формула, Формат. Формат в таблице записан как number, currency или percent. Пока метрик нет, в таблице написано «Нет кастомных метрик».

Поля окна

Требования к ключу:

• первый символ — буква, длина до 64 символов, иначе отчёт с этой колонкой не сохранится;
• буквы строчные: ключ с заглавными нельзя указать в запрещённых полях отчётов;
• у каждой метрики свой ключ: отчёт находит метрику по ключу.

Формат и Знаков после запятой меняют только вид значения в отчёте:

• Число — число без знаков: 0.35.
• Валюта — со знаком доллара: $0.35, отрицательное значение — -$0.35.
• Процент — со знаком процента: 35.00%. Значение на 100 не умножается: умножение пишите в формуле.

Формула

В формуле допустимы:

• ключи встроенных метрик из таблицы ниже;
• числа с точкой в качестве разделителя: 100, 0.7;
• действия +, -, *, / и скобки ( );
• минус перед числом, ключом или скобкой: -cost.

Умножение и деление выполняются раньше сложения и вычитания, действия одного порядка — слева направо. Пробелы не обязательны. Ключи пишутся строчными буквами, как в таблице: Clicks трекер не распознает. Функций и сравнений нет.

Как считается каждая встроенная метрика — на странице Метрики отчётов и формулы.

Примеры:

profit / clicks
revenue / conversions * 0.7
sales / clicks * 100
(revenue_expected - cost) / leads

Как считается значение

• Формула вычисляется отдельно для каждой строки отчёта.
• Деление на ноль даёт 0. Строка без кликов в формуле profit / clicks покажет 0.
• В строке «Итого» формула применяется к итоговым значениям метрик. Для profit / clicks это вся прибыль отчёта, делённая на все клики, а не сумма значений по строкам.

Метрика в отчёте

1. Откройте раздел Отчёты.
2. Нажмите Колонки.
3. В блоке Доступные нажмите кнопку + с названием метрики. Колонка добавится в конец списка.
4. Поставьте колонку на нужное место кнопками ↑ и ↓ или перетаскиванием.

Нажмите заголовок колонки, чтобы отсортировать отчёт по метрике. Колонка входит в сохранённые отчёты. В выгрузке CSV заголовок колонки — ключ метрики, значения — числа без округления и без знаков $ и %, см. Что внутри CSV.

Если сотруднику запрещено поле отчётов, метрик с этим полем в формуле в его списке Колонки нет. Например, при запрещённом cost пропадают метрики, в формуле которых есть cost, profit или roi.

Изменение и удаление

• Чтобы изменить метрику, нажмите на её название в таблице. Откроется то же окно с заполненными полями.
• Чтобы удалить, нажмите ✕ в строке и подтвердите запрос «Удалить метрику «…»?».

После удаления метрики или смены ключа отчёты с этой колонкой, включая сохранённые, не строятся и показывают ошибку unknown metric "net_epc". Чтобы отчёт построился:

1. Нажмите Колонки в отчёте.
2. Уберите колонку со старым ключом кнопкой ×.
3. Выберите другое поле в списке Сортировка, если отчёт был отсортирован по этой метрике.

Те же действия с метриками доступны через API — см. Admin API: отчёты.

Ограничения

• В формуле нельзя ссылаться на другую пользовательскую метрику и на колонки типов конверсий — только на ключи из таблицы выше.
• В фильтрах отчёта пользовательских метрик нет: фильтровать можно только по встроенным.
• Пользовательские метрики есть только в конструкторе отчётов. В статистике кампании, в списке кампаний и на дашборде их нет.
• У финансиста в списке Колонки только встроенные показатели.

Сообщения об ошибках

Ключ и формула проверяются при сохранении. При ошибке метрика не сохраняется, окно остаётся открытым. Сообщение выводится на вкладке Метрики над таблицей, под окном. Чтобы прочитать его, закройте окно кнопкой Отмена. Несохранённые значения полей при закрытии теряются — сначала скопируйте формулу.

name и formula обязательны

Пустое поле Ключ (латиница) или Формула. Заполните оба.

имя совпадает с базовой метрикой

Ключ совпадает с ключом встроенной метрики, например epc, или начинается с cv_. Задайте другой ключ, например net_epc.

имя — только латиница, цифры и _

В ключе есть пробел, дефис, кириллица или другой знак. Оставьте латинские буквы, цифры и _.

ошибка в формуле: неизвестная метрика "…"

В формуле есть слово, которого нет среди ключей встроенных метрик: опечатка, заглавные буквы или ключ другой пользовательской метрики. Сверьте с таблицей ключей.

ошибка в формуле: недопустимый символ "…"

В формуле есть знак вне списка допустимых: запятая вместо точки в числе, %, ^, кавычки, кириллица. Уберите его.

ошибка в формуле: ожидалась )

Не закрыта скобка. Сообщения «неожиданный конец формулы» и «лишний токен "…"» тоже говорят о синтаксисе: формула обрывается на знаке действия, либо пропущен знак между двумя значениями или стоит лишняя закрывающая скобка.

ошибка в формуле: формула длиннее 512 символов

Сократите формулу. Сообщение «пустая формула» означает, что в поле только пробелы.