O que você precisa do Binom
Duas coisas: o token que o Binom substitui pelo click ID dele, que é {clickid}, e o seu endereço de postback com os nomes dos parâmetros. A RevRake preenche cada parâmetro com uma macro:
| Parâmetro do Binom | Preenchido por | Significado |
|---|---|---|
cnv_id | {sub1} | sub1 do clique: o click ID que o seu tracker colocou no link. |
payout | {commission} | A sua comissão como decimal (40.00). Vazia para um cadastro, 0 para uma comissão rejeitada, negativa para um chargeback. |
cnv_status | {status} | A palavra que diz em que ponto a conversão está, nas palavras que o Binom conhece. Elas estão na tabela mais abaixo. |
cnv_currency | {currency} | O código ISO da moeda da comissão. |
O Binom mostra o endereço de postback na aba "Tracking links" das configurações do tracker. cnv_id recebe o click ID e payout o payout; cnv_status pode levar qualquer texto de status, e cnv_currency a moeda do payout.
O caminho depende da versão do Binom. O preset tem o endereço do Binom 2, cujo caminho é /click. No Binom 1 o caminho é /click.php: se você usa o Binom 1, escreva click.php no lugar de click.
Passo a passo na RevRake
1Crie um link de rastreamento
Abra a página Links de rastreamento do seu portal do afiliado e crie um link por campanha. Cada link tem seu próprio endereço curto em track.revrake.com e pode levar a uma página do site do programa que você escolhe.
2Coloque o click ID do Binom no sub1
Acrescente ao link sub1= com o token de click ID do Binom e use o resultado como URL da oferta no Binom:
https://track.revrake.com/c/a8Kq2Zx?sub1={clickid}O Binom substitui {clickid} pelo click ID dele a cada clique. A RevRake grava o valor com o clique, até 200 caracteres, e o devolve nos seus postbacks como {sub1}. sub2 a sub5 ficam livres para os seus próprios valores, e as tags UTM do link também são gravadas.
3Adicione um destino de postback
Abra a página Postbacks e clique em "Adicionar um destino". O endereço é um template: tudo entre chaves é uma macro que a RevRake preenche a cada conversão.
https://YOUR-TRACKER-DOMAIN/click?cnv_id={sub1}&payout={commission}&cnv_status={status}&cnv_currency={currency}A RevRake traz este template como o preset Binom: escolha Binom na lista e ele é preenchido para você.
Substitua YOUR-TRACKER-DOMAIN pelo endereço do seu próprio postback do Binom, como o Binom mostra a você. O portal recusa um template que ainda tem o host de exemplo. Se o seu endereço de postback tem um parâmetro com nome diferente do que está no template, troque o nome e mantenha a macro.
4Escolha os eventos
Marque os eventos sobre os quais este destino deve ser avisado. registration e ftd avisam o Binom de um novo jogador e do primeiro depósito dele poucos segundos depois de o operador informá-los. commission_approved, commission_rejected, commission_paid e chargeback acompanham o dinheiro depois.
A RevRake tem dois IDs para um postback. {conversion_id} é igual para todos os eventos de uma mesma comissão, então um tracker que atualiza uma conversão pelo ID dela mantém uma conversão por comissão. {event_id} é diferente para cada evento. O preset Binom usa o que combina com a forma como o Binom trata um ID repetido; as seções abaixo dizem qual. Uma conta pode ter até 10 destinos.
5Envie um teste e leia o log de entregas
Clique em "Enviar teste" no destino. A RevRake envia na hora uma conversão fictícia e mostra o que o Binom respondeu e em quanto tempo. O teste se parece com um primeiro depósito: leva o click ID TEST-CLICK-ID e uma comissão de 40.00. O Binom não conhece esse clique, então pode ignorar o teste ou responder com um erro: o que o teste prova é que o endereço está acessível e como fica o endereço preenchido.
Para um teste de ponta a ponta, abra o link da sua campanha pelo Binom, para que um click ID real viaje em sub1, e peça ao operador que cadastre um jogador de teste a partir dessa visita. A conversão aparece então no log de entregas, com cada tentativa e a resposta do Binom, e no Binom.
Como {status} é mapeado no Binom
A RevRake dá um nome a cada evento e também uma palavra de status. Um destino criado a partir do preset Binom envia em {status} as palavras que o Binom conhece; {event} sempre leva o nome do evento. Um destino criado com "Outro / personalizado" envia lead, sale, approved, rejected e paid.
| Evento | {status} | Quando |
|---|---|---|
registration | lead | Um jogador foi atribuído ao afiliado. |
ftd | sale | Um primeiro depósito rendeu ao afiliado uma comissão CPA. |
commission_approved | sale | Uma comissão foi aprovada ao fim do período de retenção. |
commission_rejected | reject | Uma comissão em retenção foi rejeitada após uma análise. |
commission_paid | sale | Uma comissão foi paga em um lote de pagamento. |
chargeback | reject | Um chargeback retirou uma comissão. |
O Binom não tem uma lista fixa de status. cnv_status aceita qualquer texto, e uma palavra só significa algo pelo esquema de status que você configura no Binom. O template de e-commerce do Binom 2 tem os grupos lead, sale e reject, e o preset envia essas palavras: sale também para uma comissão aprovada e para uma paga, reject para uma comissão rejeitada e para um chargeback.
A documentação do Binom não descreve um parâmetro de ID de transação, então o preset não envia nenhum. Como vários postbacks de um mesmo clique são contados depende do seu esquema de status e das configurações de payout da oferta: consulte as páginas do Binom sobre esquemas de status e rastreamento de payout.
Solução de problemas
- O Binom não mostra conversões. Abra o log de entregas na página Postbacks. Se não há linha, o evento ainda não aconteceu, ou o destino não está marcado para ele. Se há uma linha, ela mostra o endereço que foi chamado e o que o Binom respondeu.
- O click ID chega vazio. O clique não tinha
sub1. Verifique se a URL da oferta no Binom termina comsub1=e{clickid}, e se o clique passou pelo Binom: um link aberto diretamente não tem click ID para levar. - Uma macro chega como foi escrita, entre chaves. A RevRake envia sem alterar um nome que ela não conhece, então um erro de digitação aparece no log de entregas. Compare o nome com a lista de macros.
- O payout está vazio ou zerado. Um cadastro não traz dinheiro, então
{commission}fica vazia para ele. É0para uma comissão rejeitada e negativa para um chargeback. - Uma entrega falhou. O Binom precisa estar acessível em um endereço público e responder com um status
2xxem até 5 segundos. Uma entrega com falha é reenviada após 1 minuto, 5 minutos, 25 minutos, 2 horas, 10 horas e 24 horas, e depois marcada como desistida; você pode reenviá-la manualmente. - O destino foi desligado. Depois de 20 falhas seguidas, a RevRake desliga o destino, com um e-mail depois de 5 e depois de 15. Corrija o endereço e ligue-o de novo: todos os postbacks que entraram na fila nesse meio-tempo são enviados.
- O Binom 1 não registra a conversão. O preset tem o caminho do Binom 2,
/click. O Binom 1 usa/click.php. - Um status não faz nada no Binom. A palavra não está no seu esquema de status. Acrescente-a, com a grafia da tabela acima.
O Binom é um produto do seu próprio fornecedor (https://binom.org/) e é citado aqui apenas para dizer a qual tracker o guia se refere. A RevRake não tem vínculo com ele.
Perguntas
- Preciso de uma chave de API para conectar o Binom?
- Não. Os links de rastreamento e os postbacks são configurados no seu portal do afiliado e não exigem chave. Uma chave só é necessária se você quiser ler seus relatórios e comissões por API.
- Qual token eu coloco no sub1 para o Binom?
{clickid}. O Binom o substitui pelo click ID dele a cada clique, e a RevRake devolve o valor no postback como{sub1}.- Quais eventos a RevRake pode enviar ao Binom?
- Seis:
registration,ftd,commission_approved,commission_rejected,commission_paidechargeback. Você marca os que quer em cada destino. - O postback leva o valor do depósito?
- Os templates enviam a sua comissão em
{commission}. O depósito por trás dela está disponível como{amount}, com a moeda em{amount_currency}: acrescente-os ao template se o Binom tiver um parâmetro para eles. - Posso enviar conversões ao Binom e a outro tracker ao mesmo tempo?
- Sim. Uma conta pode ter até 10 destinos, cada um com seu próprio template e seus próprios eventos.
- O que acontece se o Binom estiver fora do ar quando ocorre uma conversão?
- O postback é reenviado seis vezes ao longo de cerca de um dia e meio. Cada tentativa fica no log de entregas, e uma entrega desistida pode ser reenviada manualmente.
Fontes
O que este guia diz sobre o Binom vem da documentação do próprio Binom, como ela estava no dia indicado. Os trackers mudam: se um nome na sua página de postback for diferente do que está neste guia, confie na sua página de postback. O que ele diz sobre a RevRake está no guia de integração e na referência da API.
- Postback (Binom Documentation, version 1) https://docs.binom.org/postback-url.php lido em 4 de outubro de 2026
- Postback (Binom Documentation, version 2) https://docs.binom.org/postback-v2.php lido em 4 de outubro de 2026
- Status schemes Binom v2 (Binom Documentation) https://docs.binom.org/status-scheme-v2.php lido em 4 de outubro de 2026
- Payout tracking (Binom Documentation, version 2) https://docs.binom.org/payout-tracking-v2.php lido em 4 de outubro de 2026