🔌 Integrações

Pixel na Kiwify: Facebook, Google Ads e TikTok

Envie as compras aprovadas da Kiwify pro Facebook, Google Ads, GA4, TikTok e Pinterest pela API de Conversões, server-side, com UTMs e dados do comprador.

A integração com a Kiwify envia cada compra aprovada (pedido com status paid) pros pixels do Facebook (Meta), Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI, pela API de Conversões de cada plataforma (server-side). A venda vai como evento de compra com valor, moeda, ID do pedido, produto, forma de pagamento e os dados do comprador (nome, email, celular e CPF), que a plataforma de anúncio usa pra atribuir a venda à campanha certa.

O webhook da Kiwify não traz os cookies do navegador. Por isso o Track Combo cruza a venda com a visita registrada pela Web Tag na sua página de vendas, usando o sck do checkout e o IP do comprador, e completa o evento com os identificadores de clique (fbp, fbc, gclid, ttclid) e as UTMs antes de enviar pros pixels.

Requisitos

  • Conta de produtor na Kiwify
  • Projeto criado no TrackCombo
  • Web Tag instalada na página de vendas, pra venda ser ligada ao clique no anúncio
  • Pelo menos um pixel cadastrado no projeto com a API de Conversões ativa

Passo a Passo

1. Adicione a Integração no TrackCombo

  1. Abra seu projeto no TrackCombo
  2. Vá em Integrações
  3. Clique em + Nova Integração
  4. Selecione Kiwify
  5. Copie a URL do webhook gerada pelo TrackCombo

2. Configure o Webhook na Kiwify

  1. Acesse o Painel da Kiwify
  2. Vá em Configurações do seu produto
  3. Acesse a aba Webhooks
  4. Clique em Adicionar webhook
  5. Cole a URL copiada do TrackCombo
  6. Selecione apenas o evento order_approved (Compra aprovada)
  7. Salve a configuração

3. Teste a Integração

  1. Faça uma compra de teste no seu produto Kiwify
  2. No TrackCombo, acesse o projeto e vá na aba Eventos
  3. Verifique se o evento de venda apareceu corretamente
  4. Confirme que os dados do comprador foram recebidos

Pixels que funcionam com a Kiwify

A Kiwify gera um único evento no Track Combo: a compra aprovada (order_approved, pedido com status paid), que vira purchase. Cada pixel recebe esse evento com o nome que a plataforma de anúncio espera.

Facebook (Meta)

Compra aprovada na Kiwify vira Purchase na API de Conversões, com valor, moeda, ID do pedido e dados do comprador. Precisa do Token de Conversão cadastrado no pixel. Veja como configurar o pixel do Facebook.

Compra aprovada vira a conversão de compra do Google Ads. O envio usa o Conversion Label que você cadastra no pixel pro evento purchase; sem label, a venda não é enviada. Veja como configurar o pixel do Google Ads.

GA4 (Google Analytics)

Compra aprovada vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID do pedido, produto e as UTMs que a Kiwify devolve no webhook. Precisa do API Secret no pixel. Veja como configurar o GA4.

TikTok

Compra aprovada vira CompletePayment na Events API do TikTok. Precisa do token de acesso no pixel. Veja como configurar o pixel do TikTok.

Pinterest

Compra aprovada vira checkout, o evento de compra da API de Conversões do Pinterest. Precisa do token no pixel. Veja como configurar o pixel do Pinterest.

Taboola

Compra aprovada vira make_purchase. Só vão pro Taboola as vendas de quem chegou por um anúncio do Taboola (com o clique tbclid registrado pela Web Tag). Veja como configurar o pixel do Taboola.

OpenAI (anúncios no ChatGPT)

Compra aprovada vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

Dados Traqueados

A integração envia automaticamente:

  • ID do pedido
  • Valor da compra (preço base do produto) e moeda
  • Forma de pagamento
  • Produto vendido (nome e ID)
  • Nome, email e celular do comprador
  • CPF do comprador (armazenado como hash SHA256)
  • País e IP do comprador
  • UTMs (source, medium, campaign, content, term) e os parâmetros src e sck do checkout

Dicas Importantes

  • A Kiwify devolve no webhook as UTMs do checkout. Configure suas campanhas com UTMs pra ter a origem de cada venda
  • O campo sck da Kiwify é usado como código de traqueamento do TrackCombo pra ligar a venda à visita
  • Valores monetários são enviados em centavos (ex: R$ 37,90 = 3790). O TrackCombo converte automaticamente

Problemas Comuns

Como instalar o pixel do Facebook na Kiwify?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e conecte a Kiwify pelo webhook (passo a passo acima). Cada compra aprovada chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.

A Kiwify envia conversões pro Google Ads?
Sim. Com a integração ativa e o pixel do Google Ads cadastrado com o Conversion Label de compra, cada compra aprovada na Kiwify é enviada como conversão. O gclid vem da visita registrada pela Web Tag na página de vendas.

PIX gerado ou boleto impresso na Kiwify vira compra no pixel?
Não. Só pedidos com status paid viram compra. PIX gerado, boleto impresso, recusa, reembolso e chargeback são descartados pela integração, mesmo que você marque esses eventos no webhook. Por isso basta selecionar order_approved.

Vendas não aparecem no TrackCombo?

  • Verifique se a URL do webhook está correta na Kiwify
  • Confirme que os eventos estão selecionados (order_approved)
  • Aguarde até 5 minutos para o processamento

Valor da compra incorreto?

  • O TrackCombo converte automaticamente centavos para reais
  • Se ainda estiver incorreto, verifique na aba Eventos o payload recebido
kiwifyintegraçãowebhookvendaspixelapi de conversõesfacebookgoogle adsinfoproduto