Como configurar um postback (S2S) como publisher

Um postback é uma requisição HTTP que a Indoleads envia para a sua URL toda vez que uma conversão é criada ou muda de status, para que seu tracker/CRM fique sincronizado sem exportações manuais. Uma requisição por evento de conversão.

Postback global (todas as ofertas)

1. Settings → Postback → Add.
2. Cole a URL de postback do seu tracker e insira as macros clicando nelas abaixo do campo. Mínimo comum:

https://your-tracker.com/postback?cid={p1}&status={status}&payout={payout_usd}&txid={conversion_id}
— onde você passou seu click ID em p1 ao montar o link de rastreamento.

1. By events: Create only (um postback quando a conversão é registrada) ou Create and status update (também a cada mudança de status: pending → approved/declined/paid). Escolha a segunda opção se seu tracker processa atualizações de status — a maioria processa.
2. Test — a plataforma dispara uma requisição de exemplo; verifique se ela chegou ao seu tracker.
3. Save. As solicitações de postback passam por revisão; depois de aprovadas, você começa a recebê-las.

Postback por oferta: página da oferta → seção Postback → Add (mesmo formulário). Útil quando o tracker precisa de uma URL diferente por oferta.

Tokens disponíveis (clique para inserir): {conversion_id} {click_id} {status} (pending/approved/declined/paid) {payout} {payout_usd} {currency} {sale_amount} {sale_amount_usd} {txn_id} {offer_id}/{campaign_id} {offer_title}/{campaign_title} {p1}…{p4} {sub_publisher_id} {sub1}…{sub4} (parâmetros do anunciante) {conversion_date} {conversion_time} {conversion_datetime} (UTC+8) {click_time} {country_id} {ip} {agent} {referer} {publisher_id}/{aff_id} {advertiser_id}/{adv_id} {random}.

Dicas

• Seu endpoint deve responder HTTP 200 na primeira tentativa — não há novas tentativas. Se seu servidor estava fora do ar, recupere as conversões perdidas pela API /conversions.
• Os status mudam com o tempo (pending → approved), então espere vários postbacks por conversão e atualize o registro, não insira duas vezes.
• Não coloque seu token de API na URL do postback.
• Precisa de dados históricos em massa? Use o endpoint /conversions da Publisher API.

A integração do anunciante (envio de conversões para a Indoleads) é outra coisa — veja Integração do anunciante.