Меъмории метрикӣ

Меъмории ченакҳо

Меъмории метрикӣ як системаи қоидаҳо, артефактҳо ва хидматҳоест, ки таърифҳои яктарафа, ҳисобкунии такроршаванда, дастрасии шаффоф ва кори боэътимоди нишондиҳандаҳоро дар тамоми созмон таъмин мекунанд. Ҳадаф аз он иборат аст, ки "MAU", "Нигоҳдории D30" ё "ARPPU" дар ҳама панелҳо, таҷрибаҳо ва гузоришҳо якхела ҳисобида шаванд.

1) Принсипҳо

1. Манбаи ягонаи ҳақиқат барои формулаҳо ва маълумотномаҳо.
2. Ҷудосозии семантика аз татбиқ: таърифи тиҷорат дар қабати семантикӣ зиндагӣ мекунад, на дар ҳар SQL/ноутбук.
3. Нишондиҳандаҳо, схемаҳо ва формулаҳо (v1 → v2) бо муҳоҷирати таърихии идорашаванда.
4. Репродуктивӣ ва санҷиш: ҳисобҳо муайянкунанда буда, бо санҷишҳо фаро гирифта шудаанд.
5. Мушоҳида: тару тоза, пуррагӣ, пайдарҳамӣ ва дуршавӣ - бо SLO ва огоҳиҳо.
6. Амният ва махфият: кам кардани PII, RLS/CLS, аудит.
7. Системаи амалиётӣ ҳамчун рамз: таърифҳо, тағиротҳо, сиёсатҳо - дар анбор бо CI/CD.

2) Қабатҳои меъморӣ

Маълумоти манбаъ: рӯйдодҳо/амалиётҳо, маълумотномаҳо, гузоришҳои моделӣ/инфра.
Интегратсия ва тозакунӣ: CDC/боркунии афзоянда, тарҳ, муттаҳидсозии минтақаҳои вақт.
Модели маълумот (DWH): ситораи/барфпӯше, андозагирии оҳиста тағирёбанда (SCD), калидҳои суррогатӣ.
Қабати семантикии ченакҳо: таърифҳои якхела, агрегатҳо, филтрҳо, ғаллаи вақт, мантиқи ғелонда.
Қабати тарроҳӣ: партия/микробатч/ҷараён; тирезаҳо, аломатҳои об, калидҳо.
Каталог ва луғат: "ченакҳои шиноснома", насл, соҳибон, ҳуқуқҳо.
Дастрасӣ ва истеъмол: панелҳои BI/, ченакҳои API, боргузорӣ, таҷрибаҳо/AB.

3) Шартномаҳои маълумот ва ченакҳо

Шартномаи манбаъ (рӯйдодҳо/ҷадвалҳо)

Схема: майдонҳо, намудҳо, нулӣ, калиди асосӣ.
SLA: тару тоза (масалан, "≤ 10 дақиқа ақиб"), басомад, ҳадди аксар ба таъхир афтод.
Сифат: беҳамтоии калидҳо, доменҳои арзиши дуруст, вақт, аблаҳӣ.
Тағирот: сиёсати эволютсияи схема (ба қафо/ба пеш), нақшаи дуршавӣ.

Шартномаи метрӣ

Ном/ID: 'RET _ D30 _ v2'

Domaine/Соҳиби: Таҳлили маҳсулот

Таъриф (бо забони инсонӣ)

Формула: SQL/псевдокод + дӯконҳои вуруд/объектҳои семантикӣ

Гранулярӣ/мантиқи муваққатӣ: рӯз/ҳафта; қоидаҳои вақт-вақт, вақтсанҷ

Сегментҳо/Филтрҳои пешфарз

Воҳидҳо ва асъорҳо (қурби табдили/сана)

SLO: тару тоза ≤ X, дақиқӣ ≥ Y, дастрасӣ ≥ Z

Таърихи версия/Тағйирот/Санаи самаранок

Посбонҳо: диапазонҳои дуруст, қоидаҳои винзоризатсия p1/p99

4) Қабати семантикии ченакҳо

• Унсурҳо: андозаҳо (сана, кишвар, платформа), далелҳо (рӯйдодҳо, даромад), ченакҳо (ARPU, нигоҳдории D30), майдонҳои ҳисобшуда, тақвим (кор/истироҳат, истироҳат).
• Рафтори вақт: ҷадвалҳои тақвимӣ, ақибмонӣ, гурӯҳҳо, тирезаҳои "лағжанда" (7/30/90).
• Рӯйпӯш ва пайдарҳамӣ: миқдор аз рӯи рӯз = моҳ, ба истиснои ҳисобкунии дукарата (корбарони алоҳида).
• Танзими омехта: ба эътидол овардани омехтаи доимии каналҳо/кишварҳо барои YO-и ростқавл.
• Multicurrency/timezones: ба асъори асосӣ дар санаи муомилот тасҳеҳ карда мешавад; иловаро маҳаллӣ ва "каноникӣ" UTC.

