Rastreamento por postback (S2S) para afiliados de iGaming
Um postback é a requisição server-to-server que o sistema do operador envia ao seu tracker quando um jogador se cadastra ou deposita. Como funciona, o que a URL leva e como testar.
Um postback é uma requisição HTTP que o servidor de um operador ou de um programa de afiliados envia ao seu tracker quando um jogador indicado por você converte, por exemplo com um cadastro ou um primeiro depósito. Como esse postback server-to-server (S2S) carrega o click ID, o tracker consegue creditar a conversão ao clique, à fonte de tráfego e à campanha certos, sem nenhum navegador envolvido.
Para um media buyer, esses dados transformam um relatório de gastos em um relatório de lucro: mostram quais fontes trazem depositantes, não apenas cliques.
O que é um postback?
No marketing de afiliados, o postback é um método de rastreamento de conversões: uma notificação enviada de um servidor para outro quando um evento rastreado acontece. Quem faz a chamada é o sistema que registra a conversão, normalmente o software de afiliados do operador ou uma rede de afiliados. O seu tracker de afiliados a recebe e registra a conversão no clique original.
Você também vai encontrá-lo com os nomes de rastreamento server-to-server, server postback ou callback; quanto a postback vs. callback, as plataformas de afiliados usam os termos como sinônimos. A URL de postback é o endereço no seu tracker que o programa chama.
Uma ressalva para desenvolvedores: no ASP.NET Web Forms, postback é quando uma página envia seu formulário de volta ao próprio servidor, o que não tem nada a ver com rastreamento de conversões.
Como funciona o rastreamento por postback, passo a passo
O rastreamento por postback envia um click ID com cada visitante e o recebe de volta em uma requisição de servidor quando esse visitante converte, para que o tracker possa associar a conversão ao clique. Veja um clique do início ao fim, com IDs e domínios fictícios.
O clique. Um usuário toca no seu anúncio e cai na sua URL de rastreamento, um link rastreável que aponta primeiro para o seu tracker, como
https://trk.example.com/c/41. O tracker registra fonte, campanha, criativo, dispositivo e horário, e dá ao clique um ID único, digamos7f3a9c21.A passagem. O tracker redireciona o usuário para o link da oferta do programa e anexa o click ID no parâmetro que o programa reserva para isso, muitas vezes chamado de sub ID:
https://go.example-casino.com/o/12?sub1=7f3a9c21.O cadastro. O programa armazena o click ID na conta do novo jogador. Quando o cadastro é concluído, o servidor dele envia uma requisição de postback ao seu tracker com esse ID e o nome do evento.
O depósito. Dias depois, o jogador deposita na conta pela primeira vez. O programa dispara uma segunda requisição para o mesmo click ID, agora com um payout e um status pendente.
A decisão. Após a análise do programa, uma atualização de status marca o depósito como aprovado ou rejeitado.
O repasse. O seu tracker associa cada requisição ao clique
7f3a9c21, atualiza a receita dessa campanha e pode repassar o depósito à plataforma de anúncios para que os lances dela sejam otimizados para depositantes.
O tempo varia conforme o evento. Um cadastro costuma chegar em poucos minutos. Um primeiro depósito pode chegar dias depois do clique, e a aprovação vem após o período de retenção do programa, que muitas vezes dura algumas semanas. Considere incompletos os últimos dias de qualquer relatório.
Como é uma URL de postback
Uma URL de postback tem duas partes: o endereço base no seu tracker e uma query string de parâmetros. Os nomes dos parâmetros são definidos pelo seu tracker. Cada valor é uma macro, um marcador que o programa substitui por dados reais quando a requisição é disparada.
Um modelo ilustrativo, como é inserido no painel do programa:
https://trk.example.com/postback?clickid={clickid}&event={event}&payout={payout}¤cy={currency}&txid={transaction_id}&status={status}
A mesma requisição como o seu tracker a recebe após um primeiro depósito:
https://trk.example.com/postback?clickid=7f3a9c21&event=ftd&payout=150.00¤cy=USD&txid=88412&status=pending
Normalmente é uma simples requisição HTTP GET, com todos os dados do postback na URL.
| Parâmetro | O que leva | Por que você precisa dele |
|---|---|---|
| Click ID | O ID que o seu tracker criou, devolvido | O único vínculo entre uma conversão e o seu clique |
| Evento | Cadastro, FTD, depósito recorrente | Permite pagar e otimizar por evento |
| Payout | A sua comissão por este evento | Leva receita e ROI para os relatórios |
| Moeda | USD, EUR etc. | Evita misturar moedas nos totais |
| ID da transação | Um ID único para esta conversão | Deduplicação e eventos repetidos em um mesmo clique |
| Status | Pendente, aprovado, rejeitado | Separa o dinheiro retido do dinheiro ganho |
A sintaxe das macros não é padronizada: uma plataforma usa chaves, outra cerquilhas, e os nomes dos parâmetros variam conforme o tracker. Copie ambos da documentação do programa e do tracker.
Quais eventos são enviados no iGaming
No iGaming, os programas costumam reportar cadastros, primeiros depósitos e as mudanças de status deles, e um mesmo jogador pode gerar várias conversões por postback, dependendo do programa e do seu acordo.
Cadastro. O jogador abre uma conta. Um sinal inicial, e o evento pago nos acordos CPL.
FTD (primeiro depósito). O evento pelo qual a maioria dos acordos CPA paga. O campo payout pode trazer o valor do CPA, ou zero em um acordo RevShare.
FTD qualificado. Alguns programas enviam um evento separado quando o depósito atinge o baseline do acordo, como um depósito mínimo ou um volume mínimo de apostas.
Depósitos recorrentes. Enviados por alguns programas; úteis para avaliar o valor do jogador.
Mudanças de status. Um FTD pendente passa a aprovado, ou a rejeitado após verificações de contas duplicadas, abuso de bônus ou fonte de tráfego. Um chargeback pode revertê-lo mais tarde.
Os ganhos de RevShare costumam ser fechados em relatórios mensais, e não por postback, embora algumas plataformas enviem atualizações de receita. CPA vs RevShare vs híbrido explica como cada modelo paga.
Nem todo programa oferece postbacks, e algumas plataformas ativam por padrão apenas o evento de cadastro, então pergunte antes de montar a estrutura. Dar lances e cortar fontes com base em FTDs aprovados, e não em cadastros, amarra as suas decisões ao evento pelo qual você é pago.
Postback vs. rastreamento por pixel: por que o S2S é o padrão
O S2S é o padrão porque a requisição parte do servidor do programa, então limites de cookies, bloqueadores de anúncios e eventos tardios não custam conversões como acontece com um pixel no navegador.
Um pixel é um trecho de código que carrega no navegador do jogador, normalmente em uma página de confirmação, e chama o seu tracker a partir dali. Ele só funciona se esse navegador ainda guardar o cookie do clique e deixar a requisição sair.
Os navegadores dificultam as duas coisas. O Safari bloqueia cookies de terceiros por padrão desde março de 2020. Desde 2019, a prevenção de rastreamento dele também limita a sete dias os cookies definidos por scripts. Bloqueadores de anúncios podem impedir totalmente as chamadas do pixel. Uma requisição de servidor evita tudo isso.
| Postback S2S | Pixel | |
|---|---|---|
| Parte de | O servidor do programa | O navegador do jogador |
| Associa o clique por | Click ID na URL | Normalmente um cookie |
| Bloqueadores de anúncios, limites de cookies | Não é afetado | Pode perder conversões |
| Eventos dias ou semanas depois | Enviados quando acontecem | Só se o jogador carregar uma página com o pixel |
| Configuração | URL e macros dos dois lados | Código na página do anunciante |
Os pixels continuam em uso quando um programa não tem opção de servidor, ou em landing pages que você controla. A atribuição baseada em cookies também é mais fácil de fraudar, como mostra o cookie stuffing.
As plataformas de anúncios usam a mesma lógica do lado do servidor. A Conversions API da Meta recebe eventos do seu servidor. Em outubro de 2026, o método de deduplicação recomendado pela Meta associa um evento de pixel e um evento de servidor com o mesmo ID e o mesmo nome de evento, e só os mescla se ambos chegarem em até 48 horas.
Como configurar e testar um postback
Configurar significa alinhar as definições no programa e no seu tracker: o click ID sai no link da oferta, a URL do seu tracker vai para o painel do programa, e uma conversão de teste comprova que os dois funcionam.
Reúna as informações. Com o affiliate manager ou na documentação do programa, obtenha o parâmetro do click ID, as macros suportadas, os eventos e status disponíveis, e se a URL é definida por oferta ou globalmente.
Monte a URL no tracker. A maioria dos trackers gera um modelo para os programas que conhece. Para qualquer outro programa, mapeie manualmente cada parâmetro do tracker para a macro correspondente.
Envie o click ID. Adicione-o ao link da oferta na sua campanha do tracker, no parâmetro sub ID do programa.
Instale a URL. Cole-a no painel do programa, uma entrada por evento, se necessário.
Mapeie os status. Pendente, aprovado e rejeitado devem chegar como estados separados.
Teste a entrega. Abra o link da sua campanha em uma sessão limpa do navegador, confirme que o click ID chegou ao programa e então conclua um cadastro de teste ou peça ao affiliate manager que dispare um postback de teste.
Leia o log. Algumas plataformas registram cada requisição de postback com o código de resposta do seu servidor. Um 200 significa que o seu tracker a aceitou; um 4xx ou 5xx aponta para o seu endpoint.
Sirva o endpoint do tracker via HTTPS e teste de novo sempre que qualquer um dos lados mudar o formato dos links.
Problemas comuns de postback e como resolvê-los
A maioria dos problemas de rastreamento vem de um click ID perdido na ida, uma macro ou um parâmetro errados, ou requisições que nunca chegam ao tracker. A solução costuma começar por rastrear um clique de ponta a ponta e comparar os logs dos dois lados.
Click ID perdido na ida. Um prelander ou um redirecionamento extra descarta a query string. Siga a cadeia salto a salto e procure o ID no relatório de cliques do programa.
Macro ou nome de parâmetro errado. Algumas plataformas diferenciam maiúsculas e minúsculas nos nomes de parâmetros e ignoram qualquer outra grafia, então o click ID volta vazio. Copie nomes e macros exatamente.
URL quebrada. Valores sem codificação, espaços perdidos ou um segundo
?onde deveria haver um&corrompem a requisição.Mapeamento de status. Se depósitos pendentes contam como aprovados, o ROI parece melhor do que é até as rejeições chegarem.
Duplicatas. Novas tentativas podem disparar o mesmo evento duas vezes, então baseie a deduplicação no ID da transação. Pelo menos um tracker amplamente usado conta cada par de click ID e ID da transação uma única vez e, por padrão, descarta um click ID repetido sem um novo ID da transação.
Requisições que nunca chegam. Indisponibilidade, um certificado expirado ou uma regra de firewall podem bloquear as chamadas recebidas. Compare o log de requisições do programa com o do seu tracker.
Totais que não batem com o relatório do operador. Aprovações tardias, FTDs rejeitados, conversão de moeda e horários de fechamento dos relatórios abrem diferenças. As rejeições também são a forma como os operadores filtram fraudes; veja fraude de afiliados no iGaming.
Perguntas frequentes
O que é uma URL de postback?
Uma URL de postback é o endereço no seu tracker que um programa de afiliados chama quando acontece uma conversão. As macros do programa preenchem os parâmetros dela, como click ID, evento, payout e status.
O que significa “postback” no marketing de afiliados?
No marketing de afiliados, um postback é um aviso server-to-server de que um jogador indicado converteu. O operador ou a rede informa ao seu tracker qual clique gerou o cadastro ou o depósito, e quanto ele paga a você.
O que é uma URL de rastreamento e como ela difere de uma URL de postback?
Uma URL de rastreamento é o link em que o seu tráfego clica; ela registra o clique e cria o click ID. O programa chama a URL de postback depois, para informar no que aquele clique se transformou.
Postback ou pixel: qual é mais confiável?
Em regra, o rastreamento S2S é mais confiável do que um pixel para programas de operadores. Ele não precisa de cookie do navegador, os bloqueadores de anúncios não o enxergam e as aprovações tardias continuam chegando. Um pixel é mais rápido de instalar, mas pode perder conversões em navegadores que limitam cookies.
Como testo se um postback está funcionando?
Para testar um postback, clique no link da sua própria campanha, confirme que o programa recebeu o click ID e então dispare um postback de teste. O tracker deve registrar o evento e o payout corretos, e qualquer log de requisições do lado do programa deve mostrar uma resposta 200.
Por que o meu tracker mostra menos conversões que o operador?
Um tracker costuma mostrar menos conversões que o operador por causa de um click ID perdido em um redirecionamento, de uma macro errada ou de um evento que o programa não envia. Mais conversões no tracker do que no relatório do operador geralmente significam FTDs pendentes que foram rejeitados depois.
Fontes
Everflow Helpdesk, "Understanding tracking with server-to-server postbacks"
Everflow Helpdesk, "How to test partner postbacks"
Voluum Documentation, "Parameters in Postback URLs"
Voluum Documentation, "Upselling: Tracking subsequent conversions"
Offer18 Knowledge Base, "iGaming - Postback"
Referly Help Center, "Postback URL"
Meta for Developers, "Handling Duplicate Pixel and Conversions API Events"
Microsoft Learn, "Page.IsPostBack Property"
