Como configurar o postback do anunciante (tracking S2S) no Rastro

O postback (tracking servidor a servidor, ou S2S) é a forma mais fiável de registar conversões. Quando há uma venda ou um lead, o servidor do anunciante chama um URL do Rastro com o identificador do clique que trouxe o cliente. Não há cookies nem scripts no browser, por isso os bloqueadores de anúncios e as definições de privacidade não atrapalham.

Como funciona

1. O visitante clica no link de tracking de um afiliado.
2. O Rastro regista o clique e envia o visitante para o URL de destino da oferta, trocando {click_id} por um identificador único.
3. O site do anunciante guarda esse click_id (por exemplo, com a encomenda ou com a conta do cliente).
4. Quando acontece a conversão, o servidor do anunciante chama o URL de postback com o mesmo click_id.
5. O Rastro liga a conversão ao clique, calcula o payout do afiliado e avisa o afiliado.

1. Passa o click_id ao anunciante

No URL de destino da oferta, acrescenta a macro {click_id} onde o anunciante a espera:

https://loja.example/oferta?clickid={click_id}

O nome do parâmetro (clickid, aff_sub, transaction_id…) é o que o sistema do anunciante lê. Há outras macros, como {affiliate_id} e {sub1} a {sub5}.

2. Dá ao anunciante o URL de postback

Cada anunciante tem o seu URL, com um token secreto. Encontras-o na página do anunciante (ou, se ele tiver acesso ao painel, na página Integração dele):

https://track.rastroaff.com/postback?token=TOKEN_DO_ANUNCIANTE&click_id={clickid}&txn_id={order_id}&amount={order_total}&status=approved

O anunciante troca os valores entre chavetas pelos marcadores do sistema dele. O endereço começa pelo domínio de tracking da tua rede; se usares um domínio próprio (por exemplo track.atuaempresa.com), começa por esse.

Parâmetros

Parâmetro	Obrigatório	Para que serve
token	sim	Identifica o anunciante. Mantém-no secreto; gera um novo se for exposto.
click_id	sim*	O identificador recebido no URL de destino.
txn_id	recomendado	O ID da encomenda ou do lead no anunciante. Sem ele, cada clique só pode gerar uma conversão.
amount	em CPS	Valor da venda, para calcular payouts em percentagem.
status	não	approved, pending, rejected ou reversed.
goal	não	Um objetivo da campanha com payout próprio (por exemplo goal=primeiro_deposito).
coupon	não	Atribui a conversão por código de cupão em vez de click_id (aí o txn_id é obrigatório).
country	não	O país do cliente (código de 2 letras). Ajuda a detetar fraude quando não coincide com o país do clique.

* Não é preciso quando a conversão é atribuída por coupon.

Mudar o estado de uma conversão

Envia o postback outra vez com o mesmo click_id e txn_id e o novo estado. É assim que funcionam reembolsos e chargebacks: status=reversed retira o valor do saldo do afiliado e avisa-o.

Testar

Abre o URL de postback no browser com um click_id real de um clique de teste. A conversão aparece em Conversões em segundos. Se não aparecer, o Registo de postbacks mostra cada pedido e porque foi recusado, por exemplo um click_id desconhecido, um token errado ou um clique fora da janela de atribuição.

Quando o anunciante não consegue enviar postbacks

• Pixel: uma imagem ou iframe na página de confirmação. Mais simples, mas menos fiável: os bloqueadores de anúncios podem impedi-lo, e o click_id tem de passar da página de entrada para a página de confirmação.
• API: POST /conversions com o token no cabeçalho Authorization: Bearer e um JSON (click_id, txn_id, status, amount).

Ambos seguem as mesmas regras do postback. Os URLs e os exemplos prontos a copiar estão na página de integração do anunciante.