5) Ҳисоб: партия, микробатч, ҷараён

Гурӯҳ: корҳои шабона/яксоата, ҳисобкунии пурра/афзоянда, назорати idempotency.
Microbatch: тирезаҳо 1-15 дақиқа барои панелҳои амалиётӣ.
Ҷараён: рӯйдодҳо тавассути шина; тирезаҳо (афтиш/лағжиш/сессия), аломатҳои об (маълумоти дер), семантикаи якдафъаина (мағозаи бунбаст + офсет).

• 'HOP 5m, WINDOW 1h' for KPI;
• 'Нишондиҳандаҳои ҳаррӯзаи TUMBLE 1for;
• 'Ҷаласаҳои 30 мфор.

6) Сифат ва санҷиш

Санҷишҳои маълумот: схемавӣ, домен (диапазон), истинодҳои истинодӣ.
Санҷишҳои ченакҳо: инвариантҳо (DAU ≤ MAU), сегментҳои холӣ, интизориҳои якранг (кумулятивӣ).
Муқоиса: байни қабати семантикӣ ва ҳисоботҳои истинодӣ/баҳисобгирӣ.
Саломатии маълумот: тару тоза, мукаммалӣ, нусхабардорӣ, фраксияи NULL, ҷаҳишҳои ғайримуқаррарӣ.
Андозагирии дрифт: PSI/KL/JS оид ба хусусиятҳои асосӣ, хусусан барои ченакҳои ML.

7) Версия ва муҳоҷират

Версияи формула 'METRIC _ NAME _ v' мебошад. Бе тағир додани версия "оромона" тағир додани таъриф манъ аст.

• Паҳлӯ ба паҳлӯ: v1 ва v2 ба таври мувозӣ ҳисоб карда мешаванд; мусолиҳа ва таълими истифодабарандагон гузаронида мешавад.
• Бурида: гузариш ба истеъмолкунандагон ба v2 дар равзанаи сарбории кам; бойгонии v1.
• Ҳисобкунии таърих: backfill мувофиқи маълумоти таърихӣ; протоколи фарқият (гузориши diff).
• Алоқа: changelog, санаи воридшавӣ, ки таъсир мерасонад, дастурҳо.

8) Модели маълумот барои ченакҳо

Далелҳо: ғалла (event_id, transaction_id, user_day), вақти воқеа, ҷамъи/арзишҳо.
Андозаҳо: корбар, дастгоҳ, ҷуғрофия, канал, маҳсулот, тақвим; Навъи SCD барои таърих.
Калидҳо: ID-ҳои суррогатӣ, калидҳои тиҷорати устувор, ҷадвалҳои харитасозӣ.
Анти-нусхаҳо: қоидаҳои шахсият (якҷояшавии корбар), тирезаҳои сессияи "часпонидан".

9) Воҳидҳо, асъорҳо, мавсимӣ

Воҳидҳо/формат: воҳидҳои возеҳ, яклухткунӣ, миқёс (log/linear).
Multicurrency: табдили қурби асъор дар санаи муомилот; ҳам "хом" ва ҳам маблағи муқарраршударо нигоҳ доред.
Мавсимӣ: Нишондиҳандаҳои мавсимӣ ва мавсимӣ; эффектҳои алоҳидаи "истироҳат".

10) Амният ва дастрасӣ

Амнияти сатри сатр (RLS): дастрасӣ ба ченакҳо аз рӯи кишвар/бренд/шарик.
Сатҳи сатҳи сутун (CLS) - Майдонҳои PII/молиявӣ.
Аудит: кӣ метрикаро талаб кард, кадом филтрҳо, ки маълумотро содир мекарданд.
Тафовути API: "маҷмӯаҳо аз рӯи нақш" vs "боркунии муфассал".

11) Мушоҳида ва SLO

Тару тозаи SLO: масалан, "KPI амалиётӣ - ақибмонӣ ≤ 15 дақиқа, ҳамарӯза - то соати 06:00 ба вақти маҳаллӣ".
Мавҷудияти SLO: ≥ 99. 9% барои қабати API/семантикӣ.
Огоҳиҳо: қонунвайронкунии SLO, ҷаҳишҳои метрӣ, афзоиши NULL/такрорӣ, ихтилофи v1 vs v2> X%.
Китобчаҳо: ҳангоми таназзул чӣ кор кардан лозим аст - қадамҳои RCA, таназзул (масалан, гузариш ба охирин "метрикаи фаврӣ").

12) Таҷрибаҳо ва ченакҳо

