Passar para o conteúdo principal

dim_customer

Cadastro dos clientes

Escrito por Caroline Silva

Cadastro dos clientes

A tabela dim_customer armazena o cadastro dos clientes (consumidores) da loja: nome, contato, documento, telefone, endereço, consentimento de marketing e o atendente responsável pela carteira. Cada linha é um cliente, identificado pela coluna customer_id, com o cadastro atual dele. Com dados atualizados de hora em hora, entre 6h e 22h (horário de Brasília); de madrugada não há atualização.


​Exemplo

Um consumidor fala pela primeira vez com a loja pelo WhatsApp e, dias depois, informa o e-mail ao atendente. Na tabela isso vira uma linha só:


• customer_id = 'cli123', name = 'Ana', phone_country_code = '55', phone_area_code = '11', phone_number = '912345678', created_at no dia do primeiro contato.


• Quando o e-mail é informado, a mesma linha passa a ter email = 'ana@exemplo.com' e updated_at muda. O valor anterior não fica guardado.


• Se o atendente Bruno colocar a Ana na carteira dele, user_owner_id passa a ser o user_id do Bruno na dim_user.


Muitos campos ficam vazios porque dependem do que foi cadastrado: em geral só o telefone vem preenchido em quase todos. O telefone é dividido em três colunas; junte phone_country_code, phone_area_code e phone_number para ter o número completo. O mesmo número pode aparecer em mais de um customer_id, então para contar pessoas pelo telefone use count(distinct ...) do número montado.


accept_marketing pode vir true, false ou vazio; vazio quer dizer que não há registro de consentimento, não que a pessoa aceitou. birth_date é texto no formato 'AAAA-MM-DD HH:MM:SS' e raramente vem preenchido. Para o nome do atendente da carteira, cruze user_owner_id com a dim_user; os campos personalizados do cadastro ficam na dim_customer_custom_fields, pelo customer_id.


Em contas com mais de uma loja, o mesmo consumidor tem um customer_id em cada loja: use retailer_id para separar.


Atenção: Os registros desta tabela utilizam o fuso horário UTC, ou seja, para que as datas sejam referentes ao fuso horário brasileiro, é preciso inserir nas queries o fuso horário brasileiro.

SET TIME ZONE '-03:00';


SELECT month(tb.birth_date) as mes_aniver

,COUNT(tb.customer_id) as qtd_clientes

FROM dim_customer AS tb

WHERE tb.created_at >= '2025-04-01'

GROUP BY month(tb.birth_date)

;

Dicionário de dados

Variável

Tipo

Descrição

customer_id

string

Id interno do consumidor, utilizado para vincular à outras tabelas (pela coluna customer_id das mesmas)

retailer_id

string

Id interno do cliente

user_owner_id

string

Id do atendente que tem esse consumidor na carteira.

name

string

Nome do consumidor

email

string

Email do consumidor

document

string

Documento do consumidor

accept_marketing

boolean

Campo de aceitar receber mensagens de marketing

updated_at

timestamp

Data da ultima atualização desse registro

created_at

timestamp

Data da criação desse registro

last_name

string

Ultimo nome

address_id

string

ID do endereço cadastrado

phone_country_code

string

Código do país do telefone

phone_area_code

string

Código de área do telefone

phone_number

string

Número do telefone

business_name

string

Nome da empresa informado

business_document

string

CNPJ da empresa informado

birth_date

string

Data de nascimento do consumidor (texto), quando informada

Respondeu à sua pergunta?