server-side-conversion-tracking
Ajuda seu agente a configurar o rastreamento de conversões no lado do servidor. Isso garante que as vendas sejam registradas corretamente em plataformas como Facebook e Google.
O que ela faz
Essa ferramenta ajuda a garantir que suas vendas sejam registradas corretamente pelas plataformas de anúncios (como Facebook, Google, TikTok), mesmo quando os navegadores bloqueiam rastreamentos. Ela melhora a precisão dos relatórios de conversão.
Quando usar
- ✓Quando os anúncios mostram menos vendas do que você realmente teve.
- ✓Se o custo por venda parece ter aumentado sem motivo aparente.
- ✓Ao configurar novas campanhas de anúncios pagos.
Exemplo do que pedir para a IA
“Configure o rastreamento de conversões do lado do servidor para minhas campanhas.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ela captura informações importantes do cliente no momento em que ele clica no anúncio e as envia diretamente para as plataformas de anúncios. Isso contorna bloqueios do navegador e garante que as vendas sejam atribuídas corretamente.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add github/awesome-copilot --skill server-side-conversion-trackingOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/server-side-conversion-tracking/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Rastreamento de Conversão do Lado do Servidor
Pixels de navegador perdem uma parte grande e imprevisível de conversões para prevenção de rastreamento do iOS, bloqueadores de anúncios, limites de tempo de vida de cookies e saltos entre domínios. O relatório do lado do servidor corrige o relatório, que é o que o modelo de lances da plataforma de anúncios aprende. Esta habilidade cobre o modelo, a ordem de configuração e como verificá-lo.
Quando usar
- Relatórios da plataforma de anúncios mostram menos compras do que a loja/banco de dados realmente registrou
- O CPA parece ter piorado logo após uma mudança de rastreamento, sem mudança nas vendas reais
- Configurando um novo funil que receberá tráfego pago
- Perguntado sobre CAPI / Events API / importação de conversão offline / passagem de ID de clique
- Desacordos de atribuição entre plataformas ("Facebook alega 40 vendas, Google alega 30, tivemos 45 pedidos")
O modelo, na ordem em que deve ser construído
Errar esta ordem é o motivo usual para uma "configuração do lado do servidor" ainda sub-relatar.
1. Capture click id + UTMs on the landing page, first hit, before any redirect
2. Persist attach them to the visitor's session, server-side
3. Carry keep them across every funnel step, including cross-domain hops
4. Attach write them onto the order record at purchase
5. Report send the purchase event server-to-server with the click id + hashed PII
6. Dedupe give the browser event and the server event the same event id
7. Verify compare platform-reported conversions against your own order table
Pular os passos 1-4 e fazer apenas o passo 5 produz eventos de servidor sem ID de clique, que as plataformas então precisam corresponder apenas por e-mail com hash - isso é uma correspondência materialmente pior, e é a falha mais comum em uma configuração de "já fazemos CAPI".
Passo 1-2: capturar e persistir
| Plataforma | Parâmetro de ID de clique |
|---|---|
| Facebook / Instagram | fbclid |
| TikTok | ttclid |
| Google Ads | gclid (também wbraid / gbraid em app-to-web do iOS) |
| Microsoft / Bing | msclkid |
Capture também, no mesmo primeiro hit: utm_source, utm_medium, utm_campaign, utm_content, utm_term, a URL completa de destino, referenciador, user agent e o IP do cliente como visto pelo servidor. A qualidade da correspondência da CAPI do Facebook depende de client_ip_address e client_user_agent, e eles devem ser do visitante, não do seu servidor - atrás de um proxy ou CDN, leia-os dos cabeçalhos encaminhados.
Armazene do lado do servidor, com chave para uma sessão de primeira parte. Não confie em um cookie do lado do cliente que sobreviva até o checkout: no iOS, o armazenamento gravável por script pode ser limitado a 7 dias ou menos, e um salto entre domínios o quebra completamente.
Passo 3: transportar entre etapas
- Etapas no mesmo domínio: o cookie de sessão é suficiente se a sessão for do lado do servidor.
- Etapas entre domínios (página de destino em um domínio, checkout em outro): os identificadores devem ser encaminhados explicitamente no redirecionamento, e então re-persistidos no domínio receptor. É aqui que a maioria dos funis perde silenciosamente a atribuição.
- Cadeias de redirecionamento: cada salto deve preservar a string de consulta. Um redirecionamento de rastreamento que descarta
?fbclid=...destrói a atribuição para toda essa campanha.
Passo 4: anexar ao pedido
O registro do pedido deve carregar os IDs de clique, UTMs e URL de destino. É isso que torna o resto possível: transforma a atribuição em um join de banco de dados em vez de uma suposição do navegador, sobrevive a repetições e backfills, e permite reconciliar os números da plataforma contra a realidade.
Passo 5: relatar de servidor para servidor
| Plataforma | Endpoint / mecanismo | Credenciais necessárias |
|---|---|---|
| Conversions API | ID do Pixel + token de acesso | |
| TikTok | Events API | Código do Pixel + token de acesso |
| Google Ads | Importação de conversão de clique (com chave gclid) |
Ação de conversão + credenciais de desenvolvedor/OAuth |
| Microsoft Bing | Conversions API | ID da tag UET + token CAPI |
Envie com o evento: nome do evento, hora do evento, ID do evento (para deduplicação), valor do pedido + moeda, o ID do clique e identificadores de cliente com hash (e-mail, telefone) usando a normalização exigida pela plataforma - minúsculas, sem espaços extras, SHA-256 e E.164 para números de telefone. Errar a normalização degrada silenciosamente a taxa de correspondência sem nenhum erro.
Envie de uma fila com retentativas, não inline na solicitação de checkout. Um pagamento nunca deve falhar porque a API de uma plataforma de anúncios está lenta, e um evento perdido deve ser retentado em vez de perdido.
Passo 6: deduplicar
…
Perguntas frequentes
O que são 'conversões'?
Conversões são ações valiosas que você quer que seus clientes realizem, como uma compra, um cadastro ou o download de um material.
Por que os anúncios mostram menos vendas do que eu tive?
Isso acontece porque navegadores modernos, celulares (especialmente iPhones) e bloqueadores de anúncios impedem que as plataformas de anúncios rastreiem todas as ações dos usuários.
Isso vai fazer os números de todas as plataformas baterem exatamente?
Não, os números ainda podem variar um pouco entre as plataformas. O objetivo principal é ter um registro mais preciso e estável das suas vendas reais, não uma igualdade perfeita entre todos os relatórios.
Detalhes
Descrição original do autor
Set up server-side conversion tracking so purchases are reported accurately to Facebook, TikTok, Google and Bing despite iOS restrictions, ad blockers and cookie loss. Use when conversions are under-reported, when platform-reported purchases do not match real orders, when asked about Conversions API / Events API / offline conversions / CAPI, click id passthrough (fbclid, ttclid, gclid, msclkid), o
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5365
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
competitive-platform-analysis
Ajuda a entender seus concorrentes. Ele identifica, classifica e filtra empresas concorrentes antes de qualquer análise mais profunda.
affaan-m/ECC
competitive-report-structure
Cria relatórios completos sobre concorrentes. Junta informações para mostrar o cenário geral, recomendações e ajuda a alinhar a equipe.
affaan-m/ECC
lead-intelligence
Ajuda seu agente a encontrar e contatar pessoas importantes. Ele analisa leads, sugere abordagens e gerencia o contato por e-mail e redes sociais.
affaan-m/ECC