KPI com alvo no modelo

Selo de estado: Preview (teto atual do produto) · Curso ACD-340 — Publicação, distribuição, RLS e BI-as-code · Aula 6 de 8 · Atualizado em 2026-10-05.

Objetivo#

Ao final desta aula você vai definir alvo no KPI do modelo e ler realizado contra alvo no visual.

Vídeo#

Identificador no manifesto: acd-340-06-kpi-com-alvo-no-modelo · duração-alvo 6 min · tela do produto: /dashboards.

Roteiro (capítulos):

1. 00:00–01:00 — Onde mora o alvo: dentro do KPI do modelo semântico, não numa tela separada.
2. 01:00–02:30 — Criar o KPI Receita com valor realizado, alvo e direção (modelo → KPIs).
3. 02:30–04:00 — O visual desenha a comparação: bullet, gauge, progress, thermometer.
4. 04:00–05:00 — O limite honesto: o KPI com alvo não avisa ninguém — alerta é por visual.
5. 05:00–06:00 — Nota histórica (a tela de Metas saiu do produto) e encerramento.

Conteúdo#

O alvo vive no KPI, dentro do modelo

Acompanhar alvo no Ingestia é uma decisão de modelo, não de tela. Um KPI do modelo semântico tem uma fórmula de valor realizado e, opcionalmente, um alvo — um número fixo ou outra fórmula do motor — mais a direção ("maior é melhor" para faturamento, "menor é melhor" para custo ou churn) e a formatação. Quem abre o painel não digita nada: o realizado é recalculado a cada refresh, junto com o resto do painel, e o alvo viaja no modelo como qualquer outra definição.

Isso tem uma consequência prática que vale mais que a tela que não existe: porque o alvo é parte do modelo, ele é um alvo para todos os painéis que usam aquele KPI. Mudar o alvo num lugar muda em todos — e nenhuma cópia do número fica para trás numa planilha paralela.

Como aparece no produto

No console, em /dashboards, você abre o modelo do painel e a seção KPIs. Cada KPI pede:

• a fórmula de valor — a mesma linguagem das medidas, nada de sintaxe nova:

SOMA(valor)

• o alvo — um número fixo (400000) ou uma fórmula, inclusive uma que cite outra medida da biblioteca (MEDIDA('Meta do mês'));
• a direção (maior é melhor / menor é melhor) e as frações que separam bom de atenção.

Sem alvo o KPI é só um número. Com alvo ele ganha a comparação — e é essa comparação que o visual sabe desenhar. A notação das fórmulas de valor e de alvo é a mesma da Aula 12 do ACD-320, onde o KPI com meta aparece ao lado de grupos de cálculo e parâmetros.

Quando usar

Use alvo no KPI quando o painel precisa responder "estamos batendo?" no próprio visual — um cartão de atingimento no topo do painel comercial, uma barra de bala numa tabela de indicadores por filial, um velocímetro na tela da diretoria.

Quando o alvo precisa variar por filial, produto ou mês, não escreva doze números fixos: carregue a sua tabela de metas no datalake (uma coluna de alvo por filial e mês), trate-a como qualquer outra tabela do modelo e use uma medida sobre ela como alvo do KPI. O alvo deixa de ser constante e passa a seguir o recorte do painel — e é essa a forma que o produto oferece hoje para um alvo com granularidade própria.

Como o visual desenha realizado contra alvo

Quatro visuais do catálogo existem exatamente para essa leitura:

Todos pedem 1 métrica + alvo. Sem alvo configurado eles degradam de propósito: um bullet sem marca é uma barra comum, e um gauge sem alvo perde a referência de bom/ruim. A escolha entre eles é assunto da Aula 3 do ACD-330; aqui o ponto é outro — o alvo não é propriedade do visual, é do modelo. Trocar bullet por gauge não mexe no alvo; apagar o alvo do KPI muda os dois.

O cuidado com RLS: alvo fixo contra realizado recortado

A RLS do leitor recorta as linhas que a medida soma (Aula 3). Um número fixo no alvo não é recortado por nada: ele é o mesmo para todo mundo. Então um gerente restrito a São Paulo que abre um painel com alvo fixo de R$ 400 mil vê o realizado só de SP comparado com o alvo da empresa inteira — a conta fecha errado sem que ninguém tenha errado uma fórmula. Quando o painel é lido por pessoas com recortes diferentes, o alvo precisa ser uma medida sobre a tabela de metas (acima), que a mesma RLS filtra.

