> ## Documentation Index
> Fetch the complete documentation index at: https://docs.analytics.synapside.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral

Bem-vindo! Este guia foi criado para explicar como o Synapside Analytics 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 S.Analytics 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 S.Analytics 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](/estrutura-de-dados/referencia-tecnica) para detalhes sobre o schema PostgreSQL
* **Análises Práticas:** Veja [Exemplos de Uso](/estrutura-de-dados/exemplos-uso) para consultas e casos de uso reais
* **Painel:** Para análises avançadas sem escrever SQL, use a integração com Metabase disponível no [painel](/painel/crie-seu-painel).