CONVERSION - Rastreamento de Conversões

O que é este Node?

O CONVERSION é o node responsável por rastrear conversões e objetivos alcançados, como compras, cadastros, downloads ou qualquer ação de valor para o negócio.

Por que este Node existe?

Conversões são a métrica mais importante de sucesso. O CONVERSION existe para:

1. ROI Tracking: Medir retorno de campanhas
2. Goal Completion: Rastrear objetivos de negócio
3. Value Attribution: Atribuir valor monetário a ações
4. Optimization: Identificar o que gera mais conversões

Como funciona internamente?

Quando o CONVERSION é executado, o sistema:

1. Registra conversão: goalId, goalName, value, currency
2. Atribui valor: Valor monetário da conversão
3. Vincula campanha: Source, medium, campaign
4. Armazena: Salva evento com tipo 'conversion'

Código interno (analytics-executor.service.ts:427-448):

private async trackConversion(data: any, userId: string, sessionId: string, context: any): Promise<any> {
  const conversion = {
    type: 'conversion',
    goalId: data.goalId,
    goalName: data.goalName,
    value: data.value || 0,
    currency: data.currency || 'USD',
    category: data.category,
    userId: userId,
    sessionId: sessionId,
    timestamp: new Date().toISOString()
  };

  await this.storeTrackingEvent(conversion);

  return {
    success: true,
    action: 'conversion_tracked',
    data: conversion,
    timestamp: conversion.timestamp
  };
}

Quando você DEVE usar este Node?

Use CONVERSION para rastrear objetivos alcançados:

Casos de uso

1. E-commerce: Compra finalizada
2. Lead Gen: Formulário preenchido
3. SaaS: Trial iniciado, assinatura
4. Content: Download, inscrição newsletter

Parâmetros

Campo	Tipo	Obrigatório	Descrição
trackingType	string	Sim	"conversion"
data.goalId	string	Sim	ID único do objetivo
data.goalName	string	Sim	Nome do objetivo
data.value	number	Não	Valor monetário
data.currency	string	Não	Moeda (padrão: USD)

Exemplo: E-commerce Conversion

{
  "name": "Conversion - Purchase",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "tracking_1",
      "type": "tracking",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Track Purchase",
        "parameters": {
          "trackingType": "conversion",
          "data": {
            "goalId": "purchase",
            "goalName": "Compra Realizada",
            "value": 297.00,
            "currency": "BRL",
            "category": "ecommerce"
          }
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Success",
        "parameters": {
          "message": "✅ Compra de R$ 297 rastreada!"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "tracking_1" },
    { "source": "tracking_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Resposta do Node

{
  "success": true,
  "action": "conversion_tracked",
  "data": {
    "type": "conversion",
    "goalId": "purchase",
    "goalName": "Compra Realizada",
    "value": 297.00,
    "currency": "BRL",
    "category": "ecommerce",
    "userId": "user_123",
    "sessionId": "session_456",
    "timestamp": "2025-01-15T10:30:00.000Z"
  },
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Tipos Comuns de Conversão

Tipo	goalId	value
Purchase	purchase	Valor da compra
Signup	signup	Lifetime value estimado
Trial	trial_started	Valor da assinatura
Lead	lead_generated	Custo de aquisição
Download	download	Valor do conteúdo

Boas Práticas

✅ SIM: Atribua valor monetário sempre que possível ✅ SIM: Use goalId consistente cross-platform

❌ NÃO: Não rastreie micro-conversões como conversões principais

Dicas

💡 Dica 1: Calcule conversion rate = conversões / visitantes 💡 Dica 2: Vincule a campanhas para ROI tracking 💡 Dica 3: Use funn els para ver etapas antes da conversão

Próximo Node

→ FUNNEL - Análise de funil → RETENTION - Análise de retenção