Além da ementa · tema 37 de 40
Camada semântica e definição de métricas
30 min · 2 vídeos · 10 cards · 1 drill
Por que cai
É a resposta estrutural para a pergunta que abre quase toda sabatina de Analytics: por que dois relatórios divergem. Reconciliar caso a caso resolve o incidente; camada semântica resolve a classe do problema. Quem só sabe reconciliar mostra operação; quem propõe a camada mostra arquitetura.
Pré-teste · 1 de 2
responda antes de verPor que uma métrica calculada dentro de cada painel tende a produzir números divergentes?
Vídeo · português · 2 min
Em uma frase
A camada semântica é onde a definição de uma métrica vive uma vez só e de onde qualquer ferramenta recebe o mesmo número — mas ela não decide qual definição vale: isso é decisão de negócio.
Por que os números divergem
A causa estrutural não é cálculo errado: é duplicação. Quando cada painel implementa a própria versão de "receita", as versões evoluem separadas. Uma passa a excluir cancelamento, outra não; uma usa a data do pedido, outra a do faturamento. Ninguém errou — e os números não batem.
| Onde a métrica é definida | O que acontece |
|---|---|
| Dentro de cada painel | Lógica duplicada, evolução separada, divergência garantida |
| Numa consulta compartilhada por cópia | Divergem assim que alguém edita a cópia |
| Na camada semântica | Definida uma vez, consumida por todos, muda num lugar só |
Ela não é o dicionário de dados: o dicionário descreve o significado de colunas; a camada define métricas, e é consumida em tempo de consulta.
O que uma definição precisa ter
- 1Nome e fórmula.
- 2Janela de tempo.
- 3Filtros e exclusões: cancelamento, teste interno, pedido de funcionário.
- 4Qual data usar: do pedido, do faturamento ou do pagamento.
- 5Grão a que ela se aplica.
- 6Dono, que é do negócio.
- 7Versão, com data de vigência.
O teste de uma boa definição é operacional: duas pessoas implementam a partir do texto e chegam ao mesmo número. Se não chegam, o problema está no texto.
O problema é organizacional
Três áreas com três definições de "cliente ativo" quase sempre têm três definições legítimas para contextos diferentes. A camada semântica dá o lugar para resolver, mas alguém precisa decidir:
- Se uma é a oficial da empresa, ela é implementada uma vez, com dono do negócio, e as outras são aposentadas.
- Se as três são legítimas, a saída não é escolher: é dar três nomes distintos, cada um com dono, e abandonar a palavra genérica.
Como isso fecha com o resto da trilha
A camada semântica é onde a regra de precedência de Source of Truth vira executável: a métrica oficial é definida sobre a tabela certificada, e todo consumidor — painel, consulta, modelo — recebe esse número. O painel para de recalcular, e a divergência deixa de ter por onde nascer.
Como responder isso em voz alta
Comece dizendo que o problema é organizacional. Mostre as diferenças nos eixos concretos (janela, critério, exclusão, data). Peça decisão e dono de negócio. Só então proponha a implementação única na camada, sobre a tabela certificada. E declare o efeito na série histórica — é a parte que o resto das pessoas esquece e que, esquecida, gera a próxima crise de confiança.
Se quiser outro ângulo1 vídeo
Como cai na sabatina
“Cada área calcula 'cliente ativo' de um jeito. Como você resolve isso de forma definitiva?”
Erros comuns
- Achar que o problema é técnico. Duas definições de receita convivendo é problema organizacional; a camada semântica dá o lugar para resolvê-lo, mas alguém precisa decidir qual vale.
- Deixar cada painel calcular a métrica. É assim que definições divergentes nascem: a lógica fica duplicada em ferramentas diferentes e evolui separada.
- Escrever definição ambígua. 'Cliente ativo é quem comprou recentemente' não é definição; sem janela, sem critério de compra e sem tratamento de cancelamento, cada pessoa implementa uma coisa.
- Não nomear o dono da métrica. Sem alguém que responda pela definição, qualquer mudança vira discussão sem árbitro.
- Versionar métrica sem avisar. Mudar a definição muda a série histórica; quem olha o gráfico vê uma quebra que parece do negócio e é da régua.
- Confundir camada semântica com dicionário de dados. O dicionário descreve colunas; a camada semântica define métricas e é consultável, entregando o mesmo número a qualquer ferramenta.
Flashcards
Card 1 de 10
0 certos · 0 a reverDrill
A definição é implementável?
Para cada definição, diga se ela pode ser implementada sem interpretação.
1.'Receita: soma do valor faturado, líquido de cancelamentos, pela data de emissão da nota.'
2.'Churn: clientes que deixaram de comprar.'
3.'Ticket médio: receita líquida dividida pelo número de pedidos aprovados no mesmo período.'
4.'Engajamento: o quanto o usuário usa o produto.'
5.'Cliente ativo: pelo menos uma compra aprovada não cancelada nos últimos 90 dias, pela data de faturamento.'
Quiz · 1 de 2
Qual afirmação sobre camada semântica é mais defensável?
Explique para um gerente
Explique em um minuto por que a mesma palavra pode significar coisas diferentes em duas áreas da empresa, e o que isso custa.
Se travar numa palavra técnica, é sinal de que ainda não entendeu essa parte.
Prefiro falar em voz alta
00:00
Toque para gravar, ou responda em voz alta sem gravar
Perguntas de sabatina deste tema2
- · Descobrimos que três áreas calculam 'cliente ativo' de formas diferentes. Como você resolve isso de forma definitiva?
- · O que faz uma definição de métrica ser boa, e como você sabe que a sua está?