O que é a Página Rules

A página Rules (página de regras) centraliza a configuração de cada tabela integrada. Cada tabela está vinculada a um conjunto de regras de Metrics e Dimensions, e é aqui que você define como os dados serão interpretados e estruturados na plataforma.

Nesta página, você pode:

Criar e editar regras de Metrics e Dimensions;
Consultar informações gerais da base;
Visualizar amostras e estatísticas dos dados;
Exportar valores únicos da base;
Validar como as regras serão aplicadas.

Como acessar a página de regras

Para acessar a página de regras de uma tabela específica, siga estes passos:

No menu lateral, clique em Data Sources.
Na página Data Sources, localize a conexão correspondente à tabela que você deseja configurar.
Clique no ícone ▾ ao lado da conexão desejada.
Na linha da tabela desejada, clique no menu “⁝”.
Selecione Manage Rules para acessar e gerenciar a página de regras.

Visão geral

A página de regras tem quatro seções principais:

Informações gerais: exibe metadados da tabela como o Slug, o SLA e Fields.
Sample Data: apresenta uma amostra de até 5 registros em uma data específica.
Metric Rules e Dimension Rules: seções de configuração das regras de tratamento para métricas e dimensões.
Aliases: seção para adicionar variações de termos usados para cada dimensão.

1. Informações gerais

Slug

Identificador único de uma tabela na seção de integração.

SLA

Representa a defasagem tolerada entre a data atual e o dado mais recente da tabela (em dias). Este contrato é importante para garantir que os dados estejam atualizados, o que pode ser verificado na página principal de Data Sources ao comparar o SLA com o Time Range.

Fields

Lista de todas as colunas da base de dados bruta, mostrando o tipo de dado identificado em cada uma, como texto (String) ou número (Number).

2. Data Visualization

A página de regras conta com uma seção chamada Data Preview. Nela, além das visualizações de Sample Data e da exportação de valores únicos, você acessa um resumo das estatísticas dos dados em um período específico.

Summary

Na aba Summary, você consulta as estatísticas dos dados.

Para selecionar o período desejado:

Na seção Data Preview, clique no botão de seleção de data.
Escolha como deseja visualizar os dados:
- No primeiro seletor, escolha a quebra temporal (Full Range, Year, Semester, Quarter ou Month).
- No segundo seletor, escolha o período correspondente.
- Para quebras diferentes de Full Range e Year, será exibido um terceiro seletor, onde você poderá especificar a subdivisão (ex.: H1, H2, Q1, Q2, Q3, Q4 ou o mês desejado).
Com as seleções desejadas feitas, a tabela em Summary será atualizada com os dados do período selecionado.

Dica: O terceiro seletor será mantido fixo sempre que possível para facilitar comparações entre anos diferentes.

Exemplo: se você escolher Agosto/2023, basta trocar o ano no segundo seletor para ver Agosto/2024, sem precisar selecionar o mês de novo.
Mas atenção: se o período não existir no ano escolhido, o sistema automaticamente vai mostrar o primeiro período disponível daquele ano.

Sample Data

Na seção Sample Data, é possível selecionar uma data para ter o prévia de data points da conexão. Para isso, clique em Sample Data e, em seguida, selecione a data desejada.

Exportação da base bruta

Para ajudar em validações mais específicas, você pode fazer um download completo do dado bruto. Essa exportação considera toda a base, independentemente da data selecionada nas abas Sample Data ou Summary.

Para exportar:

Na página de regras, clique no ícone de menu e selecione a opção Download All Data.
Um arquivo compactado em formato .zip será gerado, contendo um ou mais arquivos .csv representando a base em sua totalidade. A divisão em múltiplos arquivos .csv é feita de modo a garantir que seja possível carregar os arquivos usando as ferramentas mais comuns para visualização, como Google Sheets e Excel.

Exportação de valores únicos

Você também pode exportar os valores únicos das colunas de texto da base original. Essa exportação considera toda a base, independentemente da data selecionada nas abas Sample Data ou Summary.

Para exportar:

