Глоссарий¶

Термины трекинга и точные формулы всех метрик TrafMate. Формулы взяты из кода отчётов, а не из общих представлений: если цифра в панели расходится с ожиданием, сверяйтесь с этой страницей.

Термины трекинга¶

Клик¶

Один заход посетителя по ссылке трекера. Записывается всегда - и когда посетитель уходит на оффер, и когда его отсеял фильтр, и когда он опознан как бот.

Клик несёт около сорока полей: адрес, страна, регион, город, ISP, оператор, тип соединения, язык, операционная система и её версия, браузер и его версия, тип и модель устройства, реферер, поисковая система, ключевое слово, sub_id_1..30, extra_param_1..10, идентификатор кампании и креатива сети, сырая строка запроса.

Уникальный клик¶

Клик от посетителя, которого трекер в этой области ещё не видел за последние 24 часа.

Как считается «тот же посетитель», задаёт метод уникальности кампании:

Метод	Ключ посетителя
Только IP	хеш IP-адреса
IP + User-Agent	хеш IP и User-Agent (по умолчанию)
По параметру	хеш значения указанного параметра ссылки. Если параметр пуст, откат на IP + User-Agent

Областей уникальности три, и считаются они независимо:

уникальный в кампании - посетитель впервые в этой кампании;
уникальный в потоке - впервые в этом потоке;
уникальный в трекере (глобально) - впервые во всей установке.

В отчётах колонка «Уники» - это уникальные в кампании.

Бот¶

Клик, который трекер счёл автоматическим. Признаки, каждый включается отдельно в настройках:

пустой User-Agent;
подстрока из списка в User-Agent (bot, crawl, spider, facebookexternalhit, adsbot, bytespider, python-requests, curl, headlesschrome и другие);
ISP или организация из списка дата-центров по данным GeoIP (Amazon, Google, Microsoft Azure, DigitalOcean, OVH, Hetzner, Cloudflare, Vultr и другие) - проверка идёт по названию провайдера, а не по спискам IP-диапазонов;
заголовки предзагрузки браузера (Purpose: prefetch, Sec-Purpose: prerender и подобные) - выключено по умолчанию.

Отдельно есть признак прокси: ISP содержит vpn, proxy, hosting или datacenter.

Что делать с ботом, задаёт «Действие для ботов» в кампании. Значение pass (или пустое) означает «не вмешиваться» - дальше работают обычные фильтры потоков. Любое другое действие выполняется сразу, но клик всё равно попадает в статистику.

Клоакинг¶

Показ разного содержимого разным посетителям: модератору рекламной сети - белую страницу, целевой аудитории - рабочую. В TrafMate это не отдельная функция, а следствие устройства потоков: поток с фильтрами «бот» и «страна» отдаёт одно, поток по умолчанию - другое.

Кампания¶

Точка входа трафика. У кампании есть alias (короткое читаемое имя в ссылке) и token (длинный секретный идентификатор). Ссылка выглядит как https://<домен>/<alias> или https://<домен>/<token>; при совпадении выигрывает alias. Голый домен без сегмента пути ведёт на кампанию, привязанную к этому домену.

Токен - это ещё и ключ доступа к Click API, поэтому его не публикуют в креативах.

Поток¶

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

Типы потока:

forced (форсированный) - проверяется первым;
regular (обычный) - участвует в ротации по весам или по позиции;
default (по умолчанию) - срабатывает, если не подошёл никто.

Схемы потока: landings (показать лендинг и оффер), redirect (редирект), action (действие). Действия: redirect_http, show_html, show_text, status_404, to_campaign (переброс в другую кампанию), do_nothing.

Фильтр¶

Условие потока: страна, регион, город, устройство, ISP, IP, реферер, язык, прокси, бот, параметр, сабка, User-Agent, браузер, операционная система, версия, модель, X-Requested-With, ключевое слово, поисковая система, идентификатор кампании или креатива, сайт, тип соединения, оператор, расписание, дата и время, лимит кликов, уникальность, а также внешние сервисы Palladium и Adspect.

У каждого фильтра два режима: accept (пропустить только совпавших) и reject (отсеять совпавших).

Оффер¶

Целевое предложение партнёрки. Хранит адрес перехода (Offer URL), выплату, валюту, партнёрскую сеть и правила выплаты. Бывает внешним (http, ведёт на адрес партнёрки) и локальным (local, файлы лежат на нашем сервере).

Мультиофферы: в потоке можно указать несколько офферов с весами. Выбор детерминирован по посетителю - хеш от IP и User-Agent, - поэтому один и тот же человек при повторном заходе попадает на тот же оффер. Вес меньше или равный нулю считается единицей.

Лендинг¶

