Configuração de Postback S2S: Um Guia de 5 Minutos para Afiliados

O que é um S2S postback

Um postback server-to-server é uma simples requisição HTTP que sua rede de afiliados envia ao seu tracker quando uma conversão acontece. Nenhum JavaScript é executado no navegador do visitante, então bloqueadores de anúncios, regras de cookies e velocidade de página não o afetam. Por isso, é a forma padrão de contabilizar conversões no marketing de afiliados.

Como o click ID trafega

1. Um visitante clica no seu anúncio e acessa seu link de rastreamento. O tracker registra o clique e atribui a ele um click ID único.
2. O tracker redireciona o visitante para a oferta e passa o click ID junto, por exemplo como ?sub_id=….
3. A rede armazena esse valor junto ao visitante. Quando o visitante converte, a rede chama sua URL de postback com o mesmo valor.
4. O tracker associa o click ID ao clique original e adiciona a conversão e o payout à campanha, stream, landing page e oferta que o geraram.

Configurando no XPNSR Tracker

1. Passe o click ID para a oferta

Defina o parâmetro de encaminhamento do Click ID da campanha (por exemplo, clickid) e o tracker o anexará a cada URL de oferta, ou insira a macro na URL da oferta você mesmo:

https://offer.example/landing?sub_id={click_id}&country={country_code}

Use o nome do parâmetro que sua rede espera: sub_id, aff_sub, s2 e assim por diante. Os 331 presets de redes de afiliados no tracker já os conhecem.

2. Forneça à rede a sua URL de postback

https://your-tracking-domain/api/postback?click_id={clickid}&revenue={payout}&status=lead

Substitua os valores entre chaves pelos macros da sua própria rede. No painel da rede, esse campo geralmente é chamado de Postback, S2S ou Server callback.

Protegendo o postback

Qualquer pessoa que conheça a URL pode enviar conversões falsas. Cada campanha possui um segredo de postback: adicione &token=SEU_SEGREDO à URL (ou envie-o como o header X-Postback-Token) e ative Exigir token. Você também pode restringir os postbacks aos endereços IP da rede. Postbacks duplicados para a mesma conversão são ignorados.

Testes e solução de problemas

1. Abra seu próprio link de rastreamento e conclua uma conversão de teste, ou use o postback de teste da rede.
2. Abra o Log de Cliques no tracker e encontre seu clique: a conversão aparece nele em segundos.

• Nada chega: verifique a URL na rede em busca de erros de digitação e confirme que os nomes das macros correspondem exatamente à documentação da rede.
• Chega, mas não corresponde: o click ID não foi passado para a oferta. Abra a URL da oferta a partir de um clique de teste e procure por ele.
• Valores incorretos: envie o payout como número simples, sem símbolo de moeda; use currency para payouts em moedas diferentes do USD.
• Erros 401: o token está ausente ou incorreto enquanto Exigir token está ativado.