Configuração de postback para o Affiliate Top – Affiliate Top Help Center

Como configurar o postback

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

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.)

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)