O auditor de definições de métricas: descubra por que duas equipes informam números diferentes
Porque é que este prompt importa
Without a canonical definition, every review becomes an argument about whose spreadsheet is correct, and decisions get made on whichever number arrived first. Teams that find a definition gap after a board deck has gone out spend quarters rebuilding trust in the metric.
Para que o usamos
Your product team reports 48,200 active customers for March and your finance team reports 31,900. The quarterly review is on Thursday, and you need to know which number is wrong, or whether both are right under different definitions, before anyone presents either one.
Prompt
Act as a senior analytics lead who audits metric definitions before numbers reach executives. Context: I am [YOUR ROLE] at [YOUR COMPANY NAME]. Two or more teams report a metric called [METRIC NAME], and their numbers do not match. Their definitions, queries or dashboard notes are below, followed by the numbers each team reported for the same period: [PASTE DEFINITIONS, QUERIES OR DASHBOARD NOTES HERE] [PASTE THE REPORTED NUMBERS HERE]. Task: (1) Restate each team's definition as an explicit rule covering five dimensions: population (who is counted), event (what counts as an action), time window, deduplication rule, and attribution rule. (2) List every point where the definitions diverge, and estimate how much of the gap between the reported numbers each divergence explains. (3) Recommend one canonical definition that serves [PRIMARY DECISION THIS METRIC DRIVES], and state directionally which team's number will change and why. Constraints: Use only information in my input. Label every estimate as an estimate and state the assumption behind it. Do not favour a team because of seniority or because its number is larger. Write the canonical definition as one sentence a non-analyst could read. If a divergence cannot be resolved from the input, put it under Open Questions instead of guessing. Output Format: (a) a table with columns Team, Population, Event, Window, Deduplication, Attribution; (b) a ranked list of divergences with estimated contribution to the gap; (c) the canonical definition as a single bold sentence; (d) Open Questions as a bullet list.
Resultado
Metric audit: Active Customers (March) Scenario: Product reports 48,200. Finance reports 31,900. Gap: 16,300.
Definitions | Team | Population | Event | Window | Deduplication | Attribution | |---|---|---|---|---|---| | Product | All registered users | Any login | Last 30 days | Per user | User | | Finance | Accounts with a paid subscription | Active paid status on report date | Point-in-time | Per account | Account |
Divergences, ranked by estimated contribution to the gap 1. Population (about 14,800 of the 16,300 gap). Product counts free-tier users who logged in during the window. Finance excludes them. Estimate assumes most free-tier logins in Product's count belong to non-paying accounts. 2. Deduplication and attribution (about 1,500). Product counts each login from a 12-seat account as a separate user. Finance counts the account once. Estimate assumes roughly 1,500 of the gap comes from multi-seat accounts. 3. Window (not quantified). A 30-day login window captures users who lapsed during the month. A point-in-time status does not. This pushes the two numbers in opposite directions and cannot be sized from the input.
Canonical definition **Active Customers is the number of accounts with an active paid subscription on the last day of the reporting month.**
Effect on each team Product's number falls sharply and should be reported under its own name, such as Monthly Active Users. Finance's number does not change.
Open Questions - Does Finance count trial accounts as paying? The input does not say. - Does Product's login count include internal staff or support logins? - Does the 30-day window end at UTC midnight or at each user's local time?
Duas equipes informam a mesma métrica e obtêm números diferentes. Este prompt torna explícita a definição de cada equipe, encontra a divergência que explica a diferença e propõe uma definição canônica que você pode levar para uma revisão.
Quando usar
Sua equipe de produto informa 48.200 clientes ativos em março, e sua equipe financeira informa 31.900. A revisão trimestral é na quinta-feira. Você precisa saber qual número está errado, ou se ambos estão certos com definições diferentes, antes de apresentar qualquer um deles.
Por que importa
Sem uma definição canônica, cada revisão vira uma discussão sobre de quem é a planilha correta, e as decisões são tomadas com o número que chegou primeiro. Equipes que descobrem uma lacuna de definição depois de enviar um relatório ao conselho passam trimestres reconstruindo a confiança na métrica.
Por que o prompt é construído assim
O papel define um analista que audita definições em vez de defender uma equipe. O contexto exige suas definições e números reais, então o modelo trabalha com evidências e não com uma ideia geral do que significa «ativo». As cinco dimensões (população, evento, janela de tempo, deduplicação e atribuição) são onde as definições de métricas quase sempre divergem, e nomeá-las impede que a análise se reduza a um desacordo vago. O bloco de restrições protege contra a falha mais comum nesse tipo de tarefa: números confiantes que nunca estiveram nos dados de entrada. A seção de perguntas em aberto dá ao modelo um lugar honesto para registrar o que não consegue resolver.
Como adaptar
- Substitua os campos entre colchetes pelas definições reais do painel ou da consulta de cada equipe, não por resumos.
- Inclua os números informados para pelo menos dois períodos. Uma lacuna constante aponta para uma causa diferente de uma lacuna que varia.
- Depois da primeira execução, faça uma pergunta de acompanhamento: reclassifique as divergências supondo que contas de teste estão incluídas na contagem financeira. Isso mostra o quanto a conclusão depende de uma única premissa.
Um bom sinal de que a auditoria funcionou é a definição canônica caber em uma linha e a equipe cujo número muda conseguir aceitá-la. Se não couber, a definição provavelmente ainda é ambígua.