O que são postbacks? – Affiliate Top Help Center

O que são postbacks

Postback é uma solicitação HTTP automática enviada de nosso sistema (Affiliate TOP) para sua ferramenta de monitoramento de desempenho (por exemplo, Keitaro, Voluum, RedTrack) ou CRM quando um usuário realiza uma ação: se cadastra, realiza um depósito, retira fundos, instala um aplicativo, faz uma negociação, etc.

Com os postbacks, todos os dados de conversão chegam à sua ferramenta de rastreamento sem nenhum esforço manual.

Os postbacks permitem a você:

• Analisar o tráfego em tempo real

• Ajustar rapidamente seus anúncios e estratégias para melhorar os resultados da campanha e aumentar os lucros

• Encontrar e escalar bundles lucrativos e fontes de tráfego mais rapidamente

O que é a URL do postback

É um link especial para o qual nosso sistema envia dados de conversão. Ele contém parâmetros – "células" que são preenchidas com valores durante um evento: ID do clique, valor do depósito, ID do trader, ID da campanha, etc. Quando ocorre um evento, nosso sistema envia automaticamente uma solicitação a esta URL com os dados.

Onde encontrar a URL de um postback?

Obtenha essa informação na sua ferramenta de monitoramento de performance ou CRM (Keitaro, Voluum, RedTrack etc.). Consulte a documentação ou a interface da plataforma na seção de configuração de postback / rastreamento S2S.

Exemplos de URL de postback dos 3 principais rastreadores

Descubra como elas geralmente são estruturadas e familiarize-se com a adição dos nossos parâmetros.

Keitaro

Exemplo de URL de postback: http://your-keitaro.com/postback?clickid={click_id}&status=approved&payout={sumdep}

O nome do parâmetro clickid vem da documentação do Keitaro
{click_id}, {sumdep} são os nossos placeholders

Voluum

Exemplo de URL de postback: https://your-voluum.com/postback?cid={click_id}&payout={sumdep}

O nome do parâmetro cid é o nome padrão do ID do clique no rastreador Voluum
{click_id}, {sumdep} são os nossos placeholders

RedTrack

Exemplo de URL de postback:

https://your-redtrack.com/postback?clickid={click_id}&revenue={sumdep}&status=approved

Os nomes dos parâmetros clickid e revenue vêm da documentação do RedTrack
{click_id}, {sumdep} são os nossos placeholders

Importante: os nomes dos parâmetros (clickid, cid, revenue) devem corresponder exatamente aos requisitos do seu rastreador. Os placeholders ({click_id} , {sumdep}) são nossos.

Como funcionam a URL e os parâmetros de postback

Cada parâmetro consiste em duas partes:

nome do parâmetro – o que seu rastreador / CRM espera (conforme a documentação da ferramenta)
nosso placeholder entre chaves – o valor que inserimos automaticamente.

Exemplo – visitor_id={click_id}

Onde:

visitor_id – nome do parâmetro da documentação do rastreador. Enviado exatamente assim. É o nome exato em que o rastreador espera receber os dados
{click_id} – nosso placeholder. Substituído pelo ID do clique real durante o evento.

Lado esquerdo (visitor_id, campaign_id, sub_id) – requisitos do rastreador.
Lado direito ({click_id}, {campaign_id}) – dados do AffiliateTop.

Onde obter a URL de postback e nomes de parâmetros

Faça login em sua ferramenta de monitoramento de desempenho (rastreador ou CRM)
Encontre a seção de Postback / Rastreamento Server-to-Server (S2S).
Copie a URL do postback base e os nomes dos parâmetros da interface ou da documentação
Coloque a URL em nossas configurações e adicione nossos placeholders: visitor_id={click_id}, amount={sumdep}, etc.

Exemplo de estrutura completa de URL de postback

Antes do evento (com placeholders) – https://your-tracker.com/postback?visitor_id={click_id}&site_id={site_id}&trader={trader_id}&amount={deposit_amount}&campaign_id={campaign_id}

Depois do evento (valores reais) – https://your-tracker.com/postback?visitor_id=1234567&site_id=4458&trader=902134&amount=23.22&campaign_id=YT_BR_01

Parâmetros de postback: formato, exemplos e finalidade

1. ID do clique

