Opções de integração para anunciantes: postback (S2S), pixel, container, API

Modificado em Seg, 17 Ago na (o) 11:07 PM

Para pagar os publishers, a Indoleads precisa saber de cada conversão do seu lado. Escolha um dos quatro métodos — do mais confiável ao menos confiável.

Como funciona a atribuição. Cada clique no link de rastreamento de um publisher recebe um click_id único. Nós o anexamos à URL da sua oferta (por exemplo, https://yoursite.com/?click_id={click_id}), e você o devolve junto com a conversão. Uma conversão sem click_id válido (ou com security_token errado) é rejeitada. País da conversão = país do IP do clique.

1. Postback (S2S) — recomendado

Seu servidor chama a nossa URL quando um pedido/lead é confirmado:


https://app.indoleads.com/acquisition?click_id=CLICK_ID&security_token=SECURITY_TOKEN&txn_id=ORDER_ID&sale_amount=AMOUNT&currency=USD

(trk.indoleads.com funciona da mesma forma que app.indoleads.com.)

Parâmetro	Obrigatório	Significado
`click_id`	sim	O valor que passamos na URL da oferta. Armazene-o na sessão/pedido.
`security_token`	sim	Seu token por anunciante, exibido na página da oferta. Comprova que o postback veio de você.
`txn_id`	sim	Seu ID único de pedido/transação — evita duplicidades.
`sale_amount` + `currency`	um dos dois	Valor do pedido; nós calculamos o payout do publisher com base na comissão da oferta (CPS % / CPA fixo).
`rate` (ou `revenue`) + `currency`	um dos dois	Valor exato da comissão, se você mesmo o calcula; a comissão da oferta é então ignorada (payout do publisher = rate − comissão da rede).
`cat`	opcional	Código de categoria, se os payouts variam por categoria (fashion, electronics…).
`status`	opcional	`pending` (padrão), `approved`, `declined`. Envie novamente com um novo status para atualizar.
`sub1`–`sub4`	opcional	Quaisquer valores personalizados que você queira ver nos relatórios (SKU, quantidade, ID de sessão…).

Vantagens: sem cookies, não é bloqueado por navegadores/bloqueadores de anúncios, verificável (token + IPs conhecidos).

2. Pixel

Um <img> na sua página de agradecimento; o click_id é lido do cookie do visitante definido no momento do clique:


<img src="https://app.indoleads.com/api/pixel?adid=OFFER_ID&txn_id=ORDER_ID&sale_amount=AMOUNT&currency=USD">

Mesmos parâmetros opcionais do postback (rate, cat, sub1–4; o click_id pode ser passado explicitamente — deixe em branco para tráfego que não é da Indoleads). Nada a adicionar aos links de rastreamento. Desvantagem: bloqueado por alguns navegadores/extensões → use somente se não puder armazenar o click_id no servidor.

3. Container (JS)

Uma tag de script na página de agradecimento — mesma ideia do pixel, com um snippet JS: TXN_ID, RATE, CURRENCY, OFFER_ID, NETWORK = "https://app.indoleads.com". sub1–4 não são suportados.

4. API

Se a sua plataforma expõe uma API de conversões (Impact, Partnerize, Awin, TUNE, relatórios do AppsFlyer/Adjust, a sua própria), compartilhe a documentação — nossa equipe de desenvolvimento constrói a coleta do nosso lado, incluindo quaisquer campos sub que você queira armazenar.

Qual escolher?

Seu back-end consegue armazenar o click_id e enviar requisições? → Postback.
Só tem acesso ao front-end? → Pixel ou Container.
Já tem uma API/rede? → API.
Sempre envie o txn_id para evitar duplicidades.

Teste antes de ir ao ar

Abra o link de rastreamento da sua oferta em um navegador → chegue ao seu site → conclua um pedido de teste → a conversão deve aparecer no seu painel em Reports → Conversions log em poucos minutos. Se não aparecer, verifique a passagem do click_id, o token e se o pixel realmente dispara na página de agradecimento. Nosso gerente de integração faz isso junto com você.

Após o lançamento: valide as conversões

Você aprova/recusa conversões em Reports → Conversions log (botões em cada linha), via status= nos postbacks ou enviando um arquivo de reconciliação mensal — dentro do período de retenção (hold) que você definiu na oferta. Declined = não pago ao publisher. Veja Validando conversões.