Eventos Customizados¶

Lista completa de eventos padrão do Facebook Pixel que você pode usar com o Complyr para rastrear conversões e otimizar campanhas no Facebook Ads.

📋 Visão Geral¶

O Facebook Pixel suporta 17 eventos padrão (Standard Events) e eventos customizados ilimitados. Todos os eventos respeitam automaticamente o consentimento gerenciado pelo Complyr.

Categorias de Eventos: - E-commerce (9 eventos): Jornada de compra completa - Lead Generation (3 eventos): Captação e conversão de leads - Engajamento (5 eventos): Interação com conteúdo

Todos os eventos disparam apenas COM consentimento de marketing.

🛒 Eventos de E-commerce¶

1. ViewContent¶

Quando usar: Usuário visualiza uma página de produto.

Parâmetros:

fbq('track', 'ViewContent', {
  content_name: 'Nome do Produto',          // Nome legível
  content_ids: ['produto-123'],             // Array de IDs (SKU)
  content_type: 'product',                  // 'product' ou 'product_group'
  content_category: 'Eletrônicos/Celulares', // Categoria do produto
  value: 999.90,                             // Valor em reais
  currency: 'BRL'                            // Moeda (ISO 4217)
});

Caso de uso: - Remarketing de produtos visualizados - Criação de audiências de produtos específicos - Otimização de catálogos dinâmicos

2. AddToCart¶

Quando usar: Usuário adiciona produto ao carrinho.

Parâmetros:

fbq('track', 'AddToCart', {
  content_name: 'Smartphone XYZ',
  content_ids: ['smartphone-xyz-123'],
  content_type: 'product',
  value: 1499.90,
  currency: 'BRL'
});

Caso de uso: - Criar audiências de "carrinhos abandonados" - Remarketing agressivo para quem adicionou mas não comprou - Otimizar campanhas para evento AddToCart

Remarketing Inteligente

Use este evento para criar funil de remarketing: Visitantes → AddToCart → Purchase

3. InitiateCheckout¶

Quando usar: Usuário inicia o processo de checkout.

Parâmetros:

fbq('track', 'InitiateCheckout', {
  content_ids: ['produto-123', 'produto-456'],  // Array de produtos
  contents: [                                    // Detalhes completos
    {id: 'produto-123', quantity: 2, price: 99.90},
    {id: 'produto-456', quantity: 1, price: 199.90}
  ],
  content_type: 'product',
  num_items: 3,                                  // Total de itens
  value: 399.70,                                 // Valor total
  currency: 'BRL'
});

Caso de uso: - Medir taxa de abandono no checkout - Remarketing para carrinhos abandonados no checkout - Otimizar campanhas para conversões

4. AddPaymentInfo¶

Quando usar: Usuário adiciona informações de pagamento.

Parâmetros:

fbq('track', 'AddPaymentInfo', {
  content_category: 'Eletrônicos',
  content_ids: ['produto-123'],
  value: 999.90,
  currency: 'BRL'
});

Caso de uso: - Identificar ponto de abandono (entre InitiateCheckout e Purchase) - Otimização de página de pagamento - Remarketing para usuários que chegaram até esta etapa

5. Purchase¶

Quando usar: Compra finalizada com sucesso.

Parâmetros:

fbq('track', 'Purchase', {
  content_ids: ['produto-123', 'produto-456'],
  content_type: 'product',
  contents: [
    {id: 'produto-123', quantity: 2, price: 99.90},
    {id: 'produto-456', quantity: 1, price: 199.90}
  ],
  num_items: 3,
  value: 399.70,                    // Valor TOTAL da compra
  currency: 'BRL',
  order_id: 'pedido-2025-001'       // ID único do pedido
});

Caso de uso: - Rastrear conversões e ROAS (Return on Ad Spend) - Criar audiências de compradores (para upsell/cross-sell) - Otimizar campanhas para conversão

Deduplicação

Sempre envie order_id para evitar contar a mesma compra múltiplas vezes (ex: usuário recarrega página de confirmação).