Nosso placeholder: {click_id}
Na URL do rastreador: visitor_id={click_id} → visitor_id=1234567
Finalidade: vincula a conversão a um clique específico no anúncio. O rastreador identifica qual fonte de tráfego gerou a conversão
Significado: número único de clique recebido do seu rastreador no momento em que o clique ocorreu

2. ID do site

Nosso placeholder: {site_id}
Na URL: site_id={site_id} → site_id=4458
Finalidade: mostra qual site / posicionamento gerou tráfego com conversão. Ajuda a otimizar a compra de tráfego
Significado: ID do site ou do posicionamento na sua rede de anúncios

3. ID do trader

Nosso placeholder: {trader_id}
Na URL: trader={trader_id} → trader=902134
Finalidade: vincular todas as ações de um usuário (várias contas, depósitos, negociações) a estatísticas unificadas
Significado: ID permanente do trader emitido no primeiro cadastro

4. ID da sua conta

Nosso placeholder: {a}
Na URL: account={a} → account=a182haj2nn
Finalidade: identificar seu link de afiliado. Útil para gerenciar várias contas
Significado: seu refcode de parceiro. Normalmente, um por parceiro

5. Valor do depósito

Nosso placeholder: {sumdep}
Na URL: amount={sumdep} → amount=23.22
Finalidade: mostrar valores exatos de depósito (primeiro ou recorrente). Para o cálculo do ROI e análise de LTV
Significado: valor do depósito na moeda selecionada ($ ou ¢). Aparece apenas em eventos de depósito, como FTD ou redepósito

6. ID da transação

Nosso placeholder: {transaction}
Na URL: tx_id={transaction} → tx_id=81283192873
Finalidade: identifica exclusivamente cada conversão. Evita duplicidades e permite uma atribuição precisa
Significado: ID interno do evento específico (depósito, retirada, etc.)

7. ID da campanha publicitária

Nosso placeholder: {ac}
Na URL: campaign_id={ac} → campaign_id=YT_BR_01
Finalidade: separa as estatísticas entre diferentes campanhas (geo, criativos, páginas de destino)
Significado: nome ou ID da sua campanha de anúncios enviado por meio do link de indicação

8. ID de postback da subconta

Nosso placeholder: {sa}
Na URL: sub_id={sa} → sub_id=teaser_01
Finalidade: seus dados adicionais de análise (tipo de tráfego, criativo, webmaster)
Significado: qualquer valor do seu link de indicação (sub1, sub2, etc.)

9. Lucro

Nosso placeholder: {profit}
Na URL: profit={profit} → profit=15.75
Finalidade: mostra o valor de lucro ou prejuízo das negociações reais. Essencial para acompanhamento de receita e análise de desempenho
Significado: lucro líquido (positivo ou negativo) da atividade de negociação real do usuário. Disponível em eventos de negociações reais

Eventos de gatilho para postbacks

O Affiliate TOP suporta postbacks para as ações de usuário listadas abaixo. Um postback = um evento. Decida qual evento você deseja rastrear e digite ou clique nos parâmetros necessários para adicioná-los à sua URL de postback.

Cadastro – o usuário conclui o cadastro da conta
Confirmação do e-mail – o usuário verifica o endereço de e-mail
Primeiro depósito (FTD) – primeiro depósito do usuário
Redepósito – qualquer depósito subsequente (depósitos repetidos)
Aplicativo instalado – o usuário instala o aplicativo móvel
Primeira negociação demo – a primeira negociação do usuário na conta demo
Retirada – o usuário conclui a retirada de fundos
Negociação real – o usuário negocia na conta real de negociação

Cada evento tem seu próprio conjunto de parâmetros disponíveis que foram mencionados acima.

Como configurar o postback (Guia de Interface)

Clique em “Adicionar” para iniciar o processo de configuração do postback e preencha os campos obrigatórios conforme suas preferências.

Nome do postback – insira um nome claro e exclusivo para cada postback, para evitar confusão (ex.: "FTD_YT_BR")
Evento – selecione no modo suspenso (cadastro, primeiro depósito, etc.)
URL do postback – cole a URL do seu rastreador (consulte os exemplos acima)
Parâmetros – clique nos presets azuis abaixo do campo “URL do postback” (“ID do clique”, “valor do depósito”) para adicionar os parâmetros automaticamente
Método – GET (por padrão)
Moeda – selecione $ ou ¢ para os valores

7. Filtros de segmentação

Essa configuração permite que você decida quando o postback deve ser enviado — dependendo de qual campanha ou subconta ele está relacionado. Você pode preencher um ou ambos os campos.

