Pular para o conteúdo
Skillpedia
SEO40 mil · #5365

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

https://github.com/github/awesome-copilot/blob/main/skills/server-side-conversion-tracking/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/github/awesome-copilot/blob/main/skills/server-side-conversion-tracking/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-tracking

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/server-side-conversion-tracking/SKILL.md -o SKILL.md
Conteú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
Facebook 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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas