# Паспорт метрики

Источник: https://kurzemnek.ru/method/data-contract
Автор: Валерий Курземнек
Опубликовано: 2026-10-23
Обновлено: 2026-10-23


<h2 id="purpose">Зачем нужен паспорт</h2>

Паспорт метрики фиксирует, что именно означает число и как его воспроизвести. Его читают аналитик, агент и критик. Если меняется определение заявки, источник или период, нужно сохранить это изменение рядом с расчётом и проверить сопоставимость результатов.

Для составного показателя опишите числитель и знаменатель отдельно. Пустое поле означает неизвестное условие; оно не превращается автоматически в ноль или разрешение продолжить. Паспорт помогает выполнить [MM-01](/method/specification#mm-01), а расчёт и поведение системы проверяются отдельно.

<h2 id="passport-template">Открытый шаблон</h2>

```text
Название и версия определения: [метрика; дата изменения]
Источники: [файлы/системы, поля, схема связи событий]
Единица: [человек, заявка, заказ, платёж; единица результата]
Формула: [числитель / знаменатель; правило при нуле и пропуске]
Включение: [какие события входят и по какой дате]
Исключение: [тесты, отмены, неполные записи; основание исключения]
Дедупликация: [ключ; какая запись сохраняется при повторе]
Аудитория: [кто входит; правило связи с источником привлечения]
Период и таймзона: [начало включительно, конец исключительно;
                    часовой пояс; календарь событий]
Валюта: [код; состав денежной суммы; правило пересчёта, если нужен]
Свежесть: [по какую дату полон каждый источник; когда проверено]
Проверки: [контрольные строки, сверка итогов, условия блокировки]
Ответственный: [кто подтверждает определение и разбирает расхождения]
```

<h2 id="synthetic-passport">Заполненный учебный пример</h2>

**Полностью вымышленный учебный пример.** Все файлы, записи, суммы, даты и роли придуманы. В примере нет клиентской выгрузки или обезличенной статистики.

**Метрика:** стоимость уникальной подтверждённой заявки, учебное определение 1. **Источники:** вымышленный файл расходов с полями «источник/дата/сумма» и файл заявок с «идентификатор/источник/время/статус». Все строки относятся к одному учебному источнику привлечения.

**Единица и формула:** RUB за уникальную заявку; расход делится на число включённых заявок. При нуле заявок значение не определено; при пропуске входных данных расчёт блокируется.

**Включение:** подтверждённые заявки по времени отправки. **Исключение:** тестовые записи. **Дедупликация:** один идентификатор учитывается один раз; повтор здесь полностью совпадает с исходной записью.

| Учебное событие | Учёт |
| --- | --- |
| R-A: подтверждена | Включить |
| R-A: повтор той же записи | Исключить дубль |
| R-B: тест | Исключить тест |
| R-C: подтверждена | Включить |

**Аудитория:** все заявки выбранного учебного источника; новые люди отдельно не выделяются. **Период:** 1 октября 2026, от 00:00 включительно до 00:00 следующего дня исключительно, Europe/Moscow. **Валюта:** RUB, только заданный расход на привлечение, без пересчёта валют.

**Свежесть:** оба вымышленных источника полны за этот день; учебная проверка выполнена 2 октября в 00:10. **Ответственный:** вымышленная роль «учебный аналитик».

<h2 id="passport-check">Проверка и граница вывода</h2>

**Учебное правило проверки:** сверить четыре строки, удалить повтор и тест, пересчитать знаменатель. **Вымышленное наблюдение:** осталось две заявки. При заданном вымышленном расходе 600 ₽ получается 600 / 2 = **300 ₽ за заявку**.

Эта арифметика не подтверждает выручку, прибыль или эффект рекламы. Платежи и полный состав затрат не заданы; реальный результат бизнеса здесь не измеряется. Если источники не покрывают общий период или правило исключения неизвестно, остановите зависящий от этого расчёт и уточните паспорт.