Communitygithub.com

ooiyeefei/ccc

Configurar o Pixel do Meta (rastreamento de anúncios do Facebook/Instagram) em um site e disparar um evento de conversão (Lead, CompleteRegistration, Purchase) de ponta a ponta. Orienta o usuário pelo Business Suite / Events Manager, criando ou encontrando o ID do Pixel/Dataset, instalando o código base, disparando um evento padrão e verificando com o Meta Pixel Helper ANTES de rodar anúncios.

O que é ccc?

Esta habilidade (skill) automatiza a configuração completa do Pixel do Meta (Facebook/Instagram) para rastreamento de conversões em websites. Ela é útil para desenvolvedores e profissionais de marketing que precisam implementar rastreamento de anúncios, seja para leads, cadastros ou vendas, sem se perderem nas opções complexas do Meta. A skill suporta qualquer plataforma (Next.js, HTML puro, WordPress, Shopify) e guia o usuário por decisões críticas: escolher apenas o Pixel do navegador (recomendado para começar) e evitar categorias restritivas de dados que podem prejudicar a otimização dos anúncios. Ela fornece o código de instalação e de evento de conversão, com ênfase em não enviar dados pessoais (PII) e na verificação obrigatória antes de qualquer gasto com anúncios, usando ferramentas como o Meta Pixel Helper.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ooiyeefei/ccc/tree/HEAD/skills/meta-pixel-setup

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

ccc preview

Documentação

Configuração do Pixel do Meta

Configure o Pixel do Meta para rastrear uma conversão real em um site, verificada, para que a otimização de anúncios do Facebook/Instagram tenha algo verdadeiro para aprender. Duas coisas pegam as pessoas e esta habilidade as aborda de antemão: a decisão Pixel vs. Conversions API (o assistente do Meta empurra agressivamente a opção mais pesada) e qual categoria de dados declarar (uma escolha errada pode limitar seus anúncios).

Nota de nomenclatura: o Meta renomeou "Pixel" para "Dataset" na interface. Um dataset contém o pixel e seu ID do Dataset = ID do Pixel (um número de ~15–16 dígitos). Trate as duas palavras como a mesma coisa.

Comece de onde o usuário está

A configuração é uma cadeia: Página do Facebook → Portfólio de negócios → Events Manager → Pixel/Dataset (obter o ID) → código base no site → evento de conversão → verificar. As pessoas chegam no meio da cadeia. Pergunte primeiro e então entre — não recrie o que já existe (um negócio muitas vezes já tem um pixel; reutilize-o em vez de fragmentar dados entre dois).

Pergunte (adapte ao que eles disseram):

  1. Você já tem uma Página do Facebook e Meta Business Suite / Portfólio de negócios configurados?
  2. Você já tem um Pixel / Dataset (no Events Manager)? Se sim, qual é o ID do Dataset (o número de ~16 dígitos)? Cole-o — pode ser tudo o que é necessário.
  3. Qual é a única conversão que importa (um lead/envio de lista de espera, um cadastro, uma compra)? É para isso que os anúncios otimizam.
  4. A stack + domínio do site (Next.js, HTML puro, WordPress, Shopify) — decide como o código será inserido.

Se eles já tiverem o ID do Dataset e uma Página, pule direto para a instalação (§3). Não os guie de volta pela criação de conta que já fizeram.

Decisão 1: Apenas Pixel, ou + Conversions API? (comece com apenas Pixel)

O assistente de configuração do Meta mostra "Conversions API e Meta Pixel (Recomendado)" com uma estatística brilhante. Não aceite reflexivamente. Aqui está a troca honesta:

  • Meta Pixel (navegador) — um snippet de código no site envia eventos do navegador do visitante. Simples, sem backend, funciona hoje. Isso é tudo que você precisa para lançar.
  • Conversions API (CAPI) — seu servidor envia eventos diretamente para o Meta. É servidor-para-servidor, "requer suporte de desenvolvedor" e, para realmente ajudar, precisa de PII do cliente (e-mail, telefone, IP) enviados ao Meta para correspondência. Isso é mais construção e uma superfície de privacidade/conformidade maior (LGPD/GDPR/CCPA).

Portanto: lance com o Pixel do navegador. Adicione CAPI depois, somente se a perda de sinal do navegador (bloqueadores de anúncios, ATT da iOS) estiver prejudicando você de forma mensurável e você tiver resolvido a questão de PII/consentimento. Trate CAPI como uma otimização pós-lançamento, não uma etapa de configuração. Leia references/conversions-api.md antes de conectá-lo — ele existe para impedir que você envie dados pessoais para o Meta por acidente.

Decisão 2: a "categoria" do Dataset — deixe em branco a menos que se encaixe claramente

Ao criar o dataset, o Meta pergunta para "selecionar quaisquer categorias aplicáveis." Esta é uma armadilha para produtos financeiros/saúde/sensíveis. O diálogo avisa: "dependendo da categoria e localização, o compartilhamento de dados pode ser limitado ou bloqueado." Categorias como "Serviço financeiro," "Vulnerabilidade econômica," "Dificuldade pessoal," "Nacionalidade" acionam o manuseio restrito de dados do Meta e podem limitar ou bloquear a otimização dos seus anúncios.

