Como criar uma Dimension Rule

O que é uma Dimension Rule

As Dimensões são atributos que caracterizam e segmentam as métricas, permitindo análises mais detalhadas e flexíveis. Elas funcionam como filtros ou agrupadores das métricas. Por exemplo, ao perguntar “Qual foi o valor investido em Google Ads em um determinado dia?”, temos: Valor investido como Métrica e Plataforma como uma Dimensão, que neste caso assume o valor de Google Ads.

As Dimension Rules são responsáveis por mapear e atribuir os valores de cada linha dos dados brutos às opções de dimensões cadastradas na plataforma. Essas regras são essenciais para garantir que os dados sejam agrupados e filtrados corretamente, permitindo uma análise consistente e padronizada nas visualizações e relatórios.

---

Dimensões pré-configuradas e personalizadas

A plataforma já oferece um conjunto de dimensões pré-configuradas pela Uncover, pensadas para atender aos casos de uso mais comuns e acelerar o processo de harmonização dos dados. No entanto, também é possível criar dimensões personalizadas, diretamente na página de Dimensões ou durante a criação de uma nova dimension rule, conforme será descrito neste artigo.

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 classificam automaticamente informações comuns da origem e evitam que você precise criar os mesmos mapeamentos do zero. Uma Global Rule pode, por exemplo, identificar que os dados de uma tabela pertencem à plataforma Google Ads e atribuir a opção correspondente à dimensão Platform.

 

Local Rules

As Local Rules são regras personalizadas para uma tabela específica. Elas permitem complementar as classificações das Global Rules ou mapear informações próprias do seu negócio.

Por exemplo, uma Local Rule pode analisar o nome das campanhas e atribuir cada linha às opções das dimensões Product ou Goal.

---

Importar e exportar regras em lote

Na página Rules de cada tabela, acima das seções de Metric Rules e Dimension Rules, existem os botões Import rules e Export rules, que permitem baixar ou subir de uma vez todas as regras configuradas daquela tabela — útil para backup ou para replicar a configuração entre tabelas semelhantes. Atenção: importar um arquivo substitui as regras existentes da tabela, então confira o conteúdo antes de importar.

---

Atribuição geral para toda a base

As Dimension Rules permitem realizar atribuições diretas a todas as linhas da base de dados, sem a necessidade de condições específicas. Esse recurso é útil quando se deseja classificar todo o conjunto de dados com uma mesma dimensão, como, por exemplo, associar uma base inteira a um determinado canal, objetivo, país.

Para configurar uma atribuição geral:

1. Clique em Create new Rule na seção Dimension Rules.
2. No primeiro campo, selecione Set.
3. Selecione a dimensão e depois a opção da dimensão.
4. Clique em Save.

 SET dimensão AS opção da dimensão 

---

Como criar uma dimension rule condicional 

 Para criar uma Dimension Rule condicional, defina a condição e associe o resultado a uma dimensão. Se a condição usar os aliases de uma dimensão, configure também o de-para antes de salvar a regra. 

1. Defina a condição

Nesta etapa, você define qual coluna da base bruta será analisada e como seus valores serão comparados com uma string ou com os aliases de uma dimensão.

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 Dimension Rules.
3. No primeiro campo, selecione If.
4. No segundo campo, selecione a coluna da base bruta que será analisada. Em seguida, escolha o Match, ou seja, o tipo de comparação que a plataforma deve realizar.
    IF coluna da base bruta MATCHES valor ou alias de referência 
5.  No campo de referência, defina o valor usado na comparação (as opções de Match disponíveis são is exactly, starts with, ends with e contains):  
   

   Is exactly, starts with, ends with e contains

   Se o valor na base bruta for google_ads_br:

   • Com is exactly, a regra só reconhece esse valor exato. Qualquer variação (espaço extra, sufixo, prefixo) não casa, e a linha não recebe a dimensão.
   • Com starts with, a regra reconhece valores que começam com "google_ads_br" . Por exemplo, google_ads_br_campanha também casa, mas campanha_google_ads_br não.
   • Com ends with, a regra reconhece valores que terminam com "google_ads_br" . Por exemplo, campanha_google_ads_br também casa, mas google_ads_br_campanha não.
   • Com contains, a regra reconhece qualquer valor que contenha "google_ads_br" em qualquer posição do texto.
   
   
   1. Para uma string literal, digite diretamente o valor que a plataforma deve procurar.
   2. Para usar os aliases de uma dimensão existente, selecione a dimensão correspondente.
   3. Para usar os aliases de uma dimensão que ainda não existe, digite o nome desejado para a nova dimensão e clique em Create Dimension.

   No modal que aparece em seguida:

   1. Defina o nome da nova dimensão
   2. Opcionalmente, adicione uma descrição que ajude outros usuários a entenderem o propósito da Dimensão.
   3. Clique em Create para finalizar a criação da dimensão
      
   4.  Para criar uma Dimension Option que ainda não existe, digite o nome desejado no campo aliases for [dimensão] e clique em Create Dimension Option. 
      

   No modal New dimension option:

   1. Informe o nome da opção. Para criar várias de uma vez, separe os nomes por vírgula: a primeira fica selecionada no campo e as demais ficam disponíveis na dimensão.
   2. Clique em Create.
   

 

