Pular para o conteúdo
Português - Brasil
  • Não há sugestões porque o campo de pesquisa está em branco.

Como criar uma Metric Rules

Aprenda a criar, personalizar e gerenciar Metric Rules para definir quais colunas da base bruta serão interpretadas como métricas na plataforma

O que é uma Metric Rule

As Metric Rules determinam quais colunas da base de dados bruta contêm valores numéricos que devem ser interpretados como métricas — como Investimento, Cliques ou Vendas. Essas regras orientam o sistema sobre quais dados considerar em cálculos, visualizações e análises dentro da plataforma.

Somente após essa etapa, com os dados convertidos e padronizados, o sistema de inteligência consegue processá-los corretamente, permitindo que você visualize as informações na plataforma. 


 Métricas pré-configuradas e personalizadas

As Metric Rules podem ser pré-configuradas ou personalizadas. Na plataforma, elas são identificadas como Global Rules e Local Rules.

Global Rules

As Global Rules são regras pré-configuradas pela Uncover para providers que enviam dados em uma estrutura padronizada, como Google Ads, Meta Ads, TikTok Ads, Bing Ads, DV360 e Google Analytics 4.

Essas regras identificam as colunas numéricas da origem e as associam automaticamente às métricas correspondentes na plataforma. Uma Global Rule pode, por exemplo, mapear a coluna de custo enviada pelo provider para a métrica Investment ou associar as colunas de cliques e impressões às métricas Clicks e Impressions.

Cada provider (Google Ads, Meta Ads, TikTok Ads, Bing Ads, DV360, GA4 etc.) tem seu próprio conjunto específico de Global Rules. Elas aparecem na mesma seção Metric Rules da tabela, ao lado das Local Rules, mas identificadas como regras pré-configuradas da Uncover para aquele provider.

 

Local Rules

As Local Rules são regras personalizadas criadas para uma tabela específica. Elas são usadas quando você precisa mapear uma coluna que não está contemplada pelas regras pré-configuradas ou associá-la a uma métrica própria do seu negócio.

Por exemplo, se uma tabela contém a coluna receita_liquida, você pode criar uma Local Rule para associar seus valores à métrica Net Revenue. Essa regra será aplicada somente à tabela em que foi criada.

Antes de criar uma Local Rule
Verifique se uma Global Rule já faz a associação desejada. Crie uma regra local apenas quando precisar complementar ou personalizar o mapeamento daquela tabela. Assim, você evita regras duplicadas ou associações conflitantes.



Como criar uma metric rule

Para criar uma Metric Rule, associe uma coluna numérica da base bruta a uma métrica cadastrada na plataforma: 

Além das Metric Rules e Dimension Rules, a página Rules também conta com os botões Import rules, Export rules (para importar/exportar a configuração de regras) e Trigger Rule (para forçar o reprocessamento manual da tabela). Detalhes sobre a página Rules em si estão no artigo linkado no passo 1 abaixo, para não duplicar conteúdo aqui. 

  1. Acesse a página Rules da tabela desejada. (Em caso de dúvidas, consulte o artigo: O que é a Página Rules )
  2. Clique em Create new Rule na seção Metric Rules.
  3. No primeiro campo, selecione a coluna numérica da base bruta que contém os valores desejados.
    SET coluna da base bruta AS nome da métrica cadastrada 
  4.  No segundo campo, defina a métrica de destino:  
    1. Se a métrica já existir, selecione-a diretamente.
      1

    2. Se a métrica ainda não existir, clique em Create Metric, a primeira opção do dropdown. No modal New Metric que abre em seguida:
      1. Defina o nome da nova métrica
      2. Opcionalmente, adicione uma descrição que ajude outros usuários a entenderem o propósito da métrica.
      3. Selecione a Default Aggregation (agregação padrão), que determina como os valores dessa métrica serão agregados na visualização.
      4. Clique em Create. A métrica já fica selecionada na Rule.No segundo campo, defina a métrica de destino:
        2-Nov-11-2026-08-31-09-4860-PM
        3-Nov-11-2026-08-31-09-4543-PM
  5. Clique em Create para salvar a Metric Rule. 

Antes de clicar em Create Metric
Confira no dropdown se a métrica já existe. Criar direto pela regra é prático, mas duplicatas geram slugs diferentes para o mesmo dado e o modelo lê cada uma como uma variável separada. O nome define o slug, que não pode ser alterado depois da modelagem de dados. 



Como criar operações aritméticas

Você pode usar operações aritméticas para definir o valor da métrica no campo SET. Combine colunas diferentes em uma única expressão para aplicar cálculos diretamente na plataforma.

As operações possíveis são:

Tipo de operação Fórmula Exemplo aplicado
Soma $colunaA + $colunaB $conversoes_web + $conversoes_app
Subtração $colunaA - $colunaB $receita_bruta - $descontos
Multiplicação $colunaA * $colunaB $pedidos * 20.5
Divisão $colunaA / $colunaB $investimento / $cliques
Potenciação de base 10 $colunaA * 1.0eX onde X é o expoente $investimento_em_milhares * 1.0e3
 
Use ponto como separador decimal nas fórmulas, nunca vírgula. Valores com vírgula não são reconhecidos pelo sistema. Exemplo: $colunaA * 20.5

Você digita a expressão no primeiro campo da regra, o mesmo em que seleciona a coluna da base bruta. Em vez de escolher uma única coluna, escreva o cálculo usando $ antes do nome de cada coluna. No segundo campo, selecione ou crie a métrica que vai receber o resultado e clique em Create.

Você também pode combinar mais de uma operação na mesma expressão. Por exemplo, para registrar o ticket médio a partir da receita e do número de clientes:

 SET $receita_bruta / $clientes AS Avg Price

image-Nov-11-2026-09-01-45-9370-PM



Como customizando o período vigente de uma metric rule

Você pode personalizar o período de vigência de uma regra. Para isso:

  1. Na seção Metric Rules, localize a regra que deseja editar.
  2. Clique no ícone de calendário.
  3. Adicione as datas de início e fim nos campos Start Date e End Date.
  4. Clique em Update para salvar as alterações.
Rules Personalization

Como deletar uma metric rule

  1. Na seção Metric Rules, localize a regra que deseja excluir.
  2. Clique no ícone de lixeira.
  3. Clique em Delete.

Rules delet



Como confirmar se a regra está funcionando

Após criar ou editar uma regra, a plataforma exibirá automaticamente uma mensagem informando se a regra foi aplicada corretamente, para a data selecionada em Sample Data.

Quando a regra está funcionando corretamente, será exibida uma mensagem confirmando que a métrica foi identificada no conjunto de dados. Exemplo:

“Metric found in 1 out of 1 — 100% of all data points on 06/01/2024 and 2,000.00 is the sum of all values”

Já quando a regra não está funcionando corretamente, a mensagem indicará que a métrica não foi encontrada. Nesse caso, é recomendável revisar a configuração da regra. Exemplo:

“Metric not found in any data points on 06/01/2024”

Se a mensagem não aparecer logo após salvar, clique em Trigger Rule (botão fixo no canto inferior direito da página Rules) para forçar o reprocessamento da tabela e atualizar essa validação. 

 

 Ainda com dúvidas? Nossa equipe está pronta para ajudar! Fale conosco pelo suporte ou envie um e-mail para support@uncover.co