Integração Kirvano e Sparkle Tracker: cada venda ligada ao anúncio de origem
A Kirvano 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.
Kirvano para o Sparkle Tracker
Webhook
Eventos do webhook da Kirvano
Como rastrear as vendas da Kirvano por anúncio?
Para saber de qual anúncio veio cada venda da Kirvano, cadastre na Kirvano o link de webhook do Sparkle Tracker. A cada venda, a Kirvano 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 Kirvano o Sparkle Tracker recebe?
São os eventos que você marca ao cadastrar o webhook na Kirvano. Cada um tem um efeito diferente no painel.
| Evento na Kirvano | No Sparkle Tracker | Efeito |
|---|---|---|
| Compra aprovada SALE_APPROVED | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Pix gerado PIX_GENERATED | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda |
| Boleto gerado BANK_SLIP_GENERATED | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda |
| Carrinho abandonado ABANDONED_CART | Checkout iniciado | Entra no funil como início de checkout, para recuperar quem não terminou |
| Reembolso SALE_REFUNDED | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado |
| Chargeback SALE_CHARGEBACK | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado |
Pixel no checkout da Kirvano ou venda pelo webhook?
O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Kirvano e chega ao Sparkle com a venda confirmada.
| Pergunta | Como funciona com o Sparkle Tracker |
|---|---|
| Quem avisa que a venda aconteceu | A Kirvano, 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 Kirvano ao Sparkle Tracker
Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Kirvano.
1Ative a integração no Sparkle
- No painel do Sparkle, abra Integrações, encontre o cartão Kirvano 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 Kirvano
- Na Kirvano, abra a tela de Webhooks. O nome do menu pode variar: procure por "Webhooks" em Integrações ou em Configurações.
- 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.
- Deixe o campo Token da Kirvano vazio.
- Se a tela pedir o produto, escolha o produto vendido nessa operação.
- Marque todos os eventos da tabela acima e salve o webhook.
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 Kirvano no Sparkle Tracker.
A mesma integração por webhook também está pronta para Yampi, Doppus, Perfect Pay, 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 Kirvano
Ative a integração Kirvano no painel do Sparkle Tracker e escolha a operação. Copie o link de webhook gerado e cadastre esse link na Kirvano, marcando todos os eventos de venda, pagamento pendente e devolução. Uma compra de teste confirma se a venda chegou.
É o aviso que a Kirvano, checkout e gateway brasileiro para vendas de produtos digitais, manda de servidor para servidor a cada evento de venda. Você cadastra um endereço na Kirvano e escolhe os eventos. Para o Sparkle Tracker, esse endereço é o link gerado na integração.
São 6: compra aprovada, pix gerado, boleto gerado, carrinho abandonado, 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 Kirvano.
Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 7 dias grátis no plano mensal.