Taxa e comissão de cada venda
O Sparkle busca quanto ficou com a plataforma e mostra a receita líquida, que é a base do lucro e do ROAS líquido.
INTEGRAÇÃO NATIVAKiwify
Integração com a Kiwify: pixel, UTM e webhook com a venda no anúncio certo
A Kiwify avisa o Sparkle Tracker a cada compra, Pix gerado e carrinho abandonado. O Sparkle liga cada evento ao lead e mostra de qual campanha, conjunto e criativo ele veio.
Webhook e API
Compra enviada ao Meta e ao Google
A partir do plano Pro
Kiwify para o Sparkle Tracker
Webhook
Compra aprovadaEvento da Kiwify
VendaPix geradoEvento da Kiwify
AguardandoCarrinho abandonadoEvento da Kiwify
CheckoutReembolsoEvento da Kiwify
ReembolsoEventos do webhook da Kiwify
7eventos da Kiwify lidos pelo Sparkle
4efeitos no painel: venda, aguardando, checkout e reembolso
Resposta rápida
Como rastrear as vendas da Kiwify por anúncio?
Para saber de qual anúncio veio cada venda da Kiwify, cadastre na Kiwify o link de webhook do Sparkle Tracker. A cada compra, a Kiwify 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. É uma das integrações nativas do Sparkle Tracker.
Atualizado em
Webhook e API da Kiwify
Sete eventos lidos, da venda ao reembolso
Venda com campanha, conjunto e criativo
O que chega
Quais eventos da Kiwify o Sparkle Tracker recebe?
São os eventos que você marca ao cadastrar o webhook na Kiwify. Cada um tem um efeito diferente no painel.
| Evento na Kiwify | No Sparkle Tracker | Efeito |
|---|---|---|
| Compra aprovada | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Assinatura renovada se a conta oferecer | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Boleto gerado | Aguardando pagamento | Mostra quem gerou Pix ou boleto e ainda não pagou. Não conta como venda |
| Pix gerado | Aguardando pagamento | Mostra quem gerou Pix ou boleto e ainda não pagou. Não conta como venda |
| Carrinho abandonado | Iniciou checkout | Mostra quem abriu o checkout e não comprou. Não conta como venda |
| Reembolso | Reembolso | Desconta o valor do faturamento |
| Chargeback | Chargeback | Desconta o valor do faturamento |
Pixel e UTM
Pixel no checkout da Kiwify ou venda pelo webhook?
O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Kiwify e chega ao Sparkle com a venda confirmada.
| Pergunta | Como funciona com o Sparkle Tracker |
|---|---|
| Quem avisa que a venda aconteceu | A Kiwify, 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. |
| Pix e boleto pagos depois | Entram como Aguardando pagamento quando são gerados e viram venda quando a Kiwify confirma o pagamento. |
A venda confirmada pelo gateway não depende do que o navegador deixou passar.
Passo a passo
Como integrar a Kiwify ao Sparkle Tracker
Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Kiwify, além de Client ID, Client Secret e Account ID.
1Ative a integração no Sparkle
- No painel do Sparkle, abra Integrações, encontre o cartão Kiwify e clique em Ativar integração.
- Em Operação, escolha de qual operação são as vendas e clique em Continuar.
Cada operação tem um link de webhook próprio. Para vender em mais de uma operação, gere um link para cada.
2Gere as credenciais na Kiwify
- Na Kiwify, abra Apps › API.
- Clique em Criar API Key e dê um nome.
- Copie os valores de client_id, client_secret e account_id.
- Volte ao Sparkle, cole os três valores e clique em Testar e ativar. A conexão é testada na hora.
Copie o client_secret na hora: a Kiwify pode não mostrar esse valor de novo.
3Crie o webhook na Kiwify
- No Sparkle, copie o link que apareceu com o selo NOVO. Copie pelo botão ao lado do link, sem montar o endereço à mão.
- Na Kiwify, abra Apps › Webhooks e clique no botão de criar webhook.
- Em Nome, escreva um nome que identifique a operação.
- Em URL do Webhook, cole o link copiado do Sparkle.
- Em Produtos, escolha o produto vendido nessa operação.
- Marque os eventos da tabela acima e salve o webhook.
4Teste com uma compra
- Faça uma compra de teste, ou use o botão de teste do webhook, se o painel tiver.
- 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 Kiwify no Sparkle Tracker.
Além do webhook
O que as credenciais de API da Kiwify acrescentam?
O webhook traz a venda. Com Client ID, Client Secret e Account ID salvos, o Sparkle também lê a Kiwify pela API.
Venda que o webhook perdeu
Todo dia, à meia-noite, o Sparkle confere as vendas na Kiwify e recupera a que não chegou pelo webhook.
Reembolso e chargeback em dia
A venda devolvida é atualizada e sai do faturamento, para o resultado do anúncio não ficar inflado.
Pix e boleto antes do pagamento
A Kiwify envia o Pix e o boleto no momento em que são gerados. No Sparkle eles aparecem como Aguardando pagamento, com o nome de quem ainda não pagou.
Do mesmo assunto
Outras integrações e o que fazer com a venda
Integração HotmartEventos e passo a passo do webhook da Hotmart
Integração EduzzEventos e passo a passo do webhook da Eduzz
Integração CaktoEventos e passo a passo do webhook da Cakto
Trackeamento de vendasComo a venda do gateway é ligada ao lead e ao anúncio
Todas as integraçõesGateways, e-commerces, pixels, CRMs, API e webhooks
Trackeamento de venda diretaPágina de vendas e checkout, sem WhatsApp no meio
FAQs
Dúvidas sobre a integração Kiwify
Ative a integração Kiwify no painel do Sparkle Tracker e escolha a operação. Cole as credenciais de API (Client ID, Client Secret e Account ID), copie o link de webhook gerado e cadastre esse link no painel da Kiwify, marcando os eventos de venda, pagamento pendente e reembolso. Uma compra de teste confirma se a venda chegou.
São sete: compra aprovada, assinatura renovada, boleto gerado, pix gerado, carrinho abandonado, reembolso e chargeback. Cada um vira um efeito no painel: venda aprovada, aguardando pagamento, início de checkout ou reembolso.
São caminhos diferentes. O pixel colocado no checkout roda no navegador do comprador. A integração do Sparkle Tracker recebe a venda do servidor da Kiwify e envia a compra ao Meta e ao Google com o anúncio de origem. Assim a compra chega às plataformas mesmo quando o navegador bloqueia o pixel ou quando o Pix é pago depois.
Não. O Pix gerado e o boleto gerado aparecem no Sparkle Tracker como Aguardando pagamento, que mostra quem começou a compra e ainda não pagou. A venda só entra no faturamento quando a Kiwify envia a compra aprovada.
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.
Dá. Em Integrações, Kiwify, Gerenciar, clique em Novo link, escolha a operação e gere o link. Depois crie outro webhook na Kiwify com esse link. O limite de links é o número de operações do seu plano.
As integrações com checkouts e gateways de pagamento fazem parte dos planos Pro, Expert e Growth. Ver os planos.
Veja de qual anúncio veio a próxima venda da Kiwify.
Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 7 dias grátis no plano mensal.