Atribuição de Receita

Recurso Pro

Conecte o comportamento do visitante à receita real. Veja quais páginas, campanhas e fontes de tráfego geram vendas ao integrar com seu provedor de pagamento.

---

Visão Geral

Atribuição de receita fecha o ciclo entre marketing e vendas. Em vez de adivinhar quais atividades geram receita, veja os números reais:

• Receita por fonte: Quais canais geram mais receita
• Receita por página: Qual conteúdo leva a compras
• Receita por campanha: Quais campanhas têm ROI positivo
• Jornada do cliente: Qual caminho leva à conversão

---

Integrações Suportadas

Stripe

Integração nativa com Stripe para rastreamento automático de receita.

Configuração:

1. Abra Domínios → seu site → guia Receita → Integrações → Stripe
2. Clique em Conectar Conta Stripe
3. Autorize a conexão
4. Os dados de receita são sincronizados automaticamente

Dados capturados:

• Valores de transações
• E-mails de clientes (para correspondência de jornada)
• Eventos de assinatura (nova, renovação, cancelamento)
• Status de pagamento (bem-sucedido, falho, reembolsado)

Lemon Squeezy

Integração nativa com Lemon Squeezy para negócios indie e SaaS.

Configuração:

1. Abra Domínios → seu site → guia Receita → Integrações → Lemon Squeezy
2. Insira sua chave de API do Lemon Squeezy
3. Configure o segredo de assinatura do webhook
4. Os dados de receita são sincronizados automaticamente

Polar

Integração nativa com Polar para monetização de código aberto e criadores.

Configuração:

1. Abra Domínios → seu site → guia Receita → Integrações → Polar
2. Insira sua chave de API do Polar
3. Configure o segredo de assinatura do webhook
4. Os dados de receita são sincronizados automaticamente

PayPal

Integração nativa com PayPal Checkout para pagamentos únicos. Modos Sandbox e Live são suportados.

Configuração:

1. Crie um app de API REST em PayPal Developer
2. Crie um webhook no PayPal apontando para https://api.zenovay.com/webhooks/paypal/YOUR_WEBSITE_ID
3. Inscreva-se em PAYMENT.CAPTURE.COMPLETED e PAYMENT.CAPTURE.REFUNDED
4. No Zenovay, abra Domínios → seu site → guia Receita → Integrações → PayPal e cole:
   • Client ID, Client Secret (do seu app do PayPal)
   • Webhook ID (do webhook que você acabou de criar)
   • Escolha Sandbox ou Live para corresponder ao seu app do PayPal
5. Salve — o Zenovay valida as credenciais buscando um token de acesso OAuth2

Para melhor precisão de atribuição, defina purchase_units[0].custom_id = visitor_id ao criar o pedido do PayPal no seu servidor. Consulte o guia de integração do PayPal para instruções completas.

O suporte a assinatura ainda não está disponível — apenas capturas únicas são rastreadas na V1.

Paddle

Integração nativa com Paddle Billing (v2) para empresas SaaS que usam Paddle como intermediário de pagamento (lida com IVA da UE e impostos de vendas globais). Modos Sandbox e Live são suportados.

Você só precisa de UMA coisa: uma chave de API do Paddle com permissão de Escrita. O Zenovay cria o destino do webhook em seu nome via API do Paddle, captura o segredo de assinatura automaticamente e armazena ambos criptografados. Você nunca toca no painel de Notificações do Paddle.

Configuração (2 minutos):

1. No Paddle → Developer tools → Authentication → New API key → permissão Write → copie a chave (começa com pdl_live_apikey_ ou pdl_sdbx_apikey_).
2. No Zenovay, abra Domínios → seu site → guia Receita → Integrações → Paddle → cole a chave. Sandbox vs Live é detectado automaticamente pelo prefixo.
3. Clique em Connect. Pronto.

O que acontece nos bastidores:

• O Zenovay valida a chave contra /event-types.
• Chama POST /notification-settings em seu nome — URL https://api.zenovay.com/api/webhooks/paddle/<your-website-id>, inscrito em transaction.completed + 3 eventos de assinatura.
• Captura endpoint_secret_key da resposta do Paddle e o armazena criptografado.

Por que você nunca vê um campo "signing secret" no caminho feliz: O Paddle oculta deliberadamente o segredo de assinatura em seu painel após a criação (sem botão "revelar", apenas "Rotar Segredo"). O Zenovay usa a API do Paddle para buscar o segredo diretamente — o único caminho programático documentado. Consulte o artigo do centro de ajuda para a explicação completa.

Dados capturados:

• Valores de transações (moedas incluindo JPY/KRW sem decimais manipuladas corretamente por ISO 4217)
• E-mails de clientes quando presentes no evento (para correspondência visitante → receita)
• Ciclo de vida da assinatura: criada, atualizada, cancelada (mapeia para subscription_status do Zenovay)
• Status de pagamento

Eventos de reembolso (adjustment.*) e ramos de assinatura pausados/vencidos ainda não são renderizados na V1 — o Zenovay os ignora silenciosamente.

Consulte o guia de integração do Paddle para solução de problemas e o fallback de configuração manual (raramente necessário).

Webhooks Personalizados

Para qualquer outro provedor de pagamento, use webhooks:

Endpoint Webhook:

POST https://api.zenovay.com/webhooks/revenue

Payload:

