Пользовательские метрики
Пользовательские метрики позволяют создать собственный словарь метрик для конкретного аккаунта рекламной сети или трекера (Клики, Расход и т.д.).
Они решают следующие задачи:
- Использовать поле статистики, которого нет в CPA Pony. Сеть отдаёт поле
(например,viral_shares), а в системном справочнике его нет - создайте
метрику с маппингом на это поле и стройте по ней условия триггеров и
сценариев, не дожидаясь обновления справочника. - Считать производные показатели. Формулы над существующими метриками:
EPC, Профит, свой ROI с учётом комиссии - любой показатель, который вы
обычно считаете в Excel.
Для создания пользовательской метрики:
- Кликните в меню на [Сети] или [Трекеры], в зависимости от того, где вы хотите создать новую метрику.
- Напротив нужного аккаунта рекламной сети или трекера нажмите на иконку пользовательских метрик.

- В открывшемся окне нажмите на кнопку [Добавить метрику]
Откроется окно:

Краткое описание пунктов окна:
- Тип метрики:
- Маппинг - привязывает идентификатор метрики к сырому полю статистики провайдера
- Формула - арифметическое выражение над другими метриками.
- Название - произвольное название метрики, его вы будете видеть в триггерах и сценариях, при выборе метрики
- Агрегация - как определяется значение по диапазону. Возьмем для примера отображение статистики за месяц:
- Сумма - значения складываются
- Среднее - берется среднее значение
- Минимум - берется минимальное значение
- Максимум - берется максимальное значение
- Последнее значение - берется последнее значение
- Активна - селектор включает или выключаем метрику.
- Указать идентификатор - поле для переопределения уникального идентификатора, позволяет переопределить стандартные метрики. Требуется в крайне редких случаях.
WARNING
Перед использованием опции Указать идентификатор рекомендуем задать вопрос в чате поддержки или по почте support@cpapony.ru
Следующий набор пунктов будет меняться в зависимости от выбранного типа метрики:
Тип Маппинг:
- Сырое поле статистики - имя поля в ответе API провайдера. Можно перечислить варианты через запятую (
conversions,goals,leads), система выберет то, что реально есть в ответе.
Тип Формула:
- Формула - нужно указать формулу по которой будет вычисляться значение метрики. Можно использовать идентификаторы стандартных метрик, пользовательских метрик, числа, математические операторы, функции. Доступные значения (кроме цифр) указаны под полем.

Маппинг
Данный тип поля позволяет добавить метрику, которая будет работать непосредственно со статистикой.
CPA Pony забирает статистику по API, и в поле "Сырое поле статистики" нужно указать значение, которое вы хотите использовать в триггерах.
Все основные метрики уже добавлены в систему, но на случай если, например, по вашему аккаунту отдается не стандартная схема API, то можно систему под нее подстроить.
Так же это поле полезно в ситуациях, если рекламная сеть или трекер поменяли название поля в своем API и что бы не ждать обновления CPA Pony, можно быстро добавить метрику.
Формулы
Данный тип поля является вычисляемым и формируется динамически при заборе статистики.
Примеры
# EPC - доход на клик
revenue / clicks
# Маржа в процентах
(revenue - cost) / revenue * 100
# Стоимость конверсии с округлением до центов
round(cost / conversions, 2)
# Худший из двух показателей
min(cr, my_backend_cr)Доступные операторы и функции
Операторы:
| Оператор | Значение |
|---|---|
+ - | Сложение, вычитание |
* / | Умножение, деление |
-x | Унарный минус |
( ) | Группировка |
WARNING
Оператор % не поддерживается - ни как остаток от деления, ни как знак
процента. Для процентов умножайте на 100: clicks / impressions * 100.
Ограничения формул: до 500 символов, именованные аргументы функций не
поддерживаются, глубина цепочек "формула из формулы" - до 5.
Функции:
| Функция | Аргументы | Описание |
|---|---|---|
abs(x) | 1 | Модуль числа |
round(x) / round(x, n) | 1–2 | Округление до n знаков |
floor(x) | 1 | Округление вниз |
ceil(x) | 1 | Округление вверх |
min(a, b, …) | 2–8 | Минимум |
max(a, b, …) | 2–8 | Максимум |