Страница-прокладка перед оффером. Локальный лендинг - это папка в каталоге /lander, залитая ZIP-архивом; внешний задаётся адресом. Доступ к файлам локального лендинга закрыт подписью со сроком 24 часа, поэтому выкачать чужую связку по прямой ссылке нельзя.

Клик-аут и LP-клик¶

Клик-аут - переход посетителя с лендинга на оффер по адресу https://<домен>/click?_ci=<сабка>. Трекер находит сохранённый Offer URL и отправляет посетителя туда.

LP-клик - зафиксированное нажатие CTA на лендинге. Это флаг на клик, а не счётчик: два нажатия на одном клике дают один LP-клик. Из-за этого CTR лендинга не может превысить 100%.

Сабка (subid)¶

Публичный идентификатор клика, по которому партнёрка возвращает конверсию. Вид: <время в base36>.2.<кусок идентификатора клика в base36>, например tjdxzn.2.bwdaui. Подставляется макросом {subid} в Offer URL.

Не путать с sub_id_1..sub_id_30 - это произвольные метки от источника трафика (площадка, креатив, аудитория).

Рядом живут ещё два идентификатора:

external_id - идентификатор клика на стороне партнёрки; по нему постбек тоже находит клик;
tid (transaction id) - идентификатор транзакции. Нужен для ребиллов.

Партнёрская сеть¶

Справочник, к которому привязываются офферы. Хранит адрес постбека и имя параметра, в котором сеть ждёт сабку - трекер сам дописывает его к Offer URL, если в адресе ещё нет {subid}.

Источник трафика¶

Рекламная сеть, откуда идёт трафик. Хранит соответствие параметров (какой параметр сети попадает в какое поле трекера), шаблон исходящего постбека и процент потери трафика. В справочнике 176 готовых шаблонов сетей.

Постбек (S2S Postback)¶

Серверный вызов, которым партнёрка сообщает трекеру о конверсии:

https://<домен>/postback?subid=<сабка>&status=sale&payout=10

«S2S» (server-to-server) означает, что вызов идёт между серверами, без участия браузера посетителя.

Исходящий постбек - обратное: трекер сообщает о конверсии рекламной сети, чтобы она оптимизировала закупку. Настраивается шаблоном адреса у источника трафика или правилом постбека.

Конверсия¶

Целевое действие посетителя. Одна конверсия принадлежит одному клику. Типы и их номера:

Номер	Статус	Название
1	`sale`	Продажа
2	`lead`	Лид
3	`rejected`	Отклонена
4	`trash`	Мусор
5	`registration`	Регистрация
6	`deposit`	Депозит

Партнёрки присылают разные слова, и трекер их распознаёт. Например, в sale превращаются approved, confirmed, paid, purchase, ftd, rebill, 1, sell; в rejected - cancel, refund, decline, invalid; в deposit - dep, redeposit. Неизвестный статус и отсутствие параметра трактуются как lead.

Смена статуса не создаёт вторую конверсию: пишется пара строк - отмена прежней и новая с тем же идентификатором конверсии и той же датой. Поэтому в отчётах конверсии считаются суммой знаков, а не количеством строк.

Ребилл (повторная конверсия)¶

Второй и последующие платежи по одному клику: продление подписки, второй депозит. Признак ребилла - новый непустой tid при уже существующей конверсии. Такая конверсия получает свой идентификатор и свою дату, а прежняя не отменяется.

Постбек без tid ребиллом не считается - иначе каждая повторная отправка партнёрки удваивала бы доход.

Дедупликация постбеков¶

Защита от повторов: точно такой же постбек, пришедший второй раз, отвечает ok (duplicate) и ничего не пишет. Окно дедупликации - 30 суток. Ключ учитывает статус, поэтому переход lead -> sale по одному tid проходит как смена статуса, а не как дубликат.

Расход (cost)¶

Стоимость клика. Считается в момент клика по типу стоимости кампании:

Тип	Расход на клик
CPC	`cost_value`
CPM	`cost_value / 1000`
CPUC	`cost_value`, если клик уникален в кампании; иначе 0
CPA, CPS, RevShare	0 - расход возникает не на клике

Если у кампании включён автоматический расход, значение из параметра cost в ссылке заменяет расчёт целиком.

Потеря трафика (traffic loss)¶

Процент кликов, которые не доезжают до трекера (редиректы, блокировщики). Это не отбрасывание трафика, а коэффициент пересчёта расхода:

расход = расход / (1 - потеря / 100)

При потере 10% расход клика растёт примерно на 11%. Значения вне диапазона 0-100 игнорируются. Процент кампании перебивает процент источника трафика.

Conversion Cap¶

