A aba Eventos (Configurações > Estrutura de Dados) gerencia os eventos de comportamento da sua operação — as ações que os usuários realizam no app ou site, como view_item, search, add_to_cart, begin_checkout, purchase, login e sign_up — e os campos personalizados (propriedades) de cada evento.

O que a tela mostra

A lista exibe cada evento com o Nome do Evento, a quantidade de Campos (por exemplo, "5 campos") e a ação Deletar. Clicando na seta de um evento, você expande os Campos do Evento: cada campo numerado com Nome (como item_id, item_name) e Tipo (String, número...), com opções de edição e exclusão — e um botão Adicionar campo para incluir novas propriedades.

Criando um evento

  1. Clique em Novo Evento.
  2. Digite o Nome do Evento (por exemplo, PRODUCT_VIEW) e clique em Criar Evento.
  3. Expanda o evento criado e adicione os campos/propriedades que ele carrega.

O nome registrado aqui precisa corresponder exatamente ao nome que o app/site dispara — alinhe com o time de desenvolvimento.

Eventos vs. campos do evento: a distinção que importa

  • O evento registra que algo aconteceu (houve uma compra).
  • Os campos do evento registram o contexto daquela ocorrência (valor, moeda, cupom, itens, frete).

Essa distinção alimenta diretamente o motor de audiências: o evento habilita as 17 condições comportamentais (frequência, recência, "nunca aconteceu"...), enquanto os campos habilitam os filtros de propriedade — o "ONDE" que refina quais ocorrências contam ("purchase ONDE value > 300"). Um evento sem campos ainda é segmentável, mas só pela ocorrência; com campos bem definidos, ele vira contexto completo. Veja o funcionamento em Audiências: o motor de segmentação manual.

Onde os eventos aparecem na plataforma

  • Dashboard — gráficos de Eventos e Conversões e o Top Eventos.
  • Audiências — Blocos de eventos e filtros de propriedade.
  • Campanhas e jornadas — eventos de conversão (a régua de sucesso) e objetivos de jornada.
  • Automações — gatilhos que iniciam fluxos.
  • RFV — o "evento analisado" da matriz, com o campo de valor alimentando a dimensão V.

Boas práticas

  • Instrumente o funil completo (visualização → carrinho → checkout → compra): cada elo faltante é uma segmentação impossível.
  • Padronize nomes no mesmo formato (snake_case como add_to_cart é o padrão do mercado).
  • Todo evento de transação deve ter campo de valor — sem ele, RFV, receita por campanha e filtros de ticket ficam cegos.
  • Cuidado ao deletar: excluir um evento remove a estrutura da qual audiências e réguas dependem. Verifique o impacto antes.