2. Configure os aliases usados na condição, se necessário

Esta etapa só é necessária quando você seleciona os aliases de uma dimensão como referência na condição. Nesse caso, configure o de-para que relaciona os valores encontrados na base às opções dessa dimensão. Se você usou uma string literal, siga diretamente para a etapa de associação com a dimensão.

Por exemplo, os valores facebook, fb e meta_ads podem ser associados à opção Meta Ads da dimensão Platform. Assim, a condição consegue reconhecer essas variações como referências à mesma opção.

 

Diferença entre Workspace, Source e Workspace + Source

Antes de adicionar o de-para, escolha em qual seção ele deve ser criado:

• Workspace: o de-para tem aplicação geral no workspace.
• Source: seção somente leitura (só tem o botão Download CSV, sem opção de adicionar ou fazer upload) que mostra os aliases herdados da configuração de origem da tabela (Global Rules do provider). Use apenas para consulta.
• Workspace + Source: o de-para é aplicado somente à tabela correspondente. Use essa opção quando o mesmo alias puder ter significados diferentes em outras tabelas.

 

Como adicionar um de-para

• Alias: representa o valor de origem, ou seja, o “de”. Informe o termo que a plataforma deve procurar nos dados.
• Dimension Option: representa o valor de destino, ou seja, o “para”. Selecione a opção da dimensão à qual o alias deve ser associado.

Para adicionar e salvar um alias:

1. Na seção Workspace ou Workspace + Source, preencha o campo Alias com o valor encontrado na base de dados.
2. No campo Dimension Option, selecione a opção correspondente da dimensão.
3. Clique em +. O de-para será adicionado e salvo na lista.

 

Como alterar a prioridade ou excluir aliases

A ordem dos aliases define a prioridade de leitura das regras dentro da seção em que foram adicionados. A plataforma verifica os de-paras na sequência em que aparecem na lista.

• Para alterar a prioridade, use o ícone à esquerda do alias para arrastá-lo até a posição desejada. Quando houver possibilidade de mais de uma correspondência, posicione primeiro a regra mais específica.
• Para excluir somente um de-para, clique no ícone de lixeira ao lado da regra.
• Para remover todos os de-paras de uma seção, clique em Delete All.

 

Como gerenciar aliases por CSV

Você também pode gerenciar os de-paras em massa:

• Clique em Download CSV para baixar a lista de aliases da seção correspondente.
• Preencha ou ajuste os de-paras no arquivo, mantendo sua estrutura.
• Clique em Upload CSV para importar os aliases.

Certifique-se de usar os botões da seção correta: Workspace para aliases gerais ou Workspace + Source para aliases específicos da tabela.

 3. Associe o resultado a uma dimensão 

A opção Case Sensitive faz com que a Dimension Rule diferencie letras maiúsculas de minúsculas ao comparar os valores da base com a condição definida.

Por exemplo, se a regra buscar o valor Google Ads:

• Com Case Sensitive ativado, a regra reconhece Google Ads, mas não considera google ads ou GOOGLE ADS como o mesmo valor.
• Com Case Sensitive desativado, a regra considera essas variações de maiúsculas e minúsculas como o mesmo valor.

Para ativar essa opção:

1. Na seção Dimension Rules, localize a regra que deseja configurar.
2. Clique em Edit.
3. Ative a opção Case Sensitive.
4. Clique em Save para salvar a alteração.

---

 

Como adicionar uma regra Then ou Else

Ao configurar uma Dimension Rule condicional, é possível adicionar regras para lidar com os dados que atendem ou não atendem as condições estabelecidas. Para isso, é possível usar regras THEN e ELSE.

THEN: Indica o que deve acontecer quando a condição for atendida. Ou seja, se a linha da base corresponder ao critério especificado (por exemplo, conter determinada palavra ou valor), será aplicada a associação definida nesse bloco.

ELSE: Indica o que deve acontecer quando a condição não for atendida. Serve para capturar todos os outros casos — garantindo que as linhas que não corresponderem aos critérios da condição original também recebam uma classificação.

Para adicionar uma regra THEN ou ELSE:

1. 1. Ao finalizar a regra condicional, clique no menu ⁝.

   2. Selecione THEN ou ELSE.

   3. Crie uma nova regra (podendo ser condicional ou atribuição geral).

---

Como customizar o período de vigência de uma dimension rule

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

1. 1. Na seção Dimension Rules, localize a regra que deseja editar.

   2. Clique no menu ⁝.

   3. Selecione a opção Set data range.

   4. Adicione as datas de início e fim nos campos Start Date e End Date.

   5. Clique em Save para salvar as alterações.

Como deletar uma dimension rule 

1. 1. Na seção Dimension Rules, localize a regra que deseja editar.

   2. Clique no menu ⁝.

   3. Selecione a opção Delete.

   4. Clique em Delete.