O limite honesto: o KPI não dispara alerta

Um KPI com alvo desenha a comparação; ele não avisa ninguém. Alerta é configuração por visual: no editor, com o gráfico selecionado, faixa Formatar ▸ Alerta — Avisar quando, Medida, Resumir por, Canal e Destinatário. A avaliação acontece no refresh do painel (não existe cron dedicado de alerta), o disparo é na transição para violado e rearma quando normaliza; alertas pedem plano Business+. Os detalhes, os canais (e-mail, WhatsApp, webhook assinado) e o estado de maturidade estão em Exportação e distribuição.

Resumindo a divisão de trabalho: modelo guarda o alvo, visual desenha a comparação, alerta do visual avisa alguém. Três lugares, três responsabilidades — e o selo do conjunto é Preview, com a entrega real do aviso marcada como NÃO MEDIDO na documentação.

Nota histórica: a tela de Metas foi removida

Até 26/09/2026 o produto tinha uma área Metas (scorecard) em /metas: cada meta era um registro à parte, com valor-alvo, prazo, responsável e um realizado apontado para um indicador de painel; o board calculava status (batida, no caminho, atrasada, sem dado) e avisava quando uma meta perdia o indicador de origem. Essa tela saiu do produto — a rota não existe mais, e com ela saíram prazo e responsável como campos de produto.

Isso está na aula de propósito, por dois motivos. O primeiro é que print, treinamento antigo e link salvo continuam circulando: quem procurar "Metas" no menu precisa saber que o acompanhamento de alvo mudou de lugar, e que o lugar é o KPI do modelo. O segundo é o que a mudança ensina sobre o produto: alvo é definição de modelo, não cadastro paralelo; prazo e responsável, se o negócio precisa deles, são dados do cliente (uma tabela de metas no datalake), não campos de uma tela. A nota de remoção está registrada na documentação, em Medidas, fórmulas e KPIs, seção "KPIs no modelo".

Erros comuns

• Procurar a tela. /metas não existe mais; o alvo está no KPI do modelo, em /dashboards → modelo → KPIs.
• Esperar aviso do KPI. Alvo definido não notifica ninguém — configure o alerta no visual (Formatar ▸ Alerta).
• Pôr bullet ou gauge no canvas sem alvo no KPI e estranhar a barra sem marca: o visual só desenha o que o modelo definiu.
• Alvo fixo em painel com RLS por UF — realizado recortado contra alvo da empresa inteira; use a tabela de metas como fonte do alvo.

Faça você mesmo#

No workspace de treino Aurora Varejo (abra /dashboards no console):

1. No modelo, seção KPIs, crie o KPI Receita com valor SOMA(valor), alvo 400000 e direção "maior é melhor".
2. Ponha um bullet no canvas lendo esse KPI e confirme que ele desenha a marca do alvo e as faixas, além do valor.
3. Troque o mesmo painel para gauge e confirme que o ponteiro mostra o atingimento (percentual do alvo), com o mesmo número do bullet.
4. Apague o alvo do KPI e volte ao painel: o bullet vira barra comum. Reponha o alvo — a prova de que o alvo é do modelo, não do visual.
5. Com o visual selecionado, abra Formatar ▸ Alerta e configure "Avisar quando" a receita ficar abaixo do alvo, com canal e destinatário. Note que o alerta pertence ao visual: o KPI, sozinho, não avisava ninguém.
6. Troque o alvo fixo por uma fórmula (MEDIDA('Meta do mês') sobre uma tabela de metas do modelo) e confirme que o atingimento passa a acompanhar o recorte do painel.

Você terminou quando conseguir explicar, com suas palavras, onde o alvo vive, qual visual desenha a comparação e por que ninguém é avisado só porque o KPI tem alvo.

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

• bi/medidas-formulas-kpis — seção "KPIs no modelo" (inclui a nota de remoção da tela de Metas)
• bi/exportacao-distribuicao — alertas por visual, canais e maturidade
• bi/visuais/bullet e bi/visuais/gauge — os visuais de alvo
• ACD-330 · Aula 3 — kpi, kpi-spark, multikpi, bullet, gauge

Capacidades ensinadas#

C06.5 (KPI no modelo, grupos de cálculo e parâmetros) e C08.5 (alertas por visual, com histórico e webhook) — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".