Eventos
Eventos sao acoes que seus usuarios realizam e que voce deseja rastrear. Eles sao a base para segmentacao, gatilhos de jornadas e analise de comportamento.
O que e um Evento?
Um evento representa uma acao especifica do usuario no seu produto ou site:
Evento: "Compra Realizada"
├── Propriedades:
│ ├── productId: "SKU-12345"
│ ├── productName: "Camiseta Azul"
│ ├── value: 79.90
│ ├── category: "vestuario"
│ └── paymentMethod: "cartao"
├── Usuario: maria@email.com
└── Timestamp: 2024-01-15T14:30:00Z
Tipos de Eventos
Eventos de Negocio
Acoes relacionadas ao seu negocio:
- Cadastro realizado
- Compra concluida
- Assinatura criada
- Plano atualizado
- Cancelamento solicitado
Eventos de Engajamento
Interacoes com seu produto:
- Pagina visitada
- Botao clicado
- Video assistido
- Arquivo baixado
- Formulario preenchido
Eventos de Sistema
Gerados automaticamente pelo NotifyChain:
- Email enviado
- Email aberto
- Email clicado
- Push recebido
- Campanha entregue
Estrutura de um Evento
Nome do Evento
Identificador unico e descritivo:
✅ Bons nomes:
- "Compra Realizada"
- "Cadastro Concluido"
- "Carrinho Abandonado"
❌ Nomes ruins:
- "evento1"
- "click"
- "acao"
Propriedades
Dados adicionais sobre o evento:
| Propriedade | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
| productId | string | Sim | ID do produto |
| value | number | Sim | Valor em reais |
| category | string | Nao | Categoria |
| quantity | number | Nao | Quantidade |
Metadados
Informacoes automaticas:
- timestamp: Data/hora do evento
- userId: Identificador do usuario
- sessionId: Sessao do usuario
- source: Origem (web, mobile, api)
Usos de Eventos
Gatilhos de Jornadas
Inicie jornadas quando eventos ocorrem:
Quando: "Carrinho Abandonado"
Entao: Iniciar jornada de recuperacao
Segmentacao
Crie audiencias baseadas em eventos:
Usuarios que:
- Realizaram "Compra" nos ultimos 30 dias
- Com valor > R$ 200
Metas de Conversao
Meca sucesso de campanhas:
Campanha: Promocao Black Friday
Meta: Evento "Compra Realizada"
Janela: 7 dias
Analytics
Analise comportamento:
- Funis de conversao
- Retencao de usuarios
- Padroes de uso
Fluxo de Eventos
1. Usuario realiza acao
↓
2. Tracker captura evento
↓
3. Evento enviado para NotifyChain
↓
4. Processamento em tempo real
↓
5. Acoes disparadas:
- Jornadas iniciadas
- Segmentos atualizados
- Dados armazenados
Destinos de Eventos
Configure para onde os eventos sao enviados:
| Destino | Descricao |
|---|---|
| NotifyChain | Processamento interno (padrao) |
| Google Analytics | Analytics web |
| Mixpanel | Analytics de produto |
| Webhook | Seu servidor customizado |
Boas Praticas
Nomenclatura
Use um padrao consistente:
[Objeto] + [Acao no Passado]
Exemplos:
- Compra Realizada
- Usuario Cadastrado
- Pagina Visitada
- Email Clicado
Propriedades
- Defina propriedades obrigatorias vs opcionais
- Use tipos corretos (string, number, boolean)
- Mantenha nomes em camelCase
- Documente cada propriedade
Granularidade
Encontre o equilibrio:
✅ Granularidade adequada:
- "Produto Adicionado ao Carrinho"
- "Checkout Iniciado"
- "Pagamento Concluido"
❌ Muito generico:
- "Clique" (sem contexto)
❌ Muito especifico:
- "Botao Azul Clicado na Pagina X"
Crie um plano de rastreamento antes de implementar. Defina quais eventos sao importantes para seu negocio.
Eventos geram custo de processamento e armazenamento. Rastreie apenas o que for usar.