Como configurar postback S2S sem perder conversões

Published : 12 out. 2026   author : Indoleads Content Team

Uma venda aparece no painel do anunciante, mas não no seu tracker. Ou o lead foi contabilizado pela rede, mas a campanha continua parecendo deficitária para o gestor de tráfego. Saber como configurar postback S2S corrige essa lacuna: ele envia o evento de conversão entre servidores e devolve ao afiliado o dado necessário para medir receita, ROI e qualidade do tráfego.

Para quem compra mídia, trabalha com múltiplas fontes ou opera ofertas CPA, CPS, CPL e CPI, o postback server-to-server não é um detalhe técnico. É a base para pausar criativos improdutivos, escalar campanhas rentáveis e identificar de onde vêm as conversões aprovadas. Uma configuração incompleta pode transformar uma boa operação em decisões tomadas com dados errados.

O que é postback S2S e por que ele afeta o lucro

O postback S2S, também chamado de callback, é uma requisição enviada pelo servidor da rede de afiliados ou do anunciante para o servidor do seu tracker quando uma ação é registrada. Essa ação pode ser uma venda, um cadastro validado, uma instalação de aplicativo ou outro objetivo previsto na oferta.

O ponto central é o identificador do clique. Quando uma pessoa acessa o seu link de afiliado, o tracker gera um ID único, geralmente chamado de `click_id`, `subid` ou `cid`. Esse valor precisa acompanhar o clique até a rede. Quando ocorre a conversão, a rede devolve o mesmo ID no postback. Assim, o tracker associa a receita ao anúncio, à campanha, ao posicionamento, à palavra-chave ou ao publisher que originou o resultado.

Isso diferencia o S2S de uma simples confirmação por pixel no navegador. O pixel depende de cookies, carregamento de página e consentimento do usuário. Já o postback é enviado entre sistemas, o que reduz perdas relacionadas a bloqueadores, navegadores restritivos e interrupções na jornada. Ele não elimina toda divergência possível, porque cancelamentos, atribuição e aprovações ainda variam conforme a oferta, mas oferece uma medição mais estável para otimização.

Antes de configurar o postback S2S

A integração funciona apenas quando os parâmetros estão alinhados nos dois lados. Primeiro, defina onde os dados serão recebidos: pode ser um tracker de afiliados, uma plataforma própria ou um endpoint desenvolvido pela sua equipe. Em seguida, verifique qual macro de identificação a rede aceita no link de campanha e qual macro ela devolve no postback.

Também é necessário confirmar o evento que deve disparar a notificação. Em algumas ofertas, a conversão é comunicada logo após o cadastro. Em outras, especialmente em ecommerce, ela só é enviada após pagamento confirmado, prazo de validação ou aprovação manual. Se o objetivo for calcular lucro líquido, configure o sistema para considerar o status correto, e não apenas a conversão inicial.

Antes de publicar qualquer URL, tenha estes dados organizados:

  • o parâmetro que transportará o ID do clique, como `subid` ou `click_id`;
  • a URL de postback gerada pelo seu tracker;
  • as macros disponíveis para ID, valor de comissão, moeda e status;
  • a regra de atribuição e o prazo de aprovação da oferta.

Essa checagem evita o erro mais frequente: inserir uma macro que parece correta, mas não é reconhecida pela plataforma. Uma URL tecnicamente válida pode receber requisições sem o identificador necessário e, portanto, não registrar nenhuma conversão de forma útil.

Como configurar postback S2S em 5 etapas

1. Gere a URL no seu tracker

No tracker, crie uma fonte de tráfego, uma campanha ou uma oferta, conforme a estrutura da ferramenta. O sistema fornecerá uma URL de postback com um espaço reservado para o identificador do clique. Um formato comum é algo como `https://seu-dominio.com/postback?click_id={click_id}&payout={payout}`.

A estrutura exata muda entre plataformas. O que não muda é a lógica: o campo `click_id` deve receber o mesmo valor criado no momento do clique, enquanto `payout` deve receber o valor da comissão quando esse dado estiver disponível. Evite editar parâmetros que o tracker exige para autenticação ou deduplicação.

2. Passe o ID do clique no link de afiliado

Agora, inclua no link fornecido pela rede o parâmetro que ela utiliza para guardar o identificador. Se a rede aceitar `subid`, o seu tracker deverá inserir dinamicamente o ID naquele campo. Em um modelo genérico, o link pode terminar com `&subid={click_id}`.

Não substitua `{click_id}` por um texto fixo. Essa variável deve ser preenchida a cada visita. Se todos os cliques receberem o mesmo valor, o tracker não conseguirá determinar qual anúncio gerou cada conversão, e os relatórios perderão valor operacional.