6. AddToWishlist¶

Quando usar: Usuário adiciona produto à lista de desejos.

Parâmetros:

fbq('track', 'AddToWishlist', {
  content_name: 'Notebook Gamer',
  content_ids: ['notebook-gamer-123'],
  content_category: 'Eletrônicos/Notebooks',
  value: 4999.90,
  currency: 'BRL'
});

Caso de uso: - Remarketing de produtos desejados - Notificações de desconto (via email + remarketing) - Criar audiências de alta intenção de compra

7. Search¶

Quando usar: Usuário faz busca no site.

Parâmetros:

fbq('track', 'Search', {
  search_string: 'smartphone samsung',    // Termo de busca
  content_category: 'Eletrônicos',
  content_ids: ['resultado-1', 'resultado-2']  // IDs dos resultados
});

Caso de uso: - Entender intenção de compra do usuário - Criar audiências baseadas em busca - Otimizar catálogo de produtos

8. ViewCategory (Não Padrão)¶

Quando usar: Usuário visualiza categoria de produtos.

Parâmetros:

fbq('trackCustom', 'ViewCategory', {
  content_category: 'Eletrônicos/Smartphones',
  content_ids: ['cat-123']
});

Evento Customizado

Este não é um Standard Event. Use trackCustom em vez de track.

Quando usar: Usuário faz assinatura (SaaS, newsletter, etc).

Parâmetros:

fbq('track', 'Subscribe', {
  value: 49.90,           // Valor mensal/anual
  currency: 'BRL',
  predicted_ltv: 599.00   // Lifetime Value previsto
});

Caso de uso: - Rastrear conversões de planos pagos - Criar lookalike audiences de assinantes - Medir custo por aquisição (CPA)

📝 Eventos de Lead Generation¶

10. Lead¶

Quando usar: Usuário envia formulário de lead (contato, orçamento, demo).

Parâmetros:

fbq('track', 'Lead', {
  content_name: 'Formulário de Contato',
  content_category: 'Leads/Contato',
  value: 100.00,          // Valor estimado do lead
  currency: 'BRL'
});

Caso de uso: - Otimizar campanhas para geração de leads - Medir custo por lead (CPL) - Criar audiências de leads qualificados

11. CompleteRegistration¶

Quando usar: Usuário completa cadastro no site/app.

Parâmetros:

fbq('track', 'CompleteRegistration', {
  content_name: 'Cadastro Completo',
  status: 'registered',            // Status do registro
  value: 50.00,                     // Valor estimado
  currency: 'BRL'
});

Caso de uso: - Rastrear criação de contas - Otimizar funil de cadastro - Criar audiências de usuários registrados

12. Contact¶

Quando usar: Usuário entra em contato (telefone, chat, formulário).

Parâmetros:

fbq('track', 'Contact', {
  content_name: 'Chat Online',
  content_category: 'Suporte'
});

Caso de uso: - Medir engajamento com suporte - Criar audiências de usuários engajados - Otimizar canais de contato

📱 Eventos de Engajamento¶

13. PageView (Automático)¶

Quando usar: Carregamento de qualquer página.

Parâmetros:

// Disparado automaticamente por fbq('track', 'PageView')
// Sem parâmetros adicionais necessários

Caso de uso: - Rastreamento básico de tráfego - Criação de audiências de visitantes - Pixel Health check

Automático

Se você configurou o Pixel corretamente, este evento dispara automaticamente.

14. ViewContent (Conteúdo Não-Produto)¶

Quando usar: Visualização de artigo, vídeo, página informativa.

Parâmetros:

fbq('track', 'ViewContent', {
  content_name: 'Artigo: Como Escolher Smartphone',
  content_type: 'article',           // Não é 'product'
  content_category: 'Blog/Tecnologia'
});

Caso de uso: - Remarketing de conteúdo - Criar audiências engajadas - Medir engajamento com blog

15. CustomizeProduct¶

Quando usar: Usuário personaliza produto (cores, tamanhos, gravação).

Parâmetros:

