INTEGRAÇÃO NATIVACakto

Trackeamento de vendas da Cakto: cada compra ligada ao anúncio de origem

A Cakto avisa o Sparkle Tracker a cada compra e a cada Pix gerado. 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.

Webhook e API Compra enviada ao Meta e ao Google A partir do plano Pro
Cakto para o Sparkle Tracker Webhook
Compra aprovadapurchase_approved
Venda
Aguardando pagamentopurchase_pending
Aguardando
Compra reembolsadapurchase_refunded
Reembolso
Chargebackpurchase_chargeback
Chargeback

Eventos do webhook da Cakto

4eventos da Cakto lidos pelo Sparkle
3efeitos no painel: venda, aguardando e reembolso
Resposta rápida

Como rastrear as vendas da Cakto por anúncio?

Para saber de qual anúncio veio cada venda da Cakto, cadastre na Cakto o link de webhook do Sparkle Tracker. A cada compra, a Cakto 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 Cakto
Quatro eventos lidos, da venda ao reembolso
Venda com campanha, conjunto e criativo
O que chega

Quais eventos da Cakto o Sparkle Tracker recebe?

São os eventos que você marca ao cadastrar o webhook na Cakto. Cada um tem um efeito diferente no painel.

Eventos do webhook da Cakto e o efeito de cada um no Sparkle Tracker
Evento na Cakto No Sparkle Tracker Efeito
Compra aprovada purchase_approved Venda aprovada Entra no faturamento e envia a compra (Purchase) para o Meta e o Google
Aguardando pagamento, com Pix ou boleto gerado purchase_pending Aguardando pagamento Mostra quem gerou Pix ou boleto e ainda não pagou. Não conta como venda
Compra reembolsada purchase_refunded Reembolso Desconta o valor do faturamento
Chargeback purchase_chargeback Chargeback Desconta o valor do faturamento
Pixel e UTM

Pixel no checkout da Cakto ou venda pelo webhook?

O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Cakto e chega ao Sparkle com a venda confirmada.

Como a origem do anúncio chega até a venda da Cakto
Pergunta Como funciona com o Sparkle Tracker
Quem avisa que a venda aconteceu A Cakto, 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 Cakto confirma o pagamento.

A venda confirmada pelo gateway não depende do que o navegador deixou passar.

Passo a passo

Como integrar a Cakto ao Sparkle Tracker

Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Cakto, além de Client ID e Client Secret.

1Ative a integração no Sparkle

  1. No painel do Sparkle, abra Integrações, encontre o cartão Cakto e clique em Ativar integração.
  2. 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 Cakto

  1. Na Cakto, abra a tela de chaves de API. O nome do menu pode variar: procure por "API" ou "Chaves de API" em Integrações.
  2. Crie uma chave nova e dê um nome. Se a tela pedir permissões, marque a leitura de pedidos.
  3. Copie o Client ID e o Client Secret.
  4. Volte ao Sparkle, cole os dois valores e clique em Testar e ativar. A conexão é testada na hora.

Copie o Client Secret na hora: a Cakto pode mostrar esse valor só na criação da chave.

3Crie o webhook na Cakto

  1. 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.
  2. Na Cakto, abra a tela de Webhooks, em app.cakto.com.br/configuracoes/webhooks, e clique no botão de criar webhook.
  3. Em Nome, escreva um nome que identifique a operação.
  4. No campo de URL, cole o link copiado do Sparkle.
  5. Em Produtos, escolha o produto vendido nessa operação.
  6. Marque os eventos da tabela acima e salve o webhook.

Opcional: depois de salvar, abra o webhook criado na Cakto, copie o campo Secret e cole no Sparkle em Integrações, Cakto, Credenciais, Editar. Com ele salvo, só é aceita a venda que chega com o mesmo valor.

4Teste com uma compra

  1. Faça uma compra de teste, ou use o botão de teste do webhook, se o painel tiver.
  2. No Sparkle, abra Logs de Eventos: a chamada aparece em poucos segundos.
  3. 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 Cakto no Sparkle Tracker.

Além do webhook

O que as credenciais de API da Cakto acrescentam?

O webhook traz a venda. Com Client ID e Client Secret salvos, o Sparkle também lê a Cakto pela API.

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.

Venda que o webhook perdeu

Todo dia, à meia-noite, o Sparkle confere as vendas na Cakto 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.

Secret do webhook, opcional

Cada webhook da Cakto tem um campo Secret. Salvo no Sparkle, ele faz a integração aceitar só as vendas que chegam com esse mesmo valor.

FAQs

Dúvidas sobre a integração Cakto

Ative a integração Cakto no painel do Sparkle Tracker e escolha a operação. Cole as credenciais de API (Client ID e Client Secret), copie o link de webhook gerado e cadastre esse link no painel da Cakto, marcando os eventos de venda, pagamento pendente e reembolso. Uma compra de teste confirma se a venda chegou.

São quatro: compra aprovada, aguardando pagamento, com pix ou boleto gerado, compra reembolsada e chargeback. Cada um vira um efeito no painel: venda aprovada, aguardando pagamento 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 Cakto 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 evento de aguardando pagamento da Cakto, que cobre Pix e boleto gerados, aparece no Sparkle Tracker como Aguardando pagamento. A venda só entra no faturamento quando a Cakto 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, Cakto, Gerenciar, clique em Novo link, escolha a operação e gere o link. Depois crie outro webhook na Cakto 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 Cakto.

Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 7 dias grátis no plano mensal.