Skip to main content
Bem-vindo! Este guia foi criado para explicar como o Synapside coleta e organiza informações sobre o comportamento de seus usuários. Aqui você aprenderá conceitos fundamentais sem necessidade de conhecimento técnico profundo.

O que é um Evento?

Pense em um evento como um registro de uma ação que um usuário realiza no seu site ou aplicativo. É como anotar cada vez que alguém:
  • Visita uma página
  • Clica em um botão
  • Preenche um formulário
  • Inicia uma sessão
Cada uma dessas ações gera um “evento” que fica armazenado no nosso banco de dados.

Analogia com Formulários de Pesquisa

Imagine que você tem um caderno onde anota tudo que cada cliente faz na sua loja. Cada página visitada, cada clique, cada compra é anotada com:
  • Quem fez (identificador do usuário)
  • O que fez (tipo de ação)
  • Quando fez (data e hora)
  • Detalhes adicionais (mais informações sobre a ação)
O Synapside funciona exatamente assim, mas automaticamente!

Tipos de Eventos Coletados

O Synapside coleta automaticamente os seguintes tipos de eventos:

📄 Pageview (Visitação de Página)

Registrado sempre que um usuário visita uma página do seu site.
  • Informações coletadas: Qual página foi visitada, de onde veio (referrer), origem da campanha (utm_source, utm_medium, utm_campaign)
  • Exemplo: “João visitou a página de produtos às 14:30”

🔄 Session Start (Início de Sessão)

Registrado quando um usuário inicia uma nova sessão ou retorna ao seu site.
  • Informações coletadas: Tipo de dispositivo (mobile, desktop, tablet), origem do acesso, identificador da sessão
  • Exemplo: “Maria abriu o site no seu celular vindo do Google”

🖱️ Click (Clique)

Registrado quando um usuário clica em um elemento da página.
  • Informações coletadas: O que foi clicado (botão, link, imagem), classe ou ID do elemento
  • Exemplo: “Pedro clicou no botão ‘Comprar Agora’”

📝 Form Submit (Envio de Formulário)

Registrado quando um usuário envia um formulário.
  • Informações coletadas: Qual formulário foi enviado, quais campos foram preenchidos
  • Exemplo: “Ana preencheu e enviou o formulário de contato”

🎯 Eventos Personalizados

Além dos eventos automáticos, você pode criar eventos customizados para rastrear ações específicas do seu negócio.
  • Exemplo: “Usuário visualizou produto”, “Criou uma lista de desejos”, “Completou um onboarding”

Como Esses Dados Ajudam Seu Negócio

Todos esses eventos coletados permitem que você entenda melhor seus clientes:

🔍 Análise de Comportamento

  • Quais páginas são mais visitadas?
  • Por quanto tempo os usuários ficam no site?
  • Qual é o caminho típico de um cliente até a conversão?

📊 Otimização de Conversões

  • Onde os usuários abandonam o processo de compra?
  • Qual é a taxa de conversão de diferentes campanhas?
  • Que tipo de usuário tem maior probabilidade de converter?

🌍 Compreensão de Origem

  • De onde vêm meus usuários? (Google, redes sociais, email, etc)
  • Qual canal de marketing gera mais conversões?
  • Como diferentes campanhas (utm) performam?

📱 Insights por Dispositivo

  • Quantos visitantes usam mobile vs desktop?
  • Como a experiência difere entre dispositivos?

O que é User UUID?

O User UUID é um identificador único que o Synapside atribui a cada usuário do seu site. É como um número de cliente único que nunca muda.

Por que isso é importante?

Mesmo que um usuário:
  • Limpe seu navegador
  • Use um dispositivo diferente
  • Volte dias depois
O Synapside consegue rastrear que é a mesma pessoa! Isso é possível através do nosso sistema proprietário de identificação centralizada.

Cross-Domain Tracking

Se você tem múltiplos domínios (seu blog, sua loja online, seu app), o mesmo User UUID mantém a continuidade. Você pode ver a jornada completa de um usuário em todo o seu ecossistema.

Estrutura Geral dos Dados

Cada evento no Synapside contém:
  • Identificadores:
    • user_uuid: Quem fez a ação
    • event_uuid: ID único do evento
  • Tipo e Timestamp:
    • event_type: Que tipo de evento (pageview, click, etc)
    • event_ts: Quando aconteceu (data e hora exata)
  • Contexto:
    • data: Detalhes específicos do evento (pode variar conforme o tipo)
  • Registro:
    • recorded_at: Quando foi registrado no banco de dados

Próximos Passos

  • Técnicos: Acesse a Referência Técnica para detalhes sobre o schema PostgreSQL
  • Análises Práticas: Veja Exemplos de Uso para consultas e casos de uso reais
  • Metabase: Para análises avançadas sem escrever SQL, use a integração com Metabase disponível no painel

Dúvidas? A equipe de suporte e engenharia de dados do Synapside está pronta para ajudar!