Дневной лимит конверсий на оффер. Работает только когда лимит больше нуля и переключатель включён - иначе оффер участвует в ротации без ограничений. Счётчик ведётся по суткам в часовом поясе оффера и увеличивается только на новых конверсиях; исчерпавший лимит оффер выпадает из ротации до следующих суток.

Ограничения по кликам у оффера нет - оно живёт в фильтре потока «Лимит кликов» (область: поток или кампания; период: час, сутки или без ограничения).

Макрос¶

Подстановка вида {имя} в адресе - оффера, лендинга или постбека. Значение подставляется URL-кодированным. Форма {_имя} вставляет значение сырым, без кодирования; нужна редко, обычно когда сеть сама ждёт неэкранированную строку.

Неизвестный макрос остаётся в тексте как есть - по этому признаку опечатка в шаблоне видна в логе постбеков.

Домен, wildcard, catch-all¶

Домен - имя, на которое приходит трафик. Сертификат выпускается автоматически, но только для доменов, заведённых в трекере.

Wildcard-домен записывается как *.example.com и покрывает поддомены ровно одного уровня: a.example.com подойдёт, a.b.example.com и голый example.com - нет.

Catch-all (catch_not_found) - домен, который принимает запросы к несуществующим путям.

Группа и ACL¶

Группа - единица изоляции: кампании, офферы, лендинги, домены и источники раскладываются по группам, а пользователю выдаётся набор групп. Подробности - в разделе Управление командой.

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

Базовые величины¶

Считаются в ClickHouse. Отменяющие строки учитываются знаком (sign), поэтому отменённые записи не искажают итог.

Метрика	Как считается
Клики	Число кликов периода
Уники	Число кликов, уникальных в кампании
Боты	Число кликов с признаком бота
LP клики	Число уникальных кликов, по которым было нажатие CTA (флаг, а не счётчик нажатий)
Конверсии	Число живых конверсий
Лиды	Конверсии типа 2
Продажи	Конверсии типа 1
Депозиты	Конверсии типа 6
Отклонённые	Конверсии типа 3
Доход	Сумма выплат по конверсиям, приведённая к валюте трекера
Расход	Сумма расходов по кликам, приведённая к валюте трекера

Суммы в других валютах умножаются на курс из настроек в момент построения отчёта. Следствие, которое надо знать: смена курса меняет и прошлые отчёты. Строки без кода валюты считаются уже записанными в валюте трекера.

Производные метрики¶

Все формулы ниже совпадают с реализацией. Строка «Итого» пересчитывает ту же формулу от просуммированных базовых величин - сумма процентов смысла не имеет.

Метрика	Формула	Если знаменатель ноль
Профит	`Доход - Расход`	-
ROI	`(Доход - Расход) / Расход * 100`	0
Бот %	`Боты / Клики * 100`	0
CTR лендинга (LP CTR)	`min(100, LP клики / Клики * 100)`	0
CR	`Конверсии / Клики * 100`	0
Approve %	`(Продажи + Депозиты) / Конверсии * 100`	0
EPC	`Доход / Клики`	0
EPUC	`Доход / Уники`	0
CPC	`Расход / Клики`	0
eCPC	`Расход / Клики * 1000`	0
eCPM	`(Доход - Расход) / Клики * 1000`	0

Три пункта, на которых чаще всего ошибаются:

Approve % считается ко всем конверсиям, включая лиды, регистрации, отклонения и мусор, - а не только к продажам и отклонениям. На наборе 10 лидов / 3 продажи / 2 отклонения это 20%, а не 60%.
eCPC - это расход на тысячу кликов, вопреки названию. Расход на один клик - это CPC.
eCPM - это прибыль на тысячу кликов, а не выручка.

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

Верхний потолок CTR лендинга¶

Ограничение в 100% - не косметика. LP-клики стали флагом на клик, и свежие данные превысить сотню не могут; но в истории, записанной раньше, каждое нажатие CTA добавляло строку, и метрика показывала 200%.

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

В настройках можно завести свою метрику формулой от базовых величин. Доступные имена: clicks, uniques, bots, conversions, revenue, cost, leads, sales. Формула, которая не вычисляется или даёт бесконечность, показывается как 0.

Базис даты¶

Отчёт по кликам умеет считать двумя способами:

по дате клика (по умолчанию) - конверсия относится к тому дню, когда случился клик. Так видно окупаемость залива;
по дате конверсии - конверсия относится к дню, когда пришёл постбек. В этом базисе клик-метрики (уники, боты, расход, LP-клики) не применимы и показываются нулями, а «Клики» означает число кликов, давших конверсию.

Часовой пояс¶

Границы суток в отчётах считаются в часовом поясе трекера из настроек, а не в UTC. Пояс возвращается вместе с каждым отчётом.