Паспорт метрики: визначення та контроль змін

Data Analyst Professional · Модуль 8 · Урок 29 із 51

Паспорт метрики й узгодження визначень

Паспорт метрики перетворює усну домовленість на контрольовану специфікацію. Дві команди мають отримати однаковий результат із тих самих даних — або явно бачити, де їхні definitions різняться.

90–120 хвMetric governanceМінітест: 3 питання

Мінімальний паспорт метрики

Блок	Що зафіксувати
Meaning	name, business question, purpose, owner
Formula	numerator, denominator, aggregation, unit, rounding
Scope	population, grain, inclusions, exclusions, segments
Time	event time, timezone, calendar/cohort window, late data
Data	source, keys, refresh cadence, lineage, access class
Decision	baseline, target, direction, guardrails, action rule
Governance	version, effective date, approvers, change log, QA owner

Перевіряйте registry як дані

SELECT metric_key, metric_name, numerator, denominator,
grain, window_rule, owner_role, target_value,
target_direction, guardrail_for, version
FROM seowork_lab.metric_registry
ORDER BY metric_key;

Registry має бути доступним поруч із dashboard і code, а не загубленим у чаті. Link на query/model і приклад calculation полегшують reproduction.

Change control без тихого переписування історії

ProposeПроблема, нова definition, affected reports і rationale.

CompareOld/new metric на overlap period та segment impact.

ApproveBusiness owner, data owner і downstream consumers.

ReleaseVersion, effective date, backfill policy та communication.

Якщо numerator або denominator змінився, це часто нова версія metric. Не склеюйте old/new series без позначки; dashboard має показувати definition break або перераховану історію.

Acceptance checks перед публікацією

Формула відтворюється незалежним control query.
Numerator не перевищує denominator там, де це логічно.
Totals reconcile із trusted source у межах tolerance.
Time zone, late-arriving events і incomplete cohorts оброблені.
Segments складаються в total без overlap або мають пояснений attribution.
NULL/zero denominator мають явну policy.
Owner підтвердив meaning, target, guardrails і action rule.

Практика: захистіть одну метрику

Оберіть activation_rate_7d у registry.
Перепишіть passport своїми словами й знайдіть неоднозначність.
Створіть reference SQL та reconciliation query.
Запропонуйте v1.1 із change rationale і overlap comparison.
Проведіть sign-off: product owner, analyst, data engineer, dashboard consumer.

Privacy теж частина паспорта

Metric має описувати лише потрібний рівень деталізації. Не публікуйте персональні або малі сегменти, якщо рішення не потребує цього.

Офіційні джерела

Модуль завершено

Ви можете обрати KPI, захистити його guardrails, розкласти outcome на drivers і погодити versioned metric passport, який відтворюється іншою командою.