Stop debat metrik itu jarang karena orangnya kurang pinter. Biasanya karena definisinya gak pernah dikunci. Minggu ini conversion 2.1%, minggu depan 1.7%, terus meeting habis buat nanya “yang bener yang mana?”, bukan buat mutusin langkah.

Gue beresin ini pakai satu hal yang simpel tapi ngaruh: KPI Doc yang dipakai mingguan. Bukan dokumen onboarding yang dibuka sekali terus ditinggal. KPI Doc yang hidup itu bikin semua orang ngomongin hal yang sama: definisi, sumber data, edge case, dan keputusan apa yang diambil dari angka itu.

Kenapa debatnya gak kelar?

1. Definisi ngambang: “active” bisa login, buka app, transaksi.

2. Source of truth dobel: GA4 bilang A, DB bilang B, warehouse bilang C.

3. Edge case gak ditulis: dedup, timezone, refund, retry, late events.
   Kalo ini gak ditulis, angka jadi bahan debat. Dan orang bakal milih angka yang paling enak buat argumennya.

Format KPI Doc yang gue suka itu 3 lapis, biar enak dibaca tapi tetep bisa dicek:
(1) Definisi manusia: KPI ini buat keputusan apa, rumusnya apa (numerator/denominator), window, timezone, breakdown wajib.
(2) Aturan main + edge case: dedup key, exclusion (test/internal/bot), refund window, late events, toleransi clock skew, trigger investigasi.
(3) Reference SQL: bukan buat pamer query panjang, tapi buat “kwitansi” kalo angka dipertanyakan.

Isi minimal KPI Doc biar kepake tiap minggu:

• Decision usage: KPI ini dipakai buat mutusin apa minggu ini?

• Source of truth: satu yang resmi, yang lain cuma konteks

• Formula + mapping event: event apa yang ngisi numerator/denominator

• Guardrail: metrik pendamping biar gak salah arah

• Owner + SLA: siapa yang investigasi kalo aneh, kapan update status

• Versioning: kalo definisi berubah, versi + tanggal efektif + alasan

Snippet SQL yang sering nyelametin waktu (cek completeness per platform):

select date_trunc('day', event_time) as day, source, count(*) as cnt
from events
where event_name = 'key_action'
  and event_time >= now() - interval '14 days'
group by 1,2
order by 1 desc, 2

Ritual mingguan biar dokumennya hidup:

• 10 menit: health data (freshness, missingness, duplikasi, late events)

• 15 menit: delta KPI inti + 1–2 driver dari breakdown

• 10 menit: 1 action (owner + deadline) + 1 validasi (QA check/eksperimen)

Output meeting itu keputusan tertulis. Kalo gak ada action+owner, buang meeting-nya (atau buang KPI-nya).