Pixel na Yampi: Facebook, Google Ads e TikTok

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

O webhook da Yampi não traz os cookies do navegador. Por isso a integração tem duas partes: o webhook traz a venda, e a Web Tag instalada na loja e no checkout registra a visita e os eventos do funil. O Track Combo cruza o pedido com essa visita e completa o evento com os identificadores de clique (fbp, fbc, gclid, ttclid) e as UTMs antes de enviar pros pixels.

# Requisitos

• Conta ativa na Yampi
• Projeto criado no TrackCombo
• Domínio ativo no projeto (necessário para gerar a Web Tag)
• 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 Yampi
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook na Yampi

1. Acesse o Painel da Yampi
2. Vá em Configurações > Webhooks
3. Clique em Adicionar webhook
4. Cole a URL copiada do TrackCombo
5. Marque o evento Pedido pago (order.paid)
6. Salve a configuração

Marque o evento certo. Só o Pedido pago vira uma compra. Os outros eventos de pedido são descartados de propósito, porque a Yampi dispara vários ao mesmo tempo para o mesmo pedido e também para pedidos cancelados ou aguardando pagamento. Se você marcar só order.updated ou order.status.updated, nenhuma venda é registrada.

# 3. Instale a Web Tag na loja e no checkout

O webhook traz a venda, mas não traz os cookies do navegador. Sem a Web Tag, o TrackCombo não consegue cruzar a compra com a visita que a originou, e a qualidade da atribuição cai.

Pegue o código da Web Tag no seu projeto, conforme Instalar a Web Tag, e instale nos dois ambientes:

Na loja (sualoja.com.br): cole o código no <head> de todas as páginas. Se a sua loja é a Loja Virtual da Yampi, use Apps > Google Tag Manager no painel da Yampi e adicione a Web Tag como tag de HTML personalizado, disparando em todas as páginas. Veja Instalar Web Tag via Google Tag Manager.

No checkout (seguro.sualoja.com.br): o checkout da Yampi roda num domínio separado e não herda a tag da loja. O caminho é o mesmo container do Google Tag Manager configurado em Apps > Google Tag Manager, que também carrega nas páginas do checkout.

O campo Scripts do checkout não serve para isso. Os scripts colados em Checkout > Scripts e Meta Tags rodam apenas nas páginas de obrigado. Para os eventos das etapas do checkout, use o Google Tag Manager.

# 4. Teste a Integração

1. Abra um produto na sua loja e adicione ao carrinho
2. Vá até o checkout e preencha os dados
3. Faça um pedido de teste
4. No TrackCombo, acesse o projeto e vá na aba Eventos
5. Confirme que apareceram view_item, add_to_cart, initiate_checkout e purchase

# Pixels que funcionam com a Yampi

O webhook da Yampi gera um evento de compra no Track Combo: o pedido pago (order.paid), que vira purchase. Cada pixel recebe esse evento com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

Pedido pago na Yampi 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.

# Google Ads

Pedido pago 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)

Pedido pago vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID do pedido, produtos e as UTMs do pedido. Precisa do API Secret no pixel. Veja como configurar o GA4.

# TikTok

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

# Pinterest

Pedido pago 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

Pedido pago 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)

Pedido pago vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

# Dados Traqueados

Pelo webhook, na compra:

• Número do pedido
• Valor total da compra (em reais)
• Forma de pagamento
• Produtos vendidos (SKU, nome, preço e quantidade)
• Nome, email, telefone, CPF e data de nascimento do cliente
• Endereço de entrega (endereço, cidade, estado, CEP e país)
• ID do cliente na Yampi e IP do comprador
• UTMs do pedido (source, medium, campaign, content, term) e o token do carrinho

Pela Web Tag, durante a navegação:

• view_item na página de produto
• add_to_cart ao adicionar ao carrinho
• search na busca
• initiate_checkout e add_payment_info nas etapas do checkout

# Problemas Comuns

Como instalar o pixel do Facebook na Yampi?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo, conecte a Yampi pelo webhook e instale a Web Tag na loja e no checkout (passo a passo acima). Cada pedido pago chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.

A Yampi 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 pedido pago na Yampi é enviado como conversão. O gclid vem da visita registrada pela Web Tag.

Pedido com PIX ou boleto ainda não pago vira compra no pixel?
Não. A integração só aceita o evento order.paid com o pedido no status pago. Pedidos aguardando pagamento, cancelados ou recusados são descartados, então o pixel só recebe venda confirmada.

Pedidos não aparecem no TrackCombo?

• Verifique se a URL do webhook está correta na Yampi
• Confirme que o evento Pedido pago está marcado
• Aguarde até 5 minutos para o processamento

Só aparece purchase, nenhum evento do funil?

• A Web Tag não está instalada, ou está só na loja e não no checkout
• Confirme que o container do Google Tag Manager está ativo nos dois domínios

A compra aparece sem os dados de campanha (UTMs, cookies)?

• É o sintoma de Web Tag ausente no checkout: o TrackCombo recebeu a venda, mas não tinha nenhuma visita para cruzar