fbq('track', 'CustomizeProduct', {
  content_name: 'Camiseta Personalizada',
  content_ids: ['camiseta-123'],
  customization_type: 'color',      // Tipo de customização
  value: 79.90,
  currency: 'BRL'
});

Caso de uso: - Medir engajamento com ferramentas de customização - Criar audiências de alta intenção

16. Donate¶

Quando usar: Usuário faz doação (ONGs, crowdfunding).

Parâmetros:

fbq('track', 'Donate', {
  value: 100.00,
  currency: 'BRL',
  content_name: 'Doação Mensal'
});

17. FindLocation¶

Quando usar: Usuário busca localização de loja física.

Parâmetros:

fbq('track', 'FindLocation', {
  content_category: 'Lojas/São Paulo',
  search_string: 'Loja Shopping Morumbi'
});

Caso de uso: - Rastrear interesse em lojas físicas - Otimizar campanhas de visitas à loja

🎨 Eventos Customizados (Custom Events)¶

Use trackCustom para eventos específicos do seu negócio:

Download de Material¶

fbq('trackCustom', 'DownloadEbook', {
  content_name: 'E-book: Guia de Marketing Digital 2025',
  content_category: 'Materiais Ricos'
});

Agendamento de Demo¶

fbq('trackCustom', 'ScheduleDemo', {
  demo_type: 'online',
  scheduled_date: '2025-11-05'
});

Início de Trial¶

fbq('trackCustom', 'StartTrial', {
  plan: 'professional',
  trial_duration_days: 14,
  value: 0  // Trial gratuito
});

Upgrade de Plano¶

fbq('trackCustom', 'UpgradePlan', {
  old_plan: 'starter',
  new_plan: 'professional',
  value: 199.90,
  currency: 'BRL'
});

📊 Parâmetros Importantes¶

Obrigatórios vs Opcionais¶

Parâmetro	Obrigatório	Descrição	Tipo
`value`	⚠️ Recomendado	Valor monetário	Number
`currency`	⚠️ Recomendado	Código ISO da moeda	String ('BRL')
`content_ids`	⚠️ Recomendado	IDs dos produtos/conteúdos	Array
`content_name`	❌ Opcional	Nome legível	String
`content_category`	❌ Opcional	Categoria do produto	String
`content_type`	❌ Opcional	Tipo de conteúdo	String ('product', 'article')

Value e Currency

Sempre envie value e currency juntos. Sem eles, o Facebook não pode calcular ROAS.

🔗 Integração com Complyr¶

Identificação de Usuários¶

Combine eventos customizados com identificação via Complyr:

// Após login
window.complyr.identify('email', 'usuario@example.com');

// Eventos subsequentes incluem identificação automaticamente
fbq('track', 'Purchase', {
  value: 399.90,
  currency: 'BRL'
});
// Email hasheado (SHA-256) enviado automaticamente via Advanced Matching

Respeitando Consentimento¶

Todos os eventos do Pixel são automaticamente bloqueados/liberados pelo Complyr:

// SEM consentimento de marketing
fbq('track', 'AddToCart', {...});
// → Complyr bloqueia, evento NÃO enviado

// COM consentimento de marketing
fbq('track', 'AddToCart', {...});
// → Complyr permite, evento enviado ao Facebook

🎯 Casos de Uso Avançados¶

Funil Completo de E-commerce¶

// 1. Página de produto
fbq('track', 'ViewContent', {
  content_ids: ['produto-123'],
  value: 99.90,
  currency: 'BRL'
});

// 2. Adicionar ao carrinho
fbq('track', 'AddToCart', {
  content_ids: ['produto-123'],
  value: 99.90,
  currency: 'BRL'
});

// 3. Iniciar checkout
fbq('track', 'InitiateCheckout', {
  content_ids: ['produto-123'],
  value: 99.90,
  currency: 'BRL'
});

// 4. Adicionar pagamento
fbq('track', 'AddPaymentInfo', {
  content_ids: ['produto-123'],
  value: 99.90,
  currency: 'BRL'
});

