Postback do afiliado: enviar as conversões do Rastro para o teu tracker ou plataforma

Os afiliados costumam acompanhar as campanhas no seu próprio tracker (Keitaro, Binom, Voluum…) ou otimizar anúncios em plataformas como o Facebook ou o TikTok. Para isso, precisam de saber de cada conversão no momento em que acontece. No Rastro, cada afiliado configura os seus postbacks e recebe as conversões automaticamente.

Onde configurar

Como afiliado, vai a Integração → Postback e acrescenta um postback. Cada um tem:

• um âmbito: todas as ofertas (geral), uma só oferta, ou um só objetivo de uma oferta;
• um método: um URL chamado por GET, um POST com os valores em JSON, ou um pixel HTML (para plataformas que só aceitam um script ou uma imagem);
• os estados que o disparam: aprovada, pendente, rejeitada ou revertida.

Cada conversão usa o postback mais específico: primeiro o do objetivo, depois o da oferta, depois o geral. Assim podes enviar, por exemplo, os registos para um sítio e os depósitos para outro.

Macros

O URL (ou o JSON) pode ter macros, substituídas pelos valores de cada conversão:

Macro	Valor
{click_id}	O identificador do clique
{conversion_id}	O ID da conversão no Rastro
{txn_id}	O ID da transação no anunciante
{goal}	O código do objetivo (vazio no evento principal da oferta)
{payout} e {currency}	O que ganhas com esta conversão
{status}	approved, pending, rejected ou reversed
{campaign_id}, {affiliate_id}	A oferta e o teu ID público
{sub1}, {sub2}, {sub3}	Os sub IDs do clique

Com um tracker externo, o habitual é passar o ID do clique do tracker no sub1 ao enviar tráfego, e devolvê-lo no postback:

https://o-teu-tracker.example/postback?cid={sub1}&payout={payout}&status={status}

As macros desconhecidas são assinaladas ao gravar, para um erro de escrita não passar despercebido.

Testar e acompanhar as entregas

Usa Enviar teste para chamar o postback com valores de exemplo e ver logo a resposta do teu servidor. A lista Últimas entregas mostra cada chamada real, a resposta HTTP e os erros.

Se uma entrega falhar (o teu servidor está em baixo ou responde com erro), o Rastro tenta de novo até 5 vezes nas 15 horas seguintes, esperando cada vez mais entre tentativas.

Bom saber

• Os postbacks só vão para endereços públicos: chamadas para redes privadas ou internas são bloqueadas por segurança.
• As mudanças de estado de uma conversão (por exemplo, um reembolso marcado como revertido) voltam a disparar o postback, se escolheste esse estado.
• Também podes receber as conversões no telemóvel, com as notificações por Telegram nas definições da tua conta.