HEAP - Auto-Capture Analytics

O que é este Node?

O HEAP é o node responsável por enviar eventos para o Heap, plataforma de analytics que captura automaticamente todas as interações do usuário sem necessidade de instrumentação manual.

Por que este Node existe?

Heap captura tudo automaticamente, eliminando tracking manual. O HEAP existe para:

1. Auto-capture: Captura todas as interações automaticamente
2. Retroactive Analysis: Analise eventos passados sem ter instrumentado
3. No-code Events: Defina eventos visualmente sem código
4. Complete Data: Zero chance de perder dados por falta de tracking

Como funciona internamente?

Quando o HEAP é executado, o sistema envia evento customizado para complementar auto-capture do Heap.

Código interno: Similar ao executeCustomAnalytics, enviando eventos via Heap Track API.

Quando você DEVE usar este Node?

Use HEAP sempre que precisar de captura automática completa:

Casos de uso

1. No-code Analytics: Time não-técnico pode criar eventos
2. Retroactive Analysis: Analisar comportamento passado
3. Complete Tracking: Capturar tudo sem instrumentação
4. Session Replay: Replay integrado com events

Quando NÃO usar HEAP

• Backend Events: Use CUSTOM_EVENT
• Custo: Heap é caro para alto volume
• Privacy: Auto-capture pode capturar dados sensíveis

Parâmetros

Campo	Tipo	Obrigatório	Descrição
provider	string	Sim	"heap" para Heap Analytics
eventName	string	Sim	Nome do evento customizado
properties	object	Não	Propriedades adicionais
userId	string	Não	User identity

Configuração

HEAP_APP_ID=seu_app_id_aqui

Exemplo: Custom Event no Heap

{
  "name": "Heap - Custom Event",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "analytics_1",
      "type": "analytics",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Track Backend Event",
        "parameters": {
          "provider": "heap",
          "eventName": "Purchase Completed",
          "properties": {
            "order_id": "ORD123",
            "amount": 297.00,
            "payment_method": "credit_card"
          }
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "✅ Evento enviado ao Heap!"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "analytics_1" },
    { "source": "analytics_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Boas Práticas

✅ SIM: - Use Heap para frontend auto-capture - Envie backend events via este node - Configure event visualizations no Heap UI - Use session replay para debugging

❌ NÃO: - Não confie apenas em auto-capture para eventos críticos - Não capture dados sensíveis automaticamente

Dicas

💡 Dica 1: Heap captura tudo - use retroactive analysis 💡 Dica 2: Defina eventos visualmente sem código 💡 Dica 3: Session replay mostra exatamente o que usuário fez

Próximo Node

→ HOTJAR - Heatmaps e session recordings → FULLSTORY - Session replay avançado