O lead foi gerado, a rede o enxerga, e no tracker aparece zero. Quase todo mundo que configurou o primeiro funil já passou por isso. Em nove de cada dez casos, o problema está no postback: ou não foi configurado, ou envia o número de clique errado. Vamos entender como funciona, para resolver esse tipo de situação em um minuto.
O que é postback, em palavras simples
Postback (retorno de chamada) é uma requisição HTTP automática pela qual um sistema avisa outro sobre um evento. No marketing de afiliados, o evento é a conversão: lead, venda, cadastro, depósito. A rede de afiliados envia a requisição para o postback URL do seu tracker e, nos parâmetros, passa o número do clique, o status e a comissão.
Este é um postback típico recebido pelo tracker vindo da rede:
https://tracker.example/postback?click_id=8f3a1c27&status=approved&payout=24.00¤cy=USD&txid=99817
Dessa linha o tracker entende:
- click_id: a qual clique a conversão pertence;
- status: o que aconteceu: lead, aprovação, recusa;
- payout: quanto você vai receber;
- txid: o número da transação na rede, para que as próximas mensagens atualizem o mesmo registro.
Postback S2S, pixel e outras formas de enviar conversões
Há várias formas de saber de uma conversão. Cada uma tem suas limitações.
| Forma | Como funciona | Prós | Contras |
|---|---|---|---|
| Postback S2S | O servidor da rede envia uma requisição ao servidor do tracker | Não depende do navegador, informa mudança de status | É preciso passar o click id corretamente para a oferta |
| Pixel na página de obrigado | Uma imagem ou script carrega no navegador do comprador | Serve para landing própria | É bloqueado e não fica sabendo de aprovação ou recusa |
| Código JS na página de obrigado | Um script envia o evento a partir do navegador | Flexível | Os mesmos problemas do pixel |
| Código no processador do formulário | Seu servidor avisa o tracker sobre o lead | Confiável para site próprio | Exige acesso ao código do site |
| Upload manual | Exportação da rede e importação | Sempre funciona | Atraso, trabalho manual |
Para trabalhar com redes de afiliados, o padrão é o postback de servidor. Pixel e código no formulário servem quando você leva o tráfego para uma landing própria com formulário e você mesmo faz o papel da "rede".
Como funciona o postback URL: macros e parâmetros
No painel da rede de afiliados, você cola o endereço de postback não com valores concretos, e sim com macros: marcadores entre chaves ou colchetes que a rede substitui antes de enviar.
https://tracker.example/postback?click_id={sub1}&status={status}&payout={payout}&txid={transaction_id}
Os nomes das macros variam de rede para rede: em umas é {sub1}, em outras {aff_sub}, [clickid] ou {subid}. É preciso conferir na documentação da rede. Mas a lógica é sempre a mesma: o postback devolve o parâmetro em que você passou o número do clique no link da oferta.
O link da oferta e o postback são as duas metades do mesmo esquema:
# Link da oferta: passamos à rede o número do clique em sub1
https://network.example.com/click?offer=55&sub1={click_id}
# Postback no painel da rede: a rede devolve o conteúdo de sub1
https://tracker.example/postback?click_id={sub1}&status={status}&payout={payout}
Na primeira linha, {click_id} é a macro do tracker; na segunda, {sub1} é a macro da rede. Trocar uma pela outra é o erro clássico. Mais sobre quem gera qual número no artigo sobre click id e SubID.
Status no postback
A rede pode enviar um postback por evento ou vários, um a cada mudança de status. Os mais comuns:
| Status na rede | Significado |
|---|---|
pending, hold |
Lead recebido, aguardando análise |
approved, confirmed |
Aprovado, haverá pagamento |
rejected, refund, declined |
Recusado ou estornado |
fraud, trash |
Lead lixo, sem pagamento |
O tracker precisa saber a correspondência entre esses valores e os seus próprios status. A análise completa com exemplos está no artigo «Status de conversão: lead, em espera, aprovado, recusado».
Como configurar o postback passo a passo
A ordem é a mesma para a maioria das combinações «tracker + rede de afiliados».
- Descubra em qual parâmetro a rede recebe o número do clique. Normalmente é
sub1,aff_sub,subidouclick_id. A resposta está na documentação da rede ou com o gerente. - Adicione o parâmetro ao link da oferta. Por exemplo,
&sub1={click_id}, em que{click_id}é preenchido pelo seu tracker. - Pegue no tracker o endereço de postback dessa rede e coloque as macros da rede.
- Cole o endereço no painel da rede, normalmente na seção «Postback», «Postback global» ou nas configurações da oferta.
- Escolha os eventos em que a rede envia o postback: lead, aprovação, recusa.
- Teste a cadeia: clique no link do anúncio, encontre o número do clique no log, gere um lead de teste ou envie o postback manualmente.
Dica. Se a rede tem um botão de «Postback de teste», não comemore o check verde. Ele só verifica se o endereço responde, e não se o seu click id realmente chega. O teste de verdade é um clique no link real e um lead.
Por que o postback não chega: diagnóstico
Procure o problema em ordem, do clique ao tracker.
O número do clique não chegou à rede
Abra o link da oferta para onde o visitante vai e veja os parâmetros. Se aparece sub1= vazio ou sub1={click_id} literal, o tracker não preencheu o valor. Verifique o nome da macro.
A rede não enviou o postback
No painel da rede costuma haver um log de postbacks. Se não há requisição, o postback não está ativado para essa oferta ou evento.
O postback chegou, mas o clique não foi encontrado
O tracker recebeu um número, mas não tem esse clique. Causas: foi passado à rede o número de outro sistema (por exemplo, fbclid em vez do número do tracker), o clique foi apagado junto com o fluxo, ou você trocou a chave de recebimento de postbacks e a rede ficou com o endereço antigo.
Chegou, mas sem valor
Se a rede não envia a comissão, o tracker deve usar o preço definido nas configurações da oferta. Senão, a receita fica zerada mesmo com conversões reais.
Postback na ArtisanClo
Na ArtisanClo, o endereço de recebimento de conversões é um só para a conta inteira, mostrado na seção «Recebimento de conversões». Lá também estão cerca de 300 modelos prontos de redes de afiliados: o modelo já indica em qual parâmetro a rede recebe o número do clique, como os status dela correspondem aos nossos, e traz o endereço de postback pronto para o painel da rede. Se a rede não estiver na lista, dá para adicioná-la como personalizada.
No fluxo (modos com tracker), para cada oferta você escolhe a rede e clica em «Mostrar o endereço de postback para o painel da rede». A janela indica três passos (copiar, colar no painel da rede, aguardar a primeira conversão) e mostra uma verificação ao vivo: «Aguardando…» → «Chegou e foi vinculado ao clique — está tudo funcionando». O parâmetro do endereço da oferta pelo qual a rede recebe o número do clique é adicionado com um botão; se você não adicionar, ele é incluído automaticamente ao salvar.
Como os postbacks recebidos são registrados:
- os status das redes são convertidos automaticamente:
approvedvira Venda,pendingvira Em espera,refundvira Rejeitada,fraudvira Lixo, status vazio vira Lead; - um status desconhecido é registrado como «Lixo», com receita zero, para que um erro de configuração não vire lucro falso;
- uma nova mensagem com o mesmo número de transação atualiza o registro: é assim que a rede aprova ou revoga um lead;
- se o valor não vier, usa-se o preço do lead ou da venda definido na oferta, e a moeda é convertida em dólares pela cotação diária do BCE.
Para diagnóstico, em «Recebimento de conversões» há um registro das últimas 20 mensagens recebidas nas últimas 72 horas, com o resultado: «lead registrado», «clique não encontrado», «sem click_id», «cloaking sem tracker» e outros. Por ele se vê na hora em que elo a cadeia se rompe.
Se você trabalha com seu próprio tracker e a ArtisanClo fica como cloaker na frente dele, no passo «Tracker» escolhe-se o tracker externo (Keitaro, Binom, RedTrack, Voluum e outros). O painel mostra um parâmetro do tipo external_id={click_id} para o link da oferta e o status: «As conversões já estão chegando», «Os postbacks chegam até nós, mas nenhum foi vinculado a um clique ainda» ou «Falta um passo: aponte o postback do seu tracker para o nosso endereço». A lista de trackers está na seção de integrações com trackers.
Para landing com formulário próprio, em vez do postback da rede, há as opções de «Site próprio»: código PHP para o processador do formulário, JS para a página de obrigado ou pixel.
Postback global ou postback por oferta
Nos painéis das redes de afiliados normalmente há dois níveis de configuração, e a escolha define quanto trabalho manual você vai ter.
| Nível | Como funciona | Quando é cômodo |
|---|---|---|
| Postback global | Um endereço para todas as ofertas da conta | Você passa todo o tráfego por um único tracker |
| Postback da oferta | Endereço próprio para uma oferta específica | Ofertas diferentes vão para trackers diferentes, ou há parâmetros especiais |
Se o seu tracker tem um único endereço de recebimento por conta, o postback global é o caminho mais simples: configura uma vez e as ofertas novas já enviam conversões. O postback por oferta serve quando parte do tráfego vai para outro tracker ou quando a rede usa outras macros para aquela oferta.
Segurança do endereço de postback
O endereço de postback é, na prática, uma chave com a qual qualquer um pode gravar uma conversão no seu tracker. Por isso:
- não publique o endereço em grupos abertos nem em prints;
- se o endereço vazar, troque a chave de recebimento e atualize o endereço em todas as redes;
- revise de tempos em tempos o registro de postbacks recebidos: conversões de cliques inexistentes são motivo de alerta.
Atrasos e repetições
O postback nem sempre chega na hora. As redes enviam o lead imediatamente e a aprovação horas ou dias depois, quando o call center processou o pedido. Algumas redes repetem o envio em caso de falha. Por isso o tracker precisa aceitar com tranquilidade uma mensagem repetida da mesma transação, sem criar conversão nova. Se o relatório mostrar o dobro de leads da rede, verifique primeiro como o tracker trata as repetições.
Postback para a plataforma de anúncios
Há também o sentido inverso: não é a rede que avisa o tracker, e sim o tracker que avisa a plataforma de anúncios. Também é um postback, só que na outra direção: a plataforma recebe o próprio número de clique (por exemplo, ttclid ou gclid) e o evento de conversão, para que o algoritmo aprenda com compradores. Detalhes no artigo sobre envio de conversões para as plataformas de anúncios. Quais números de clique as plataformas passam está no material sobre fbclid, gclid, ttclid, yclid.
Resumo
O postback é a ponte entre a rede de afiliados e o tracker, e ela se apoia num único valor: o número do clique. Passe-o no link da oferta, devolva-o pelo mesmo parâmetro no postback URL, configure a correspondência de status e teste a cadeia com um clique real. Quando os postbacks chegam com regularidade, dá para partir para o principal: calcular o lucro e o ROI por recorte. A lista de redes com modelos prontos está no catálogo de redes de afiliados.
