Integração Yampi e Sparkle Tracker: cada venda ligada ao anúncio de origem
A Yampi 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.
Yampi para o Sparkle Tracker
Webhook
Eventos do webhook da Yampi
Como rastrear as vendas da Yampi por anúncio?
Para saber de qual anúncio veio cada venda da Yampi, cadastre na Yampi o link de webhook do Sparkle Tracker. A cada venda, a Yampi 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 Yampi o Sparkle Tracker recebe?
São os eventos que você marca ao cadastrar o webhook na Yampi. Cada um tem um efeito diferente no painel.
| Evento na Yampi | No Sparkle Tracker | Efeito |
|---|---|---|
| Pedido pago order.paid | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Pedido criado order.created | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda |
| Lembrete de carrinho, se a conta tiver cart.reminder | Checkout iniciado | Entra no funil como início de checkout, para recuperar quem não terminou |
| Pedido reembolsado order.refunded | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado |
Pixel no checkout da Yampi ou venda pelo webhook?
O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Yampi e chega ao Sparkle com a venda confirmada.
| Pergunta | Como funciona com o Sparkle Tracker |
|---|---|
| Quem avisa que a venda aconteceu | A Yampi, 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 Yampi ao Sparkle Tracker
Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Yampi.
1Ative a integração no Sparkle
- No painel do Sparkle, abra Integrações, encontre o cartão Yampi 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.
2Cole as credenciais de API da Yampi
- Na Yampi, abra a tela Credenciais de API, no menu do seu perfil ou em Configurações, e copie o User Token e o User Secret Key. O Alias da loja é o nome curto da loja, sem espaços, que aparece nessa mesma tela e no endereço do painel.
- Volte ao Sparkle, cole os valores e clique em Testar e ativar. A conexão é testada na hora.
3Crie o webhook na Yampi
- Na Yampi, abra a tela de Webhooks, em Configurações. Se não achar, procure por "Webhooks" em Configurações ou em Apps.
- 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.
- Marque todos 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 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 Yampi no Sparkle Tracker.
O que as credenciais de API da Yampi acrescentam?
O webhook traz a venda. Com Alias da loja, User-Token e User-Secret-Key salvos, o Sparkle também lê a Yampi pela API.
A mesma integração por webhook também está pronta para Kirvano, 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 Yampi
Ative a integração Yampi no painel do Sparkle Tracker e escolha a operação. Cole as credenciais de API (Alias da loja, User-Token e User-Secret-Key). Copie o link de webhook gerado e cadastre esse link na Yampi, marcando todos os eventos de venda, pagamento pendente e devolução. Uma compra de teste confirma se a venda chegou.
É o aviso que a Yampi, plataforma brasileira de e-commerce e checkout para lojas online, manda de servidor para servidor a cada evento de venda. Você cadastra um endereço na Yampi e escolhe os eventos. Para o Sparkle Tracker, esse endereço é o link gerado na integração.
São 4: pedido pago, pedido criado, lembrete de carrinho e pedido reembolsado. 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 Yampi.
Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 7 dias grátis no plano mensal.