Criar métricas personalizadas

Uma métrica personalizada é uma fórmula sobre métricas que já existem no catálogo, como “Valor gasto ÷ Leads” para ter um custo por lead com o nome que o cliente usa. Você escolhe um modelo, seleciona as métricas em listas com busca e vê a prévia do resultado dos últimos 30 dias antes de salvar. Depois de criada, ela aparece no catálogo, abre a própria página de detalhe e pode ir para qualquer dashboard do cliente.

Antes de começar

• Quem cria, edita e exclui: o dono da conta (empresa), a equipe da agência e, no cliente, os papéis Admin e Editor. Viewer só vê.
• A métrica é do cliente aberto. Para usar a mesma fórmula em outro cliente, crie de novo nele.
• Todas as métricas da fórmula precisam ser da mesma plataforma (por exemplo, só Meta Ads). Não dá para dividir o investimento do Google Ads pelos leads do Meta Ads numa métrica personalizada.
• A plataforma precisa estar conectada e ativa no cliente: a fórmula é validada contra os dados reais dessa conexão.

Passo a passo

1. 1
   Passo 1

   Abra Nova métrica

   Em Métricas, clique em Nova métrica. Abre a janela Nova métrica customizada.

2. 2
   Passo 2

   Dê nome e identificação

   Preencha os campos de identificação. Os obrigatórios são o slug, o título e a categoria.

   • Slug (id único): um identificador curto, sem espaços, como cpl_meta. Ele não pode ser alterado depois.
   • Título: o nome que aparece no catálogo e nos dashboards, como “Custo por lead”.
   • Descrição: opcional, explica a fórmula para quem lê.
   • Categoria: agrupa a métrica no catálogo, por exemplo eficiência.
3. 3
   Passo 3

   Escolha um modelo

   Os botões de Modelos já montam a estrutura da fórmula e sugerem o formato e a direção boa:

   • Razão: A ÷ B (formato decimal, bom quando sobe).
   • Custo por: custo ÷ resultado (formato moeda, bom quando desce).
   • Percentual: (A ÷ B) × 100 (formato percentual).
   • Soma, Diferença e Multiplicação: A + B, A − B e A × B; o formato vem da primeira métrica.
   • Personalizada: começa vazia para você montar termo a termo.

   Tela ilustrativa

   Nike/Métricas

   Perguntar ao RelatorAIPT

   Métricas

   Valor gastoR$ 12.480,00

   Nova métrica customizadaCrie uma fórmula sobre medidas base da mesma plataforma.

   Slug (id único)cpl_meta

   TítuloCusto por lead

   ModelosRazãoCusto porPercentualSomaDiferençaMultiplicaçãoPersonalizada

   1

   PlataformaMeta Ads

   2

   FórmulaValor gasto ÷ LeadsR$ 28,40 nos últimos 30 dias

   3

   Criar métrica4

   1. 1O modelo monta a estrutura e sugere formato e direção.
   2. 2A plataforma limita as métricas que podem entrar na fórmula.
   3. 3Cada termo da fórmula é escolhido numa lista com busca; a prévia aparece embaixo.
   4. 4Criar métrica só libera quando a fórmula está válida e os campos obrigatórios preenchidos.

4. 4
   Passo 4

   Escolha a plataforma e as métricas

   Em Plataforma, selecione a fonte. Em cada termo da fórmula, clique em Escolher métrica e busque pelo nome. Use Adicionar com um operador (+, −, ×, ÷) para incluir mais termos, Agrupar para pôr parênteses e Remover último para desfazer. Na lista também dá para usar um número fixo (por exemplo, 100) com Usar número.

5. 5
   Passo 5

   Confira a validação e a prévia

   Quando todos os termos estão preenchidos, o Relator valida a fórmula com os dados da conexão. Aparece Fórmula válida e, logo abaixo, o resultado dos últimos 30 dias (“R$ 28,40 nos últimos 30 dias”). Se algo estiver errado, a mensagem diz o quê: termo vazio, métrica que não existe no catálogo ou divisão por zero. Em Mostrar expressão você vê a fórmula escrita.

6. 6
   Passo 6

   Defina formato e direção

   Em Formato, escolha Moeda, Inteiro, Percentual ou Decimal. Em Bom quando, diga se a métrica é melhor quando Sobe ou Desce. Essa direção decide a cor das variações e qual dia é o “melhor dia” na página de detalhe.

7. 7
   Passo 7

   Salve

   Clique em Criar métrica. A métrica entra na fonte Métricas personalizadas do catálogo, com o mesmo cartão das outras.

Editar, duplicar e excluir

No cartão de uma métrica personalizada, abra o menu Ações e escolha Editar, Duplicar ou Excluir. Na página de detalhe da métrica também há o botão Duplicar. A cópia nasce com o título “Cópia de …” e precisa de um slug novo.

Exemplos úteis

Os nomes exatos das métricas dependem da plataforma; use a busca do seletor para achar o nome certo.

Problemas comuns

• Criar métrica continua desabilitado → falta slug, título, categoria ou plataforma, ou a fórmula ainda não está válida.
• “A métrica … não foi encontrada no catálogo” → a métrica deixou de existir na conexão (por exemplo, a conta foi trocada). Escolha outra métrica no termo.
• “A fórmula divide por zero” → você usou um número 0 como divisor. Troque o divisor.
• A prévia mostra — → não houve dado nos últimos 30 dias para essas métricas. A métrica pode ser criada mesmo assim.