Зачем нужен паспорт#
Паспорт метрики фиксирует, что именно означает число и как его воспроизвести. Его читают аналитик, агент и критик. Если меняется определение заявки, источник или период, нужно сохранить это изменение рядом с расчётом и проверить сопоставимость результатов.
Для составного показателя опишите числитель и знаменатель отдельно. Пустое поле означает неизвестное условие; оно не превращается автоматически в ноль или разрешение продолжить. Паспорт помогает выполнить MM-01, а расчёт и поведение системы проверяются отдельно.
Открытый шаблон#
Название и версия определения: [метрика; дата изменения]
Источники: [файлы/системы, поля, схема связи событий]
Единица: [человек, заявка, заказ, платёж; единица результата]
Формула: [числитель / знаменатель; правило при нуле и пропуске]
Включение: [какие события входят и по какой дате]
Исключение: [тесты, отмены, неполные записи; основание исключения]
Дедупликация: [ключ; какая запись сохраняется при повторе]
Аудитория: [кто входит; правило связи с источником привлечения]
Период и таймзона: [начало включительно, конец исключительно;
часовой пояс; календарь событий]
Валюта: [код; состав денежной суммы; правило пересчёта, если нужен]
Свежесть: [по какую дату полон каждый источник; когда проверено]
Проверки: [контрольные строки, сверка итогов, условия блокировки]
Ответственный: [кто подтверждает определение и разбирает расхождения]
Заполненный учебный пример#
Полностью вымышленный учебный пример. Все файлы, записи, суммы, даты и роли придуманы. В примере нет клиентской выгрузки или обезличенной статистики.
Метрика: стоимость уникальной подтверждённой заявки, учебное определение 1. Источники: вымышленный файл расходов с полями «источник/дата/сумма» и файл заявок с «идентификатор/источник/время/статус». Все строки относятся к одному учебному источнику привлечения.
Единица и формула: RUB за уникальную заявку; расход делится на число включённых заявок. При нуле заявок значение не определено; при пропуске входных данных расчёт блокируется.
Включение: подтверждённые заявки по времени отправки. Исключение: тестовые записи. Дедупликация: один идентификатор учитывается один раз; повтор здесь полностью совпадает с исходной записью.
| Учебное событие | Учёт |
|---|---|
| R-A: подтверждена | Включить |
| R-A: повтор той же записи | Исключить дубль |
| R-B: тест | Исключить тест |
| R-C: подтверждена | Включить |
Аудитория: все заявки выбранного учебного источника; новые люди отдельно не выделяются. Период: 1 октября 2026, от 00:00 включительно до 00:00 следующего дня исключительно, Europe/Moscow. Валюта: RUB, только заданный расход на привлечение, без пересчёта валют.
Свежесть: оба вымышленных источника полны за этот день; учебная проверка выполнена 2 октября в 00:10. Ответственный: вымышленная роль «учебный аналитик».
Проверка и граница вывода#
Учебное правило проверки: сверить четыре строки, удалить повтор и тест, пересчитать знаменатель. Вымышленное наблюдение: осталось две заявки. При заданном вымышленном расходе 600 ₽ получается 600 / 2 = 300 ₽ за заявку.
Эта арифметика не подтверждает выручку, прибыль или эффект рекламы. Платежи и полный состав затрат не заданы; реальный результат бизнеса здесь не измеряется. Если источники не покрывают общий период или правило исключения неизвестно, остановите зависящий от этого расчёт и уточните паспорт.