Na página de regras, clique no ícone de menu e selecione a opção Download Unique Values.
No modal Export Unique Values, selecione uma ou mais colunas de texto.
Clique em Export.
Um arquivo .csv será gerado, contendo os valores únicos para o conjunto de colunas selecionado.

Para providers com páginas de regras globais:

A página de regras de alguns provedores podem consolidar mais de uma conexão por vez. São eles: Bing Ads, DV360, Facebook Marketing, Google Ads, Google Analytics 4 e TikTok Marketing.

Nesses casos, o seletor exibe uma opção extra para você selecionar o tipo de exportação desejada, All connections ou Only this connection:

All connections: exporta os valores únicos de todas as conexões desse provedor. Exemplo: Todas as conexões integradas de TikTok Ads do Workspace.
Only this connection: exporta apenas os valores únicos da conexão atual, ou seja, aquela a partir da qual o link foi clicado na página de Data Source e cujos dados estão sendo exibidos no Summary.

3. Metric e Dimension Rules

Essas seções são responsáveis por definir como os dados serão interpretados e estruturados dentro da plataforma.

Metric Rules

Responsável por associar valores numéricos às métricas. Nesta seção, são definidas quais colunas da base de dados representam medidas quantitativas, como Investimento, Cliques ou Vendas, que serão consideradas em cálculos, análises e visualizações. Para entender como criar uma Metric Rule, acesse o artigo:

Como criar uma Metric

Como criar uma Metric Rules

Dimension Rules

Destinada à categorização das métricas. Aqui são definidas as colunas que representam dimensões descritivas, como Canal, Campanha, Formatos, Plataformas, Região, que permitem segmentar, agrupar e organizar os dados. Para entender como criar uma Dimension Rule, acesse o artigo:

Como criar uma Dimension

Como criar uma Dimension Rule

Dimension Rules Validation

Essa funcionalidade permite prever como as regras configuradas serão aplicadas a uma dimensão específica, facilitando a validação dos valores esperados. Por meio da exportação de um arquivo .csv, é possível visualizar todos os valores que serão classificados como pertencentes à dimensão selecionada, com base nas regras previamente definidas.

Para fazer a exportação:

Na seção Dimension Rules Validation, clique em Select dimensions and export CSV.
No modal Export Rules, selecione a dimensão desejada — só é possível selecionar uma por vez.
Clique em Export para baixar os dados selecionados.

Importante: essa exportação é assíncrona. Depois que você solicitar, a Uncover vai te avisar por notificação na interface e por e-mail quando o arquivo estiver pronto para download.

Como que funciona:

A partir da seleção da dimensão, o sistema:

Busca nas Dimension Rules todas as regras que envolvem a dimensão selecionada.
Identifica, nas colunas da base de dados bruto, quais valores estão sendo categorizados como pertencentes àquela dimensão.
Compara os valores originais com a configuração definida na regra.
Gera um arquivo .csv contendo:
- Os valores únicos das colunas originais (potenciais classificadores da dimensão).
- A coluna de dimensão selecionada.
- Slug do valor atribuído a ela (caso tenha sido categorizado).

Valores únicos das colunas originais	Dimensão selecionada	Slug do valor atribuído a ela
produto_A1	Product	sku-a
produto_A2	Product	sku-a
produto_B	Product	sku-b
produto_C	Product	sku-c

4. Aliases

Aliases são termos de busca utilizados para atribuir opções a uma dimensão. "Face", "FB" e "Facebook", por exemplo, poderiam ser aliases da opção "Facebook" na dimension "Platform". Nesta seção, você pode cadastrar alternativas para garantir que diferentes representações de uma mesma opção sejam interpretadas de forma unificada e atribuídas corretamente à mesma dimensão.

Para adicionar opções de Alias:

Na seção Alias, selecione a dimensão que deseja editar.
No modal [Dimension] Aliases, adicione a variação do termo;
Em seguida, selecione a Dimension Option à qual deseja atribuir esta variação.
Clique no botão “+” ao lado.

Ainda com dúvidas? Nossa equipe está pronta para ajudar! Fale conosco pelo Suporte Intercom ou envie um e-mail para [email protected]