Ao operar campanhas com subafiliados, criativos ou canais diferentes, utilize parâmetros adicionais. Eles não substituem o ID principal, mas ajudam a detalhar a análise. Por exemplo, um parâmetro pode registrar a fonte de tráfego, enquanto outro identifica a variação do anúncio. A regra é simples: guarde dados que você realmente pretende usar para tomar decisões.

3. Cadastre a URL de postback na rede

No painel da rede, localize a área de postback, tracking ou ferramentas do afiliado e insira a URL recebida do tracker. Troque os espaços reservados genéricos pelas macros reais disponibilizadas pela plataforma. Se a macro da rede para subid for `{subid}`, ela precisa preencher o campo de ID na sua URL. Se a macro para comissão for `{payout}`, ela deve ocupar o campo de valor.

Uma configuração genérica ficaria assim: `https://seu-dominio.com/postback?click_id={subid}&payout={payout}¤cy={currency}`. Use esse exemplo apenas como lógica, não como URL pronta. Os nomes aceitos variam entre plataformas e ofertas.

Na Indoleads, vale verificar no painel ou com o suporte quais macros estão habilitadas para a campanha selecionada, principalmente quando houver regras específicas de validação ou moedas diferentes. Essa confirmação é mais eficiente do que tentar deduzir o comportamento pelo relatório final.

4. Defina status e valor com precisão

Nem todo evento recebido deve ser contabilizado como receita definitiva. Se a rede enviar status como pendente, aprovado ou recusado, configure regras no tracker para separar esses resultados. Uma venda pendente pode ser útil para leitura de volume, mas não deve justificar aumento de orçamento como se fosse comissão confirmada.

O mesmo cuidado vale para o payout. Em ofertas de comissão variável, envie o valor dinâmico retornado pela rede. Em ofertas de valor fixo, um payout estático pode funcionar, mas precisa ser atualizado se as condições comerciais mudarem. Ignorar essa diferença distorce o ROI e pode levar a escalar tráfego que parece rentável apenas no relatório.

5. Faça um teste controlado

Salve a configuração e teste o fluxo completo. Gere um clique real, confira se o ID chegou ao link de afiliado e solicite um teste de conversão quando a rede oferecer esse recurso. Depois, verifique o log do tracker para confirmar se a requisição foi recebida e se o clique foi atribuído à campanha correta.

O ideal é validar quatro elementos: código de resposta do endpoint, ID do clique, status da conversão e valor da comissão. Um retorno HTTP 200 indica que o servidor recebeu a requisição, mas não garante que a receita foi atribuída corretamente. A validação precisa ir até o relatório final.

Erros que causam perdas de atribuição

O erro mais comum é a incompatibilidade entre parâmetros. O afiliado passa `click_id` no link, mas a rede está configurada para salvar `subid`, ou o postback devolve uma macro diferente da que foi cadastrada. Revise cada nome de parâmetro do clique até a URL de retorno.

Outro problema recorrente é codificar a URL de modo incorreto. Caracteres como `?`, `&` e espaços podem ser alterados quando uma URL é inserida dentro de outro sistema. Se o tracker disponibilizar um modelo pronto para copiar, preserve a estrutura e faça somente as substituições exigidas pelas macros da rede.

Também há divergências legítimas. A rede pode atribuir uma venda ao último clique elegível, enquanto o seu tracker mostra todos os cliques recebidos. Além disso, devoluções, fraude, duplicidade e leads inválidos podem reduzir o total aprovado dias depois. O objetivo não é exigir números idênticos em tempo real, mas entender a regra de cada plataforma e acompanhar a diferença dentro de um limite aceitável.

Por fim, não misture dados de ambientes distintos. Testes, campanhas ativas e diferentes fontes de tráfego devem ter identificação própria. Quando tudo passa pelo mesmo parâmetro sem organização, encontrar a origem de uma falha se torna caro e demorado.

Como usar os dados após a integração

Uma vez que o postback esteja funcionando, o relatório deixa de ser apenas uma contagem de conversões. Você pode comparar receita aprovada por campanha, custo por aquisição por fonte, desempenho de criativos e retorno por país ou dispositivo. Esse nível de leitura é especialmente relevante em operações internacionais, nas quais moeda, prazo de aprovação e comportamento de compra variam entre mercados.

Ainda assim, a melhor configuração depende do modelo de negócio. Um publisher de conteúdo pode priorizar atribuição por página e produto, enquanto um media buyer precisa analisar zone ID, campanha e criativo em ritmo diário. Comece com os parâmetros que sustentam a sua decisão mais imediata e amplie o rastreamento à medida que a operação exigir.

Postback S2S bem configurado não serve apenas para provar que uma conversão aconteceu. Ele cria uma cadeia confiável entre clique, comissão e investimento – exatamente o que permite transformar tráfego em uma operação de performance previsível.

Other categories