{
  "api_key": "YOUR_API_KEY",
  "website_id": "YOUR_WEBSITE_ID",
  "event": "purchase",
  "data": {
    "transaction_id": "txn_123",
    "amount": 99.00,
    "currency": "USD",
    "customer_email": "[email protected]",
    "product_name": "Pro Plan",
    "metadata": {
      "plan": "annual",
      "coupon": "LAUNCH20"
    }
  }
}

---

Painel de Receita

Métricas de Visão Geral

Receita por Fonte

Veja quais fontes de tráfego geram mais receita:

• Tráfego direto
• Busca orgânica
• Busca paga
• Redes sociais
• Referências
• Campanhas de e-mail
• Campanhas com tags UTM

Receita por Página

Identifique conteúdo de alto desempenho:

• Páginas de destino que levam a compras
• Posts de blog que influenciam decisões de compra
• Desempenho da página de preços
• Páginas de recursos que convertem

---

Modelos de Atribuição

Último Toque (Padrão)

Credita 100% da receita à última página/fonte antes da conversão.

Melhor para: Entender os gatilhos finais de conversão

Primeiro Toque

Credita 100% da receita à primeira página/fonte na jornada do cliente.

Melhor para: Entender canais de aquisição

Linear

Distribui a receita igualmente entre todos os pontos de contato na jornada.

Melhor para: Entender a contribuição da jornada completa

Decaimento de Tempo

Credita mais receita aos pontos de contato mais próximos da conversão.

Melhor para: Visão equilibrada com foco em conversão

---

Rastreamento de Jornada do Cliente

Conecte sessões de visitantes anônimos a clientes que pagam:

Como Funciona

1. Rastreamento anônimo: Visitante navega pelo seu site
2. Revelação de identidade: Visitante submete e-mail (inscrição, checkout, formulário)
3. Evento de compra: Pagamento recebido via webhook
4. Conexão de jornada: Todas as sessões anteriores vinculadas ao cliente

Visualização de Jornada

Para cada cliente, veja:

• Data e fonte da primeira visita
• Todas as páginas visualizadas nas sessões
• Tempo da primeira visita até a compra
• Total de sessões antes da conversão
• Conteúdo que influenciou a compra

---

Configuração do Rastreamento de Receita

Etapa 1: Conectar Provedor de Pagamento

Consulte Integrações Suportadas acima.

Etapa 2: Ativar Rastreamento de Identidade

Certifique-se de que a identificação do visitante está configurada:

// Quando o usuário fornece e-mail (formulário, inscrição, checkout)
window.zenovay('identify', 'user_123', {
  email: '[email protected]'
});

Etapa 3: Verificar Fluxo de Dados

1. Faça uma compra de teste
2. Verifique o painel Receita
3. Verifique se a transação aparece com o valor correto
4. Confirme se a jornada do cliente está vinculada

---

Alertas de Receita

Receba notificações sobre eventos de receita:

Resumo Diário de Receita

{
  "alert": "daily_revenue_summary",
  "schedule": "0 9 * * *",
  "channel": "email",
  "recipients": ["[email protected]"]
}

Marcos de Receita

{
  "alert": "revenue_milestone",
  "threshold": 10000,
  "period": "month",
  "channel": "slack"
}

Pagamentos Falhados

{
  "alert": "payment_failed",
  "notify_immediately": true,
  "channel": "email"
}

---

Acesso à API

Acesse dados de receita de forma programática:

Resumo de Receita

GET /api/websites/:websiteId/revenue/summary
  ?start_date=2025-01-01
  &end_date=2025-12-31
Authorization: Bearer YOUR_API_KEY

Receita por Fonte

GET /api/websites/:websiteId/revenue/by-source
  ?period=last_30_days
Authorization: Bearer YOUR_API_KEY

Jornadas de Clientes

GET /api/websites/:websiteId/revenue/journeys
  ?limit=100
Authorization: Bearer YOUR_API_KEY

---

Privacidade e Segurança

Manipulação de Dados

• Dados de transação criptografados em repouso
• E-mails de clientes hash para correspondência
• Nenhum número de cartão de crédito armazenado
• Dados de cartão são manipulados inteiramente pelo seu provedor de pagamento — o Zenovay nunca recebe números de cartão (escopo de PCI tratado pelo Stripe, Paddle, PayPal, etc.)

Controle de Acesso

• Dados de receita visíveis para funções de Admin e Owner
• Função de Viewer vê apenas dados agregados
• O acesso à API requer escopos apropriados

---

Melhores Práticas

1. Conecte o provedor de pagamento primeiro: Os dados de receita são fundamentais
2. Implemente rastreamento de identidade: Vincula visitantes anônimos a clientes que pagam
3. Marque campanhas consistentemente: Use parâmetros UTM para atribuição
4. Revise o modelo de atribuição: Escolha o modelo que se adequa ao seu ciclo de vendas
5. Configure alertas: Saiba quando os marcos de receita são atingidos

---

Próximos Passos

• Eventos Personalizados - Rastreie ações relacionadas a receita
• Objetivos - Configure objetivos de conversão
• Inteligência B2B - Conecte visitas de empresas à receita

---

Ferramentas gratuitas relacionadas

Tags UTM consistentes são a base para a atribuição de campanhas funcionar. Crie-as com nosso Gerador de UTM gratuito e depois acompanhe essas campanhas no seu painel da Zenovay.