Pixel WooCommerce: Facebook, Google Ads, TikTok

A integração com o WooCommerce envia cada pedido que chega no status escolhido (por padrão, Processing) 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, moeda, ID do pedido, produtos, forma de pagamento e os dados do comprador (nome, email, telefone, CPF/CNPJ e endereço), que a plataforma de anúncio usa pra atribuir a venda à campanha certa.

O webhook do WooCommerce não traz os cookies do navegador. Por isso o plugin oficial do Track Combo já instala a Web Tag na sua loja: ela registra a visita, e 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. Você cria a integração no TrackCombo, copia a API Key e cola no plugin; o webhook é configurado automaticamente.

# Requisitos

• Loja WooCommerce com acesso de administrador ao WordPress
• Conta no TrackCombo (criar conta grátis)
• Pelo menos um pixel cadastrado no projeto com a API de Conversões ativa

A Web Tag não precisa ser instalada à parte: o plugin coloca a tag no <head> da loja assim que a API Key é validada.

# Passo a Passo

# 1. Instale o Plugin

Instale direto do diretório oficial do WordPress.org:

1. No painel do WordPress, vá em Plugins > Adicionar novo
2. No campo de busca, digite Track Combo
3. No card Track Combo — Conversions API for WooCommerce, clique em Instalar agora e depois em Ativar

Alternativa: abra a página oficial no WordPress.org e clique em Download para baixar o ZIP, depois envie em Plugins > Adicionar novo > Enviar plugin.

# 2. Adicione a Integração no TrackCombo

A API Key que o plugin precisa é gerada ao criar a integração WooCommerce no TrackCombo (não é a chave da sua conta nem do projeto).

1. Acesse app.trackcombo.com
2. Abra o projeto que vai receber os eventos da loja
3. Vá em Integrações
4. Clique em + Nova Integração
5. Selecione WooCommerce
6. Copie a API Key gerada para a integração

# 3. Conecte o Plugin

1. No WordPress, abra o novo menu Track Combo (barra lateral esquerda)
2. Cole a API Key no campo correspondente
3. Clique em Reload

O plugin valida a chave, identifica o projeto, cria o webhook automaticamente e exibe o status da integração (projeto, domínio, pixels configurados).

# 4. Escolha o Status do Pedido (Opcional)

Por padrão, o plugin dispara a conversão quando o pedido entra em Processing. Para mudar:

1. No menu Track Combo, vá em Settings
2. No campo Purchase status, selecione o status desejado. Cada opção mostra o nome traduzido + a slug entre parênteses (ex.: Processando (processing))
3. Clique em Save changes

# 5. Teste a Integração

1. Faça um pedido de teste na loja e leve até o status escolhido
2. No TrackCombo, acesse o projeto e vá na aba Eventos
3. Verifique se o evento purchase apareceu com os dados do pedido

# Atualizar o Plugin

O plugin está no diretório oficial do WordPress.org, então o WordPress avisa automaticamente quando há nova versão. Para atualizar, clique em Atualizar agora em Plugins > Plugins instalados (ou ative a atualização automática no card do plugin). Suas configurações (API Key, status) são preservadas.

# Pixels que funcionam com o WooCommerce

O webhook do WooCommerce gera um evento de compra no Track Combo: o pedido que entra no status escolhido no plugin (padrão Processing), que vira purchase. Cada pixel recebe esse evento com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

Pedido no status escolhido 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 no status escolhido 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 no status escolhido vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID do pedido, produtos e UTMs da visita. Precisa do API Secret no pixel. Veja como configurar o GA4.

# TikTok

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

# Pinterest

Pedido no status escolhido 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 no status escolhido 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 no status escolhido vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

# Dados Traqueados

Pelo webhook, a integração envia automaticamente:

• ID do pedido
• Valor total e moeda do pedido
• Forma de pagamento
• Produtos vendidos (nome, ID, preço e quantidade)
• Nome, email e telefone de cobrança do comprador
• CPF ou CNPJ do comprador (quando a loja grava o campo billing_cpf ou billing_cnpj)
• Endereço, cidade, estado, CEP e país de cobrança
• ID do cliente na loja, IP e navegador do comprador

As UTMs não vêm no webhook do WooCommerce: elas são completadas pela visita registrada pela Web Tag do plugin.

# Problemas Comuns

Como instalar o pixel do Facebook no WooCommerce?
Instale o plugin do Track Combo, conecte com a API Key e cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo. Cada pedido no status escolhido chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador. Não precisa de outro plugin de pixel.

O WooCommerce envia conversões pro Google Ads?
Sim. Com o plugin conectado e o pixel do Google Ads cadastrado com o Conversion Label de compra, cada pedido no status escolhido é enviado como conversão. O gclid vem da visita registrada pela Web Tag que o plugin instala na loja.

Pedido com boleto ou PIX pendente conta como venda no WooCommerce?
Depende do Purchase status. No padrão (Processing), o WooCommerce só muda o pedido pra esse status depois que o pagamento é confirmado, então boleto e PIX pendentes (status Aguardando) não viram compra. Se você escolher um status anterior ao pagamento, pedidos não pagos vão pros pixels como venda.

Pedidos não aparecem no TrackCombo?

• No menu Track Combo > Integration status, verifique se o webhook está marcado como criado
• Confirme que o Purchase status escolhido corresponde ao status real dos pedidos da sua loja
• Confirme que o projeto está Active
• Aguarde até 5 minutos para o processamento

API Key inválida?

• Confirme que copiou a API Key gerada na integração WooCommerce do projeto correto (não confunda com a chave do projeto ou da sua conta)
• Cole a chave novamente e clique em Reload

Já tinha outro pixel/plugin de conversão na loja?
Desative outros plugins que enviam eventos de conversão (ex.: plugins de Facebook Pixel, Google Ads). O TrackCombo centraliza o disparo de todos os pixels, evitando duplicação.