Integração Perfect Pay e Sparkle Tracker: cada venda ligada ao anúncio de origem
A Perfect Pay avisa o Sparkle Tracker pelo webhook a cada venda, a cada pagamento gerado e a cada devolução. O Sparkle liga o evento ao lead, mostra de qual campanha, conjunto e criativo ele veio e envia a compra para o Meta e o Google.
Eventos do webhook da Perfect Pay
Como rastrear as vendas da Perfect Pay por anúncio?
Para saber de qual anúncio veio cada venda da Perfect Pay, cadastre na Perfect Pay o link de webhook do Sparkle Tracker. A cada venda, a Perfect Pay avisa o Sparkle, que liga a venda ao lead pelo telefone ou pelo e-mail do comprador.
O lead já tem a campanha, o conjunto e o criativo do clique. A venda aparece no painel com essa origem e segue para o Meta e para o Google como compra. A venda devolvida desconta o valor do faturamento. É uma das integrações nativas do Sparkle Tracker.
Atualizado em
Quais eventos da Perfect Pay o Sparkle Tracker recebe?
São os eventos que você marca ao cadastrar o webhook na Perfect Pay. Cada um tem um efeito diferente no painel.
| Evento na Perfect Pay | No Sparkle Tracker | Efeito |
|---|---|---|
| Venda aprovada status 2 | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Venda completa status 10 | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Pendente, com boleto ou Pix gerado status 1 | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda |
| Em análise ou autorizada status 3, 8 e 16 | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda |
| Pré-checkout, abandono status 12 | Checkout iniciado | Entra no funil como início de checkout, para recuperar quem não terminou |
| Cancelado status 6 | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado |
| Reembolso status 7 | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado |
| Chargeback status 9 | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado |
Pixel no checkout da Perfect Pay ou venda pelo webhook?
O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Perfect Pay e chega ao Sparkle com a venda confirmada.
| Pergunta | Como funciona com o Sparkle Tracker |
|---|---|
| Quem avisa que a venda aconteceu | A Perfect Pay, pelo webhook, de servidor para servidor. Não depende do navegador nem de a pessoa voltar para a página de obrigado. |
| Como a venda acha o anúncio | Pelo telefone ou e-mail do comprador, que o Sparkle compara com o lead. O lead já carrega a campanha, o conjunto e o criativo do primeiro clique. |
| Para onde vão as UTMs | Na Venda Direta, o script do Sparkle guarda as UTMs por 30 dias e acrescenta UTMs, src, sck e xcod em todo link que leva ao checkout. O checkout guarda esses campos e devolve na venda. |
| O que volta para o Meta e o Google | A compra (Purchase) com a origem, enviada pelo Sparkle. Para o Google Ads, a conversão vai quando o clique veio de um anúncio do Google. |
A venda confirmada pelo gateway não depende do que o navegador deixou passar.
Como integrar a Perfect Pay ao Sparkle Tracker
Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Perfect Pay.
1Ative a integração no Sparkle
- No painel do Sparkle, abra Integrações, encontre o cartão Perfect Pay e clique em Ativar integração.
- Em Operação, escolha de qual operação são as vendas e clique em Continuar.
- Copie o link de webhook gerado pelo botão ao lado dele, sem montar o endereço à mão.
Cada operação tem um link próprio. Para vender em mais de uma operação, gere um link para cada.
2Crie o webhook na Perfect Pay
- Na Perfect Pay, abra Ferramentas, Webhook.
- Clique no botão de criar webhook.
- Em Nome, escreva um nome que identifique a operação.
- No campo de URL, cole o link copiado do Sparkle.
- Se a tela pedir o produto, escolha o produto vendido nessa operação.
- Marque todos os eventos da tabela acima e salve o webhook.
Opcional: na mesma tela de Webhook da Perfect Pay, copie o Token e cole no Sparkle, nas credenciais da integração. Com ele salvo, só é aceita a venda que chega com o mesmo token.
3Teste com uma compra
- Faça uma compra de teste, ou use o botão de teste do painel, se houver.
- No Sparkle, abra Logs de Eventos: a chamada aparece em poucos segundos.
- Abra Leads Capturados e clique no comprador. Em Histórico de ações, a venda aparece com gateway, produto e valor.
O guia com as telas está na documentação: integração Perfect Pay no Sparkle Tracker.
A mesma integração por webhook também está pronta para Kirvano, Yampi, Doppus, Braip, Payt, Ticto e Logzz, além de Hotmart, Kiwify, Cakto e Eduzz.
Outras integrações e o que fazer com a venda
Dúvidas sobre a integração Perfect Pay
Ative a integração Perfect Pay no painel do Sparkle Tracker e escolha a operação. Copie o link de webhook gerado e cadastre esse link na Perfect Pay, marcando todos os eventos de venda, pagamento pendente e devolução. Uma compra de teste confirma se a venda chegou.
É o aviso que a Perfect Pay, gateway de pagamentos brasileiro para produtores digitais e afiliados, manda de servidor para servidor a cada evento de venda. Você cadastra um endereço na Perfect Pay e escolhe os eventos. Para o Sparkle Tracker, esse endereço é o link gerado na integração.
São 8: venda aprovada, venda completa, pendente, com boleto ou pix gerado, em análise ou autorizada, pré-checkout, abandono, cancelado, reembolso e chargeback. Cada um vira um efeito no painel: venda aprovada, venda iniciada, checkout iniciado e reembolso.
Sai. Com os eventos de devolução marcados no webhook, o valor é descontado do faturamento, e o ROAS e o lucro do anúncio que trouxe a venda ficam corretos.
Há duas causas comuns. O comprador usou no checkout um telefone ou e-mail diferente do que tinha como lead, e a venda entrou como um lead novo de Venda Direta. Ou o anúncio estava sem o modelo de UTM nos parâmetros de URL. O modelo fica em Operações e UTMs, na aba UTMs.
As integrações com checkouts, gateways e e-commerces fazem parte dos planos Pro, Expert e Growth. Ver os planos.
Veja de qual anúncio veio a próxima venda da Perfect Pay.
Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 7 dias grátis no plano mensal.