Por que usar filtros de segmentação?

Eles ajudam a gerenciar o tráfego com mais precisão:

Otimizar diferentes fontes de tráfego de forma independente — se você usa mais de uma ferramenta de monitoramento de performance, pode enviar eventos básicos para uma e eventos com parâmetros adicionais para outra.
Executar testes A/B — a segmentação ajuda você a identificar quais fontes geram mais conversões e como diferentes campanhas, materiais criativos ou páginas de destino performam.
Testar ou migrar ferramentas com segurança — você pode começar a enviar postbacks para uma nova ferramenta de monitoramento de performance em paralelo com a antiga e comparar os números antes de migrar totalmente.

Como o sistema decide quando enviar o postback:

Nenhuma campanha ou subconta especificada
O postback é enviado para o evento de gatilho selecionado, independentemente da campanha ou subconta.
Apenas campanha especificada
O postback é enviado para o evento de gatilho somente se o link de rastreamento do trader incluir essa campanha específica.
Apenas subconta especificada
O postback é enviado somente se o link de rastreamento do trader incluir essa subconta específica, independentemente da campanha à qual ela pertença.
Campanha e subconta especificadas
O postback é enviado somente quando ambos os valores no link do trader correspondem à campanha e à subconta que você inseriu.

(Nota sobre a ativação: após o postback ser ativado, ele é enviado em até 15 segundos sempre que o evento selecionado e as condições forem atendidos.)

8. Ative se necessário e clique em "Adicionar"

Status do postback

Os postbacks passam por vários status durante seu ciclo de vida. Veja o que cada um significa e o que aciona a mudança de status:

Verificando (~15 segundos) – examinamos seu postback em busca de possíveis problemas quando ele é criado, editado ou copiado pela primeira vez
- Se o postback estiver correto → ele fica Ativo.
- Se houver erros → o postback muda para o Status Inativo com uma mensagem de erro mostrada na interface.
- O postback não pode ser editado ou pausado – somente excluído
Ativo – o postback está funcionando corretamente e coletando dados.
- Se editado → retorna temporariamente ao Status Verificando.
- Se receber 10 erros HTTP 3xx/4xx consecutivos → desativa automaticamente, mostra o erro na interface, e envia uma notificação por e-mail.
Inativo – o postback está desativado devido a falha de validação, desativação manual ou atingimento do limite de erros. Deve ser corrigido e revalidado para voltar a ficar Ativo.

Comportamentos-chave:

Após 10 tentativas de validação malsucedidas, a ativação requer a assistência do gerente
Postbacks ativos se automonitoram e protegem contra falhas persistentes de entrega

Logs de postback

Aqui você pode encontrar todos os postbacks realizados nos últimos 30 dias. Isso ajuda a identificar problemas de configuração e entender o que precisa ser corrigido, por exemplo.

Lista de erros possíveis:

Quando os postbacks falham, verifique a seção de Logs para conferir o código de status.

Erro 3xx – Erros de redirecionamento

O servidor diz: "Vá para este outro endereço."

Resultado: seu postback é enviado para outro lugar.

Principais causas:

- A URL do postback redireciona automaticamente (HTTP→HTTPS, www/não-www, links de rastreamento)

- O servidor ou rastreador encaminha as solicitações para outro endereço

- Seu servidor muda secretamente a URL ao longo do caminho

Como resolver?

1. Copie sua URL de postback

2. Cole-a em uma barra de endereços do navegador e clique em Enter

3. Espere até carregar (ou parar de redirecionar)

4. Copie o que você vê na barra de endereços agora — esta é a sua URL de postback

Erro 4xx – Erros de cliente

O servidor diz: "Há algo errado com a sua solicitação."

Resultado: geralmente é um problema de configuração.

Principais causas:

- 404: a URL do postback não existe (erro de digitação no caminho, domínio ou parâmetros)

- 400/422: parâmetros faltantes ou inválidos (clickid, status, valor)

- 403/401: o servidor bloqueia a solicitação (firewall, whitelist de IP, autenticação necessária)

Como resolver?

Copie sua URL de postback completa (com todos os parâmetros, como clickid)
Verifique caractere por caractere de acordo com a configuração do seu servidor
Tente abri-la em um navegador — aparece "página não encontrada"?
Corrija a parte errada (domínio, caminho ou informações faltantes) e atualize-a