A aba Campos customizáveis (Configurações > Estrutura de Dados) gerencia os atributos personalizados dos seus usuários — os dados de perfil que o seu app, site ou importações enviam para a plataforma, como cpf, name e phone.

O que a tela mostra

A lista exibe cada campo com Nome do campo, Tipo (etiqueta como String) e Ações (editar ou excluir). Use a busca para localizar campos em estruturas maiores.

Criando um campo

  1. Clique em Adicionar Campo.
  2. Informe o Nome do Campo (por exemplo, "Nome do Cliente").
  3. Escolha o Tipo e clique em Adicionar.

Os seis tipos de dado

O tipo escolhido define como o campo se comporta em toda a plataforma — inclusive quais operadores de segmentação ficam disponíveis para ele nas audiências:

  • Texto — o tipo mais versátil, para nomes, códigos, categorias. Nas audiências, habilita os operadores de texto (Igual a, Contém, Começa com, Termina com...).
  • Número — valores quantitativos: pontos do programa de fidelidade, idade, score. Habilita comparações numéricas (Maior que, Menor que, Entre...).
  • Booleano — sim/não: aceita marketing, é assinante, completou onboarding. Habilita Verdadeiro/Falso.
  • Data — datas do cliente: nascimento, última compra na loja física, vencimento do plano. Habilita as condições temporais relativas e absolutas ("aconteceu há mais de X dias", "antes do dia Y").
  • Lista — múltiplos valores no mesmo campo: categorias favoritas, tags de interesse.
  • Objeto — estruturas compostas de dados, para informações mais complexas enviadas pela integração.

Escolher o tipo certo importa: um valor de compra salvo como Texto não permitirá "Maior que R$300" na segmentação; uma data salva como Texto não permitirá réguas de recência. Corrigir o tipo depois exige reprocessar o dado — defina certo desde o início.

De onde vêm os valores

Os campos são preenchidos por três vias: o SDK/integração do seu app ou site, as importações de lista (as colunas da planilha viram campos) e as integrações da App Store (como VTEX Master Data). O valor de cada usuário fica visível no perfil dele, na aba Atributos.

Boas práticas de governança

  • Padronize a nomenclatura em um único idioma e formato (data_nascimento, não DataNasc misturado com birthdate).
  • Documente o significado de cada campo para o time — seis meses depois, ninguém lembra o que era flag_x.
  • Evite campos duplicados para o mesmo dado (por exemplo, phone e telefone): eles fragmentam a segmentação.
  • Menos é mais: crie campos que a estratégia realmente usa. Campo vazio na base inteira só polui o construtor de audiências.