KPIs customizados no painel

KPIs padrão (receita, pedidos, conversão) cobrem 80% das lojas. Para os 20% restantes, ShopIA permite criar KPIs customizados — fórmulas próprias com métricas existentes ou atributos da loja.

Quando criar um KPI custom

Você precisa de:

• KPI específico do seu negócio (ex: "receita por categoria premium")
• Razão entre métricas (ex: "ROI do Otto = receita Otto / custo Otto")
• Métricas internas próprias (ex: "% de clientes ativos que respondem WhatsApp")

Antes de criar, verifique se KPI padrão já não cobre. Lista de KPIs padrão em Painel > Resultados.

Onde criar

Configurações > Painel > KPIs customizados > Novo.

Configurando KPI

Campos básicos

Fórmula

ShopIA suporta fórmulas com métricas existentes + operadores:

SOMA(receita) WHERE categoria = "Premium"

COUNT(clientes) WHERE total_compras > 5

SOMA(receita_otto) / SOMA(custo_otto) * 100

Editor visual ajuda construir sem escrever sintaxe.

Filtros aplicáveis

Mesmo KPI custom pode ser filtrado pelos mesmos filtros do painel (período, segmento, etc.).

Exemplos

KPI 1: Taxa de fidelização

Nome: Taxa de fidelização
Fórmula: COUNT(clientes WHERE pedidos >= 2) / COUNT(clientes) * 100
Unidade: %

Mede quantos clientes voltaram a comprar.

KPI 2: ROI de Otto

Nome: ROI Otto
Fórmula: SOMA(receita_otto) / SOMA(custo_otto)
Unidade: número (multiplicador)

ROI > 1 = positivo.

KPI 3: Receita por canal

Nome: Receita Newsletter
Fórmula: SOMA(receita WHERE canal = "newsletter")
Unidade: R$

KPI 4: Conversão de captura para venda

Nome: Lead-to-Sale Rate
Fórmula: COUNT(clientes WHERE primeiro_pedido != null AND origem = "popup") / COUNT(leads WHERE origem = "popup") * 100
Unidade: %

Onde KPIs custom aparecem

Após criar:

• Card opcional no Painel principal (você arrasta do menu)
• Linha em Resultados / ROI
• Coluna em Relatórios
• Comparativo automático vs período anterior

Editando ou removendo

Configurações > Painel > KPIs customizados:

• Editar fórmula
• Mudar nome / descrição
• Remover

Histórico do KPI é preservado se você renomear (mantém comparativos).

Fórmulas inválidas

ShopIA valida fórmula ao salvar:

• Erros de sintaxe
• Métricas inexistentes
• Operações inválidas (dividir por zero, etc.)

Quando inválida, KPI mostra alerta no card e não calcula. Corrija a fórmula.

Limites

Performance

Cálculo é feito em agregação periódica (a cada 1 hora típico) e cache:

• Painel mostra valor recente, não tempo real
• Latência de mudança: até 1 hora
• Para tempo real (ex: pedido recém criado), use métricas padrão

<!-- TODO: confirmar com Gabriel intervalo de cache de KPI custom -->

Compartilhando entre membros

KPIs customizados criados por Owner ficam visíveis a toda equipe da loja.

Cada membro pode escolher quais arrastar para o painel pessoal dele:

1. Painel > Personalizar > Adicionar widget.
2. Lista de KPIs custom disponíveis.
3. Drag & drop.

Ordem do painel é por usuário.

Multi-loja

KPIs customizados são por loja. Para clonar entre lojas:

1. Configurações > Painel > KPIs > [KPI] > Exportar.
2. JSON com fórmula.
3. Em outra loja: Importar KPI.
4. Cole JSON.
5. Valide e salve.

Plano

KPIs customizados disponíveis em Starter ou superior. Plano Free não tem.

<!-- TODO: confirmar matriz por plano quando billing sair do stub -->

Boas práticas

Comece com 3-5 KPIs

Painel sobrecarregado vira ruído. Identifique os 3-5 KPIs que realmente movem decisão e priorize.

Documentação clara

Em Descrição explique:

• O que mede
• Como interpretar (alto bom? alto ruim?)
• Faixas saudáveis

Útil quando equipe nova entra.

Use comparativo

KPI sozinho diz pouco. Com comparativo (vs período anterior, vs ano passado), conta história.

Detalhes em Comparativos entre períodos.

Revise periodicamente

KPI que era importante 6 meses atrás pode ter virado ruído. Revise trimestralmente:

• Ainda é relevante?
• Ainda calcula corretamente (com mudanças do negócio)?
• Equipe ainda usa?

Remova obsoletos.

Casos práticos

Caso 1: e-commerce de moda

KPIs custom úteis:

• Receita por categoria (calça, vestido, acessório)
• Taxa de devolução por tamanho
• Ticket médio por canal de aquisição

Caso 2: e-commerce de pet shop

• Frequência de recompra (quanto tempo entre pedidos)
• Tipo de animal mais ativo (cão vs gato)
• Categoria de produto recorrente (ração mensal vs brinquedo eventual)

Caso 3: cosméticos

• LTV por classe de produto
• Cross-sell rate (skin care + maquiagem)
• Sazonalidade Mãe / Namorados / Natal

Sandbox e KPI custom

Em sandbox, métricas operacionais zeradas — KPIs custom que dependem de envios mostram zero. Métricas de receita de pedido continuam reais.

API

Para acessar KPIs customizados via API (BI, Power BI):

• Plano Pro+
• Endpoint REST disponível em Configurações > API > KPIs

Detalhes em Stack de BI (apontamento técnico).

Veja também

• Página de resultados / ROI
• Comparativos entre períodos
• Relatórios: exportar e agendar