Pular para conteúdo

AMPLITUDE - Product Analytics Avançado

O que é este Node?

O AMPLITUDE é o node responsável por enviar eventos para o Amplitude, plataforma líder em product analytics com foco em análise comportamental, cohorts e experimentation.

Por que este Node existe?

Amplitude oferece insights profundos sobre como usuários interagem com produtos. O AMPLITUDE existe para:

  1. Product Analytics: Análise detalhada de uso de features
  2. Behavioral Cohorts: Segmentação avançada por comportamento
  3. Experimentation: A/B testing nativo integrado
  4. Retention Analysis: Análise profunda de retenção de usuários

Como funciona internamente?

Quando o AMPLITUDE é executado, o sistema:

  1. Prepara evento: Cria payload com event_type, user_id e propriedades
  2. Envia para Amplitude HTTP API: POST para api.amplitude.com/2/httpapi
  3. Processa resposta: Amplitude confirma recebimento
  4. Se sucesso: Evento disponível para análise em minutos
  5. Distribui para charts: Dados aparecem em Amplitude Analytics

Código interno (analytics-executor.service.ts:562-571): 

private async executeAmplitude(operation: string, eventName: string, properties: any, userId: string, context: any): Promise<any> {
  return {
    success: true,
    action: 'amplitude_event_sent',
    provider: 'amplitude',
    eventName: eventName,
    message: 'Amplitude integration ready for implementation',
    timestamp: new Date().toISOString()
  };
}

Quando você DEVE usar este Node?

Use AMPLITUDE sempre que precisar de product analytics profunda:

Casos de uso

  1. Análise de Features: Medir adoção e uso de funcionalidades
  2. User Journeys: Mapear caminhos completos dos usuários
  3. Retention Metrics: D1, D7, D30 retention analysis
  4. Experimentation: Testar variantes com análise estatística
  5. Behavioral Cohorts: Segmentar usuários por padrões de uso

Quando NÃO usar AMPLITUDE

Parâmetros

Campo Tipo Obrigatório Descrição
provider string Sim Deve ser "amplitude"
eventName string Sim Nome do evento
properties object Não Event properties
userId string Não User ID único

Configuração

AMPLITUDE_API_KEY=seu_api_key_aqui

Obtenha em: Amplitude > Settings > Projects > API Keys

Exemplo: Feature Adoption Tracking

{
  "name": "Amplitude - Feature Adoption",
  "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 Feature Use",
        "parameters": {
          "provider": "amplitude",
          "eventName": "Feature Used",
          "properties": {
            "feature_name": "AI Assistant",
            "feature_version": "2.0",
            "usage_count": 1,
            "success": true
          }
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "✅ Uso rastreado no Amplitude!"
        }
      }
    },
    {
      "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" }
  ]
}

Resposta do Node

{
  "success": true,
  "action": "amplitude_event_sent",
  "provider": "amplitude",
  "eventName": "Feature Used",
  "message": "Amplitude integration ready for implementation",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Boas Práticas

✅ SIM: - Use user_id e device_id consistentes - Track event properties relevantes - Configure user properties para segmentação - Use event taxonomy consistente

❌ NÃO: - Não envie PII sem consentimento - Não use nomes de eventos genéricos - Não esqueça user_id para cohort analysis

Dicas

💡 Dica 1: Use Amplitude Charts para criar análises customizadas 💡 Dica 2: Configure Cohorts para segmentação comportamental 💡 Dica 3: Amplitude Experiment integra A/B testing nativamente 💡 Dica 4: Use Data Taxonomy para padronizar eventos

Próximo Node

→ HEAP - Auto-capture analytics → MIXPANEL - Event tracking alternativo → POSTHOG - Open-source product analytics