// 5. Compra finalizada
fbq('track', 'Purchase', {
  content_ids: ['produto-123'],
  value: 99.90,
  currency: 'BRL',
  order_id: 'pedido-001'
});

Resultado: Funil completo rastreado para otimização de campanhas.

SaaS: Da Visita ao Pagamento¶

// 1. Página de preços
fbq('track', 'ViewContent', {
  content_name: 'Pricing Page',
  content_category: 'SaaS/Pricing'
});

// 2. Iniciar trial
fbq('trackCustom', 'StartTrial', {
  plan: 'professional',
  value: 0
});

// 3. Cadastro completo
fbq('track', 'CompleteRegistration');

// 4. Upgrade para pago
fbq('track', 'Subscribe', {
  value: 199.90,
  currency: 'BRL',
  predicted_ltv: 2398.80  // 12 meses
});

🧪 Testando Eventos¶

Facebook Pixel Helper¶

Instale Facebook Pixel Helper
Navegue pelo site e dispare eventos
Extensão mostra eventos em tempo real

Validação: - ✅ Nome do evento correto - ✅ Parâmetros enviados - ✅ Valores monetários corretos

Events Manager¶

Acesse Facebook Events Manager
Selecione seu Pixel
Vá em "Testar Eventos"
Digite URL do site e navegue
Eventos aparecem em tempo real

Validação: - ✅ Eventos chegando ao Facebook - ✅ Match Quality Score (precisão de dados) - ✅ Deduplicação funcionando

📈 Otimização de Campanhas¶

Usar Eventos como Objetivos¶

No Facebook Ads Manager, você pode otimizar campanhas para eventos específicos:

Tráfego: Otimizar para PageView
Engajamento: Otimizar para ViewContent
Leads: Otimizar para Lead, CompleteRegistration
Conversões: Otimizar para AddToCart, Purchase

Criar Audiências Personalizadas¶

Com eventos do Pixel, você pode criar audiências:

Visitantes que viram produto mas não compraram
Usuários que adicionaram ao carrinho nos últimos 7 dias
Compradores dos últimos 30 dias (para upsell)
Usuários que gastaram > R$ 500 (high-value)

🔗 Próximos Passos¶

Advanced Matching - Identifique usuários autenticados
Solução de Problemas - Eventos não disparando
Gerenciamento de Consentimento - Como funciona o bloqueio
Configuração - Revise o setup inicial

📞 Suporte¶

Precisa de ajuda com eventos?

FAQ - Perguntas frequentes
Documentação Facebook - Referência oficial
Email: contato@complyr.com.br

Eventos Customizados¶

📋 Visão Geral¶

🛒 Eventos de E-commerce¶

1. ViewContent¶

2. AddToCart¶

3. InitiateCheckout¶

4. AddPaymentInfo¶

5. Purchase¶

6. AddToWishlist¶

7. Search¶

8. ViewCategory (Não Padrão)¶

9. Subscribe¶

📝 Eventos de Lead Generation¶

10. Lead¶

11. CompleteRegistration¶

12. Contact¶

📱 Eventos de Engajamento¶

13. PageView (Automático)¶

14. ViewContent (Conteúdo Não-Produto)¶

15. CustomizeProduct¶

16. Donate¶

17. FindLocation¶

🎨 Eventos Customizados (Custom Events)¶

Download de Material¶

Agendamento de Demo¶

Início de Trial¶

Upgrade de Plano¶

📊 Parâmetros Importantes¶

Obrigatórios vs Opcionais¶

🔗 Integração com Complyr¶

Identificação de Usuários¶

Respeitando Consentimento¶

🎯 Casos de Uso Avançados¶

Funil Completo de E-commerce¶

SaaS: Da Visita ao Pagamento¶

🧪 Testando Eventos¶

Facebook Pixel Helper¶

Events Manager¶

📈 Otimização de Campanhas¶

Usar Eventos como Objetivos¶

Criar Audiências Personalizadas¶

🔗 Próximos Passos¶

📞 Suporte¶