Para rastrear vendas da Ephra no Meta Ads, você precisa de duas frentes que não se confundem: o pixel da Meta com o token da API de Conversões, cadastrado na área de rastreamento da Ephra, para a Meta otimizar a entrega; e os webhooks de transação (criada, paga, reembolsada) enviados a uma ferramenta que ligue cada venda ao anúncio e ao lucro. A primeira frente faz a campanha aprender. A segunda diz se ela dá dinheiro. Em checkouts com Pix forte, order bump e upsell de 1 clique, como é o caso da Ephra, essas duas leituras costumam divergir bastante.
A Ephra se apresenta como um ecossistema de vendas para o digital: checkout com order bump em pop-up, upsell de 1 clique, teste A/B de checkout, mapa de calor e roteamento de Pix entre instituições, segundo a página oficial da Ephra. Cada um desses recursos aumenta o ticket ou a aprovação. E cada um cria uma pergunta de rastreamento que o Ads Manager não responde sozinho.
O que a documentação da Ephra mostra sobre rastreamento
A Ephra mantém uma documentação pública para desenvolvedores. Ela é voltada à API, mas descreve bem como pixel, checkout e webhooks funcionam por dentro. Os pontos que importam para quem anuncia:
Pixel com token da API de Conversões
Pelo guia de checkout da Ephra, o pixel é cadastrado com o código do pixel e, opcionalmente, o token da API de Conversões da Meta e um código de evento de teste. O pixel fica ligado a um produto e pode ser vinculado a um checkout específico. A referência da API cita provedores como Meta, Google Ads, TikTok e Google Tag Manager, e informa que a lista é a mesma que alimenta o seletor da tela de rastreamento do painel.
O token nunca é devolvido depois de salvo: a Ephra só confirma que ele existe. Se você não lembra qual token está em qual pixel, o caminho é gerar outro no Gerenciador de Eventos e substituir.
A opção de marcar conversão no Pix gerado
Este é o ponto mais específico da Ephra. O pixel tem uma configuração que dispara a conversão já na geração do Pix, antes do pagamento. A própria documentação resume o dilema: é "útil para otimização de campanha, enganoso para relatório de receita".
Faz sentido existir. Quando boa parte das vendas é Pix, esperar o pagamento atrasa o sinal e a Meta aprende mais devagar. O preço é que o Ads Manager passa a contar como compra todo Pix que nasceu, inclusive os que nunca foram pagos.
Webhooks com o ciclo completo da transação
A visão geral de webhooks da Ephra lista os eventos de transação (transaction_created, transaction_paid, transaction_refunded, transaction_updated, refund_requested, card_declined), de recuperação (sale_lost para Pix não pago após cerca de 1 hora, cart_abandoned), de assinatura, de transferência e um evento de infração de Pix para o MED (Mecanismo Especial de Devolução). O payload de uma venda paga informa se ela tem order bumps.
Três detalhes da documentação que mudam a configuração:
- A Ephra testa a URL no cadastro com um POST de verdade. Endereço que não responde com sucesso não é salvo.
- Webhook com a lista de produtos vazia vale para todos os produtos.
- Cadastrar a mesma URL duas vezes gera duas entregas por evento.
Boleto e assinatura
A página de boleto informa que a Ephra não emite mais cobranças em boleto: o recebimento é por Pix e cartão, e boletos antigos seguem só no histórico. Nas assinaturas, a recorrência é no cartão, e cada renovação gera uma nova transação paga, com retentativas automáticas e cancelamento após 5 falhas seguidas.
Um ponto que a documentação pública consultada não detalha é quais parâmetros de URL (UTMs, src, sck) o checkout grava em cada venda. Se isso for decisivo para você, confirme com o suporte da Ephra.
Pix gerado, bump e upsell: por que o ROAS do gerenciador engana
Exemplo hipotético, com números ilustrativos. Um infoprodutor vende um curso de R$ 147 na Ephra, com order bump de R$ 37 no pop-up e upsell de 1 clique de R$ 97. Numa semana, investe R$ 18.000 em Meta Ads, com a conversão marcada no Pix gerado.
| Ads Manager | Vendas pagas | |
|---|---|---|
| Pix gerados | 420 "compras" | 290 pagos |
| Cartão aprovado | 110 compras | 110 vendas |
| Total de compras do produto principal | 530 | 400 |
| CPA do produto principal | R$ 33,96 | R$ 45,00 |
| Order bumps (30% das vendas pagas) | não separa | 120 × R$ 37 = R$ 4.440 |
| Upsells de 1 clique (15% das vendas pagas) | não separa | 60 × R$ 97 = R$ 5.820 |
| Receita do produto principal | 530 × R$ 147 = R$ 77.910 | 400 × R$ 147 = R$ 58.800 |
| Receita total do funil | não mostra | R$ 69.060 |
O gerenciador mostra CPA de R$ 33,96 e ROAS perto de 4,3 só no produto principal. O dinheiro que entrou conta outra história: CPA de R$ 45,00 e ROAS de 3,27 no produto principal, que sobe para 3,84 quando bump e upsell entram na conta. E isso ainda é faturamento: faltam taxas, reembolsos, MED e imposto.
Duas conclusões práticas:
- Marcar conversão no Pix gerado pode ser uma boa escolha para a Meta, desde que ninguém use o ROAS do gerenciador para decidir orçamento.
- Bump e upsell mudam o ranking de anúncios. Um anúncio que atrai compradores mais propensos a aceitar o upsell vale mais do que o CPA dele sugere. Para comparar, a receita de pós-compra precisa voltar para o anúncio da compra principal. O raciocínio completo está em order bump e upsell: como atribuir ao anúncio certo.
Os 130 Pix que não viraram venda, aliás, não são receita perdida para sempre: parte deles pode ser recuperada. Mas enquanto estão pendentes não são faturamento. Veja como tratar esse número em vendas pendentes de Pix e boleto.
Como conectar a Ephra à Track Hunter
A Track Hunter recebe vendas e reembolsos da Ephra por webhook, em tempo real. O passo a passo abaixo segue o tutorial do painel:
- Gere a URL na Track Hunter. Em Integrações → Checkouts, abra o card da Ephra e clique em Criar URL de webhook. Copie o endereço.
- Confirme a conta certa na Ephra. Entre em app.ephra.io e verifique se a conta aberta é a que vende de verdade. Conta pausada aceita o cadastro do webhook e não envia nada, e o sintoma é idêntico ao de uma URL errada: silêncio total.
- Abra Configurações → Webhooks no painel da Ephra.
- Cole a URL da Track Hunter. Como a Ephra testa o endereço antes de salvar, o cadastro só conclui se a ponta da Track Hunter responder. Se der erro, confira se copiou a URL inteira.
- Marque os eventos de transação criada, paga e reembolsada. Os eventos de transferência são movimentação de saldo (saques) e não entram no faturamento.
- Confira com uma venda real. O botão de teste da Ephra envia um evento marcado como teste, que a Track Hunter descarta de propósito para não sujar seus números. A confirmação vem na primeira venda de verdade, que aparece em segundos.
Dois cuidados. Não cadastre a mesma URL duas vezes, porque cada evento chegaria em dobro. E se desconectar a integração, as vendas do período desconectado não chegam sozinhas depois.
O que muda no seu dia a dia
- Faturamento de verdade. Só entra como venda o que foi pago. Pix gerado e não pago fica em Vendas Pendentes, fora do faturamento. O contraste com o número do gerenciador aparece sem planilha.
- Lucro, não só receita. A taxa do checkout chega automaticamente com a venda, e reembolso e chargeback saem do faturamento. Imposto sobre vendas e custos que a Ephra não conhece você cadastra uma vez em Configurações → Taxas e Produtos. O imposto sobre anúncios da Meta também entra na conta.
- Venda ligada ao anúncio. A atribuição usa as UTMs da visita. Na Meta, o padrão da Track Hunter vai em "Parâmetros de URL" e carimba o ID do anúncio em
utm_content={{ad.name}}|{{ad.id}}. Como a documentação pública da Ephra não detalha como a origem viaja com a venda, na primeira semana confira em algumas vendas reais se campanha e anúncio aparecem preenchidos. Se a fatia sem origem estiver alta, o guia qual anúncio gerou a venda ajuda a achar onde a UTM se perde. - Bump e upsell com o anúncio da compra principal. Na Track Hunter, order bump e upsell herdam a campanha e o anúncio da compra que os originou.
- Purchase na API de Conversões. Cada venda paga é enviada à Meta com dados do comprador em hash, e o Gerenciador de eventos da Track Hunter mostra os payloads aceitos. Se o pixel da Ephra também manda compra com token da API de Conversões para o mesmo pixel da Meta, revise a configuração para não contar a mesma venda por duas fontes.
Pixel da Track Hunter com o checkout da Ephra
O Pixel de trackeamento avançado da Track Hunter reconhece links de checkout da Ephra pelo endereço. Instalado na página de vendas, ele decora os links de compra com as UTMs da visita e um identificador de sessão e registra o InitiateCheckout no clique. Ele também acompanha a VSL, o que ajuda a enxergar a retenção do vídeo antes do checkout.
O plano Free inclui 300 vendas aprovadas no total, 1 canal de tráfego pago, Ads Lab e Deep Scan. Todos os planos começam com 30 dias grátis, sem cartão.
Checklist da primeira semana com a Ephra
- Decidido, por escrito, se a conversão da Meta dispara no Pix gerado ou só no pago, e todo mundo do time sabe qual número o gerenciador está mostrando.
- Um único webhook por URL, com todos os produtos incluídos.
- Anúncios com UTM padrão e ID do anúncio no
utm_content. - Algumas vendas reais conferidas na Track Hunter com campanha e anúncio preenchidos.
- Taxa de Pix pago (pagos ÷ gerados) acompanhada semanalmente. Se cair, o problema pode estar no checkout, não no anúncio.
- Reembolsos e infrações de Pix acompanhados por anúncio, não só no total.
Perguntas Frequentes
A Ephra tem integração com o pixel da Meta e a API de Conversões?
Sim. A documentação da Ephra mostra que o pixel da Meta é cadastrado com o código do pixel e, opcionalmente, o token da API de Conversões, ligado a um produto e, se você quiser, a um checkout específico. O token não volta a ser exibido depois de salvo.
Vale a pena disparar a conversão no Pix gerado na Ephra?
Depende do objetivo. Disparar no Pix gerado dá mais sinal e mais rápido para a Meta otimizar, o que ajuda quando o Pix é a maior parte das vendas. O efeito colateral é que o Ads Manager conta como compra Pix que nunca foi pago. Se usar essa opção, tome decisões de orçamento pelas vendas pagas, não pelo ROAS do gerenciador.
A Ephra ainda aceita boleto?
Segundo a documentação oficial, a Ephra não emite mais cobranças em boleto. O recebimento é por Pix e cartão, e as vendas antigas em boleto continuam visíveis no histórico.
Por que o webhook da Ephra não salva?
A Ephra testa a URL no momento do cadastro e recusa endereços que não respondem com sucesso. Confira se a URL da Track Hunter foi copiada inteira. Se o cadastro salvou, mas nada chega, verifique se você está na conta que vende de verdade: conta pausada aceita o webhook e não envia eventos.
O teste de webhook da Ephra aparece como venda na Track Hunter?
Não. O evento de teste da Ephra vem marcado como teste, e a Track Hunter o descarta de propósito para não sujar faturamento e atribuição. A confirmação de que a integração funciona é a primeira venda real, que aparece em segundos.
Como acompanhar order bump e upsell da Ephra por anúncio?
O webhook de venda paga da Ephra informa os order bumps da compra. Na Track Hunter, order bump e upsell herdam a campanha e o anúncio da compra principal, então a receita do pós-compra entra no resultado do anúncio que trouxe o comprador.