Нишондиҳандаҳои посбонӣ: ниҳонӣ, устуворӣ, FPR/FNR барои баҳодиҳӣ.
Таърифҳои ягона барои A/B: табдили, нигоҳдорӣ, NSM - тавассути ҳамон қабати семантикӣ.
Таъсири ҳадди ақали фарқшаванда (MDE), таҳлили қувваи барқ: параметрҳои нигоҳдорӣ дар корти ченакҳо.
Атрибутсияи сабабӣ: сиёсатҳо аз ҷониби гурӯҳҳои омехта ва назоратӣ.

13) Нишондиҳандаҳо ва истеъмоли API

Запросы: 'GET/metrics/{ name}? аз = 2025-09-01 & to = 2025-10-01 & dims = кишвар, платформа ва филтрҳо = канал: пардохт'.
Сиёсатҳо: маҳдудиятҳо, кэш, пагинатсия, "содирот".
Версияҳо: 'X-Metric-Version: сарлавҳаи v2', огоҳиҳои амортизатсия.

14) Намунаҳо ва артефактҳо

Шиносномаи метрӣ (мисол)

Рамз/Версия: 'ARPPU _ v3'

Таъриф: даромади миёнаи як истифодабарандаи пардохт дар давра

Формула: 'сум (revenue_net )/ count_distinct (user_id куҷо paying_flag=1)'

Гранулярӣ: рӯз; rollup: ҳафта/моҳ = ҷамъи ҳисобкунак/ҷамъи denominator

Манбаъҳо: 'fact _ payments _ v2', 'dim _ users _ scd'

Воҳидҳо: асъори 'base _ ccy'; табдилдиҳӣ бо қурби асъор аз

Филтрҳои пешфарз: бозорҳои фаъол, амалиётҳои санҷиширо истисно кунед

SLO: тару тоза ≤ 1 соат; Мавҷудияти API ≥ 99. 9%

Гвардияҳо: ARPPU ∈ [0; 10 000]; винзоризатсия p1/p99

Соҳибон: Таҳлили монетизатсия; санаи таҷдиди назар: 2025-10-01

Нашри метрикии рӯйхат

• Таъриф ва формулаи мувофиқашуда, ки бо санҷишҳо фаро гирифта шудаанд
• Объекти семантикӣ сохта шудааст; насл ҳуҷҷатгузорӣ шудааст
• Backfill ва истинодҳо ба итмом расиданд
• SLO/огоҳиҳо танзим карда мешаванд; runbook омода аст
• Ҳуқуқҳо ва RLS танзим карда шудаанд; PII пинҳон
• Версияҳои кӯҳна дар панели/таҷрибаҳо иваз карда шуданд
• Changelog/иртибот фиристода шудааст

нуқтаи вақти рамзи псевдо SQL (масалан Нигоҳ доштани D30)

sql
WITH cohort AS (
SELECT user_id, MIN(event_date) AS signup_date
FROM fact_events
WHERE event_type = 'signup'
GROUP BY 1
),
activity AS (
SELECT user_id, event_date
FROM fact_events
WHERE event_type = 'app_open'
),
ret AS (
SELECT c. signup_date,
COUNT(DISTINCT CASE WHEN a. event_date = c. signup_date + INTERVAL '30 day' THEN a. user_id END) AS returned,
COUNT(DISTINCT c. user_id) AS cohort_size
FROM cohort c
LEFT JOIN activity a
ON a. user_id = c. user_id
AND a. event_date BETWEEN c. signup_date AND c. signup_date + INTERVAL '30 day'
GROUP BY 1
)
SELECT signup_date, returned / cohort_size AS retention_d30
FROM ret;

15) Хатогиҳои зуд-зуд ва чӣ гуна аз онҳо канорагирӣ кардан

Таҳрири формулаи ором: ҳамеша тавассути версия ва changelog.
"Дар ҳар як ноутбук фарқ мекунад": Қувва ба қабати семантикӣ/API.
Вақтҳо/асъорҳои номувофиқ: тақвими мутамарказ ва ҷадвали FX.
Баҳисобгирии дуҷонибаи корбар: қоидаҳои роллинг ва калидҳои беназир.
Тару тозаи ношаффоф: Вақти ақибмонӣ/навсозиро равшан нишон диҳед.
Вобастагӣ аз як муҳандис: ҳама чиз ба монанди код аст, бо барраси ва oncall.

Ҷамъ

Меъмории ченакҳо луғат + қабати семантикӣ + ҳисобкунии мустаҳкам + идоракунӣ ва SLO мебошад. Бо риояи принсипҳои тавсифшуда (шартномаҳо, озмоишҳо, версияҳо, мушоҳида, бехатарӣ), шумо ченакҳоро аз "баҳсҳои рақамӣ" ба механизми устувори маҳсулот ва идоракунии тиҷорат табдил медиҳед.