Postback da Betano e da Superbet: como configurar o FTD

Rastrear FTD de casa de aposta no Brasil é um problema de duas metades, e quase todo afiliado resolve só uma. A primeira metade é mandar um identificador único para a casa junto com o clique. A segunda é receber esse identificador de volta quando o depósito acontece. Se qualquer uma das duas falhar, o painel da casa mostra receita e o seu tracker mostra zero — e você fica sem saber qual criativo, qual campanha e qual fonte pagaram a conta.

Este guia é específico para Betano e Superbet porque as duas rodam no Income Access e, apesar disso, não usam o mesmo parâmetro. Confundir os dois é o erro número um de quem está começando a ligar postback.

O modelo mental: click_id entra, postback volta

O fluxo, em quatro passos:

1. O usuário clica no seu link de redirect: https://go.example.com/r/bet-tiktok-01
2. O tracker grava o clique (IP, país, device, campanha, fonte, sub) e gera um click_id único.
3. O tracker redireciona para a URL da casa, substituindo a macro {click_id} pelo valor real no parâmetro que a casa aceita.
4. Quando o usuário deposita, a casa chama a sua URL de postback devolvendo aquele mesmo identificador, mais o evento e o valor.

Esse é o desenho de qualquer rastreamento server-to-server. A parte que muda de casa para casa é só o nome dos campos. Vale a pena ler a explicação completa em como funciona o tracking e a atribuição antes de mexer nas configurações, porque tudo depois disso é detalhe de nomenclatura.

Betano: parâmetro subid

A Betano recebe o identificador em subid. A URL de oferta fica assim:

https://betano.example/afiliado?btag=SEU_ID&subid={click_id}

Onde {click_id} é a macro do Affilitrack, substituída no momento do redirect. Você nunca digita o valor à mão — a macro faz isso.

No retorno, o Income Access dispara algo nesse formato:

https://go.example.com/pb?subid=[Acid]&status=sale&amount=[Amount]&txid=[TransactionID]

Repare em dois pontos:

• [Acid] é o placeholder da plataforma da casa. Você cola a URL com o placeholder literal; quem substitui é o Income Access, não você.
• status costuma vir como sale (depósito/venda) ou lead (cadastro). É esse campo que separa um registro de um FTD.

Mapeamento do merchant Betano

Na tela de merchants você declara qual campo é o quê:

E dentro do evento você traduz os valores: sale vira FTD (ou depósito, conforme seu contrato) e lead vira cadastro. Esse mapeamento é feito na interface e entra em vigor na hora, sem precisar de deploy ou de suporte. É exatamente o ponto descrito em configuração de postback S2S.

Superbet: parâmetro c

A Superbet usa o mesmo Income Access, mas a entrada é o parâmetro c:

https://superbet.example/afiliado?btag=SEU_ID&c={click_id}

E o retorno não devolve em c. Devolve em clickid:

https://go.example.com/pb?clickid=[acid]&amount=[Amount]&txid=[TransactionID]

Ou seja: entra em c, volta em clickid. É assimétrico, e é por isso que copiar a configuração da Betano e trocar o nome da casa não funciona.

Mapeamento do merchant Superbet

Se o programa da Superbet não mandar um campo de status separado, você pode tratar todo postback recebido naquele merchant como um único evento (normalmente FTD) e usar o valor para diferenciar. A lista de casas já mapeadas fica em integrações com casas de aposta; se a sua não estiver lá, o mapeamento manual resolve em minutos.

Comparando as duas em uma tabela

A diferença de caixa no placeholder ([Acid] contra [acid]) parece detalhe, mas é literal: cole exatamente como o painel da casa documenta.

Por que macros desconhecidas não podem ser destruídas

Um detalhe que quebra integração em tracker mal feito: a URL da oferta tem macros suas ({click_id}, {country}, {campaign_id}, e mais umas trinta) e placeholders da rede ([Acid], [Amount]). Se o tracker tentar interpretar tudo e apagar o que não reconhece, o placeholder da casa some e o postback volta vazio.

No Affilitrack, macro desconhecida é preservada intacta. O que é seu é substituído; o que é da rede passa direto. Isso permite colar a URL do painel da casa sem editar nada e só acrescentar o parâmetro do click_id.

Token, domínio próprio e a URL de recebimento

Você tem dois caminhos para a URL de postback:

Com token de workspace — a URL genérica identifica a sua conta pelo token:

https://postback.affilitrack.example/postback?token=SEU_TOKEN&subid=[Acid]&status=sale&amount=[Amount]