Regra: marque uma categoria somente se ela descrever você com precisão e inevitabilidade, e você entender que ela restringe dados. Uma ferramenta de orçamento/produtividade/SaaS é software, não um "serviço financeiro" (essa categoria é para credores, relatórios de crédito, finanças ao consumidor). Em caso de dúvida, deixe as categorias vazias (é opcional) — vazio significa sem restrição, que é o que um teste normal de lista de espera/cadastro deseja.

1. Criar ou encontrar o Pixel/Dataset (obter o ID)

No Events Manager:

  1. Barra lateral esquerda → Conectar dados (verde +) → Web → Meta Pixel → Conectar. (Ou se um dataset existir, clique nele — o ID está logo abaixo do nome.)
  2. Nomeie-o após o negócio (ex.: "Acme Web"). Para categoria, veja Decisão 2 (geralmente deixe em branco).
  3. Copie o ID do Dataset — o número de ~16 dígitos abaixo do nome. Também sempre visível depois em Events Manager → Datasets.
  4. Se ele abrir um assistente "configurar / conectar seu website" oferecendo Conversions-API vs apenas Pixel — você pode fechar/pular. Você só precisa do ID; o código é inserido manualmente (§3). Se prosseguir, escolha Apenas Meta Pixel (Decisão 1).

2. (Opcional) Reutilizar um pixel existente

Um pixel não é uma parede rígida de relatórios como uma propriedade do GA4. Um pixel pode cobrir um domínio inteiro — o aplicativo principal e uma página de destino /waitlist. Diferencie funis pelo evento + parâmetros personalizados (ex.: content_name: 'waitlist'), não por um segundo pixel. Se o negócio já tiver um, reutilize seu ID.

3. Instalar o código base

Cole no <head> em todas as páginas, substituindo YOUR_PIXEL_ID. Ele dispara PageView automaticamente. (Copie seu snippet exato do Events Manager — ele tem o ID pré-preenchido — ou use esta forma canônica.)

<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
  src="https://www.facebook.com/tr?id=YOUR_PIXEL_ID&ev=PageView&noscript=1"/></noscript>
<!-- End Meta Pixel Code -->

NÃO adicione um hash integrity/SRI — fbevents.js é um carregador versionado que o Meta atualiza no lugar e não publica um hash estável; SRI o quebrará. Instalação específica para frameworks (Next.js next/script, WordPress, Shopify, GTM) está em references/install-by-platform.md.

4. Disparar o evento de conversão na ação

Use um evento padrão para que a otimização e os relatórios do Meta o reconheçam — Lead (lista de espera/contato), CompleteRegistration (cadastro), Purchase (venda). Lista completa + quando usar cada: references/standard-events.md. Dispare-o somente após a ação ter realmente sucedido, nunca em um erro capturado.

<script>
form.addEventListener('submit', async function (e) {
  e.preventDefault();
  try {
    await saveTheLead(/* ... */);          // 1. persista PRIMEIRO — o sucesso real
    if (window.fbq) fbq('track', 'Lead', { // 2. só então, conte (proteja contra bloqueadores)
      content_name: 'waitlist',            // parâmetros segmentáveis, NÃO PII apenas
      value_bucket: 'high'
    });
    window.location.href = '/thank-you';
  } catch (err) {
    showError('Algo deu errado, por favor tente novamente.');  // sem evento, sem sucesso falso
  }
});
</script>

Regra de PII — não envie dados pessoais através do Pixel do navegador

Nunca passe e-mail, telefone, nome ou endereço como parâmetros de evento. Envie categorias/faixas (content_name, uma faixa de valor, uma persona) — suficiente para segmentar, não para identificar. (O único lugar onde o Meta usa PII com hash é no Advanced Matching do CAPI, que é uma escolha deliberada, consentida e do lado do servidor — veja references/conversions-api.md, não algo para espalhar em eventos do navegador.)

5. Verifique ANTES de gastar — o portão

Faça uma conversão real no site ao vivo/pré-visualização, então confirme:

  • Instale a extensão Chrome Meta Pixel Helper. Carregue a página → ele mostra o pixel + PageView. Envie o formulário → ele mostra o evento Lead com seus parâmetros.
  • Ou Events Manager → seu dataset → Testar eventos, insira a URL do site e veja os eventos chegarem ao vivo.
  • Dispara somente no sucesso: cause uma falha e confirme que o evento NÃO dispara.

Somente depois que você conseguir ver a conversão disparar corretamente, o orçamento de anúncio deve entrar no ar. Uma conversão mal configurada faz o Meta otimizar para as pessoas erradas e você não consegue perceber pelo painel. Lista de verificação completa: references/verify-checklist.md.

"Você pode configurar isso para mim?"

A criação da conta/Página/Business-Suite/Pixel precisa do próprio login do Meta do usuário — não pode ser feita em nome dele; é uma curta caminhada na interface (esta habilidade a guia). Obter o ID do Dataset é o único trabalho do usuário. O assistente pode escrever o código base + evento no site assim que tiver o ID. Divida dessa forma — e afaste-os do assistente de CAPI e de categorias sensíveis conforme as duas decisões acima.

Arquivos de referência

  • references/install-by-platform.md — instalação do código base para Next.js, HTML, WordPress, Shopify, GTM.
  • references/standard-events.md — nomes de eventos padrão do Meta + parâmetros para conversões comuns.
  • references/conversions-api.md — o que é CAPI, quando vale a pena e as barreiras de PII/consentimento ANTES de conectá-lo.
  • references/verify-checklist.md — o portão de verificação pré-gasto (Pixel Helper, Test Events, falhas comuns).

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas