Relatórios de Meta Ads
Como instalar o pixel do Facebook no WordPress
Os três caminhos de instalação no WordPress, qual escolher conforme quem cuida do site, e por que o plugin que parece mais fácil costuma duplicar o evento.
O WordPress tem três caminhos para instalar o pixel, e a escolha entre eles não é técnica — é sobre quem vai cuidar do site depois de você.
Vale também saber de antemão qual é o erro mais comum da plataforma, porque ele é fácil de cometer e difícil de perceber: acabar com o pixel instalado duas vezes.
Caminho 1: plugin
É o caminho recomendado para a maior parte dos casos. Você instala um plugin de integração com o Meta, cola o identificador do pixel num campo, e ele cuida de inserir o código em todas as páginas.
A vantagem real não é a facilidade — é a sobrevivência. Instalação por plugin resiste a atualização de tema, que é o evento que mais apaga pixel colado à mão.
A desvantagem é depender de um plugin a mais, que precisa ser mantido atualizado como qualquer outro.
Caminho 2: gerenciador de tags
Se o site já usa um gerenciador de tags, o pixel entra por ali, e essa costuma ser a melhor opção quando existe alguém técnico envolvido.
A vantagem é o controle: você define exatamente em que páginas e em que condições cada evento dispara, sem depender do que o plugin decidiu por você. Também centraliza todas as ferramentas de medição num lugar só.
A desvantagem é a curva: configurar evento de conversão por gerenciador de tags exige entender gatilhos e variáveis. Para quem não vai mexer com frequência, o plugin entrega mais com menos.
O caminho está descrito em como instalar o pixel do Facebook pelo Tag Manager.
Caminho 3: código no tema
É colar o código do pixel diretamente no cabeçalho do tema.
Funciona, e tem um problema previsível: a próxima atualização do tema sobrescreve o arquivo e o pixel some. O site continua no ar, as campanhas continuam rodando, e os eventos param de chegar sem nenhum aviso.
Se for esse o caminho, use tema filho. E anote em algum lugar que a instalação está ali, porque a pessoa que for atualizar o tema daqui a seis meses não vai saber.
| Caminho | Sobrevive a atualização | Controle de eventos | Exige conhecimento |
|---|---|---|---|
| Plugin | Sim | Médio | Baixo |
| Gerenciador de tags | Sim | Alto | Médio |
| Código no tema | Não, salvo tema filho | Alto | Alto |
O erro clássico: instalar duas vezes
O WordPress é onde mais se vê pixel duplicado, e a razão é a sequência natural dos acontecimentos.
Alguém instala o plugin. Meses depois, outra pessoa acha que não está funcionando e cola o código no tema. Ou o tema já vinha com um campo de pixel preenchido e ninguém notou. Ou dois plugins diferentes — um de marketing, um de e-commerce — inserem o pixel cada um por conta.
Resultado: cada evento conta duas vezes. O custo por conversão aparece pela metade do real, a campanha parece excelente, e ninguém investiga o que está indo bem.
A verificação leva um minuto: abra o código-fonte de uma página e conte quantas vezes o identificador do pixel aparece. Uma está certo. Duas é o problema.
Depois de instalar: a visita não basta
Instalado, o pixel registra visualização de página. Isso é o mínimo e não sustenta decisão de campanha.
O que importa é o evento de conversão — o que conta como lead ou como compra, e em que momento exato dispara. Em site de conteúdo com formulário, o ponto certo é o envio, não a abertura. Em loja, é a confirmação do pedido, não o clique no botão de comprar.
Se o seu WordPress tem loja, o plugin de e-commerce costuma oferecer os eventos prontos. Vale conferir se ele não está disparando compra junto com a plataforma de pagamento, que é a mesma duplicação por outro caminho.
Como confirmar que ficou certo
Não basta ver o evento disparar uma vez no seu navegador. Percorra o funil inteiro como cliente — no celular, com dados móveis — anotando qual evento você espera em cada etapa e qual realmente disparou.
É comum descobrir aí que o script está na home e falta na página de obrigado, ou que o evento de lead dispara ao abrir o formulário em vez de ao enviar. O roteiro completo está em como testar o pixel do Facebook.
Quando o site tem loja
Loja em WordPress muda o cálculo, porque o plugin de e-commerce costuma trazer os eventos prontos — visualização de produto, adição ao carrinho, início de checkout, compra.
Isso é conveniente e traz um risco específico: se a plataforma de pagamento também dispara o evento de compra, a mesma venda entra duas vezes. O sintoma é o custo por conversão parecer bom demais.
Vale conferir também se o valor do pedido está chegando junto com o evento. Sem o valor, todas as vendas pesam igual para o algoritmo — a de R$ 40 e a de R$ 2.000 — e a campanha não consegue otimizar por receita.
Se você vende com order bump ou upsell, decida qual valor quer enviar: o do produto principal ou o total do carrinho. Os dois são defensáveis; o ruim é não saber qual está acontecendo.
O cache atrapalha o teste
Quase todo WordPress usa algum tipo de cache, e isso produz um mal-entendido recorrente na hora de verificar a instalação.
Você instala o pixel, abre a página, não encontra o código e conclui que falhou. Na verdade você está vendo uma versão guardada de antes da alteração.
Antes de investigar qualquer coisa, limpe o cache do site e o do navegador. Se houver cache em camada de rede, limpe também. Boa parte dos "não funcionou" do WordPress se resolve aqui, em dois minutos.
O mesmo vale para alterações posteriores: mudou evento, limpe o cache antes de testar.
O que anotar antes de sair
Deixe registrado, fora do WordPress: por qual caminho o pixel foi instalado, qual é o número dele e quem tem acesso ao portfólio dono.
Sem isso, a próxima pessoa que mexer no site vai instalar de novo por outro caminho — e aí você tem o pixel duplicado que este artigo tentou evitar. Se precisar descobrir qual pixel está rodando num site que você herdou, o caminho está em onde achar o ID do pixel do Facebook. E se o site foi feito num construtor em vez de WordPress, o caminho do Wix está em pixel no Wix.
Perguntas frequentes
Plugin ou código direto no tema?
Plugin, na maioria dos casos: sobrevive à atualização do tema, que apaga edições feitas diretamente nos arquivos. Código direto só se você usa tema filho e sabe o que está fazendo.
Posso ter plugin e código ao mesmo tempo?
Pode, e é o erro mais comum do WordPress. Os dois disparam, cada evento conta duas vezes e o custo por conversão aparece pela metade do real.
O pixel some quando eu atualizo o tema?
Some se estiver colado nos arquivos do tema, porque a atualização sobrescreve. Em plugin ou no gerenciador de tags, sobrevive.
Preciso de plugin pago?
Não para o básico. Plugin pago costuma agregar em evento de e-commerce e envio pelo servidor; para instalar o pixel e registrar visita, o gratuito resolve.