Com domínio de tracking próprio — o domínio já é seu, então a conta é identificada por ele e o token pode ser dispensado:

https://go.seudominio.com.br/pb?subid=[Acid]&status=sale&amount=[Amount]

A segunda forma é mais curta, mais limpa de colar no painel do programa e não expõe um token em um campo que várias pessoas do time da casa conseguem ver. O domínio próprio é configurado por CNAME e o certificado TLS é emitido automaticamente via Let's Encrypt, sem você tocar em servidor. Os detalhes de infraestrutura estão em visão geral da plataforma.

Validando: os quatro estados de um postback

Depois de configurar, não confie no "parece que está funcionando". Todo postback recebido fica registrado com um estado:

• Casado — o identificador bateu com um clique existente e virou conversão. É o que você quer.
• Duplicado — mesmo txid/click_id já processado. A deduplicação bloqueou. Se veio com valor divergente, a conversão original é mantida e a divergência fica no log para auditoria.
• Órfão — chegou um identificador que não existe na base de cliques. Quase sempre é macro não substituída, valor truncado pela casa, ou tráfego que não passou pelo link de redirect.
• Inválido — payload malformado, campo obrigatório ausente, token errado.

Ler esse log é 90% do diagnóstico. Se todos os postbacks estão órfãos, o problema é na ida (macro/parâmetro). Se nenhum postback chega, o problema é na volta (URL cadastrada errada no painel da casa, ou a casa não ativou o postback para a sua conta).

Teste manual antes de escalar

1. Clique no seu próprio link de redirect.
2. Abra o relatório e copie o click_id gerado.
3. Chame a URL de postback substituindo o placeholder pelo valor real:

curl "https://go.seudominio.com.br/pb?subid=CLICK_ID_REAL&status=sale&amount=50&txid=teste-001"

4. Confira se apareceu como conversão casada, com valor 50, atribuída à campanha certa.
5. Repita a mesma chamada. Deve aparecer como duplicada, não como segunda conversão.

Esse teste de dois minutos evita semanas de dado errado.

Sub-afiliado: o postback que sai

Se você trabalha com uma rede de sub-afiliados, a conversão que entrou precisa sair. No momento em que o FTD é registrado, o relay dispara um postback para a URL do sub-afiliado com o valor que você definiu — fixo por merchant e evento, ou percentual sobre o valor recebido — usando macros como {click_id}, {valor}, {evento}, {txid} e {sub}. O sub nunca vê seu contrato com a casa, só o número que você combinou com ele. O funcionamento completo está em rede de sub-afiliados e o passo a passo operacional em como montar uma rede de sub-afiliados.

Para identificar de qual sub veio o clique, use a forma /r/{slug}/{identificador}: o segundo segmento grava sub1 e é repassado no relay.

Erros que mais custam dinheiro

• Usar subid na Superbet. Ela quer c. O clique sai sem identificador e todo depósito vira órfão.
• Esperar a volta no mesmo campo da ida. Na Superbet entra c, volta clickid.
• Encurtar o link depois do redirect. Encurtadores que reescrevem query string podem cortar o parâmetro do click_id.
• Cadastrar a URL de postback sem HTTPS. Muitos programas rejeitam.
• Tratar lead como FTD. Cadastro não é depósito; se o mapeamento não separa os dois, seu CPA fica inflado e sua decisão de mídia fica errada. A diferença está explicada em CPA, FTD e RevShare.
• Não registrar txid. Sem id de transação a deduplicação fica dependendo só do click_id, e um usuário que faz dois depósitos legítimos pode ser lido errado.

O que fazer depois que o FTD está entrando

Com postback casando, o trabalho vira análise. Os relatórios quebram por dia, campanha, fonte e sub, e o CRM de leads guarda o histórico de cada cadastro. Daí você consegue responder as perguntas que importam: qual criativo traz depósito e não só cadastro, qual fonte tem qualidade decrescente ao longo do mês, qual sub está trazendo volume sem conversão.

Se você está migrando de outra ferramenta, vale olhar o comparativo entre trackers e a página para afiliados, que detalha o fluxo do ponto de vista de quem opera mídia todo dia. Termos que aparecerem pelo caminho estão no glossário, e dúvidas de configuração no FAQ.

Sobre regulamentação: o mercado brasileiro de apostas tem regras próprias de operação e publicidade que mudam com frequência. Nada aqui é orientação jurídica — confira sempre a fonte oficial e o contrato do programa antes de rodar qualquer campanha.