Binom + cloaking: como integrar o tracker e o filtro de tráfego

O Binom é valorizado pela velocidade e por rodar no servidor da própria equipe: campanhas, landings, ofertas e todas as estatísticas ficam com você. Como esse tipo de tracker difere de um em nuvem está no artigo sobre tracker em servidor próprio ou em nuvem. Encaixar um serviço externo nesse esquema pede cuidado para não quebrar nada. A integração do Binom com cloaking da ArtisanClo não exige reconstruir nada: ela acrescenta ao Binom uma única função, a decisão «pessoa real ou bot» em cada visita, com o motivo registrado, e deixa dinheiro, cliques e ofertas com o tracker. Distribuir cliques entre ofertas é justamente o trabalho de TDS no marketing de afiliados que o próprio Binom faz.

O que a integração Binom + cloaking oferece

Tracker e cloaker têm papéis diferentes. O Binom responde às perguntas «quanto chegou, para onde foi, quanto ganhamos». O cloaker responde à pergunta «quem vai para a oferta». Para entender isso melhor, leia o artigo sobre cloaker e tracker.

Juntos, eles entregam o que nenhum dos dois entrega sozinho:

• os relatórios do Binom param de receber cliques de bots, que derrubam o CR e o EPC de campanhas e landings;
• na ArtisanClo, cada visita tem um motivo de decisão: «Permitido», «VPN ou proxy bloqueado», «Um programa, não um navegador», «Rede de alto risco» e dezenas de outros;
• com o postback do Binom, o cloaker enxerga conversões e receita, e o diagnóstico pode estimar quantos leads e quanto dinheiro custa cada regra de filtragem.

Há duas formas de integrar.

Forma 1: portão da ArtisanClo na landing do Binom

Nesta opção, o caminho do clique não muda: o link do anúncio leva à campanha do Binom, o Binom entrega a landing e na landing há um botão com o link do Binom para a oferta. A única novidade é que a primeira linha da landing inclui o arquivo do portão. Ele consulta a ArtisanClo sobre a visita antes de a página ir para o navegador.

• A pessoa vê sua landing normalmente, com o link de sempre do Binom para a oferta. O Binom conta cliques na oferta e conversões como antes.
• O bot recebe a White Page no lugar da landing.

Por que portão, e não filtro

O Keitaro tem uma pasta de filtros personalizados, e lá a ArtisanClo entra como filtro do fluxo; isso está no artigo sobre Keitaro e cloaking. O Binom não tem essa pasta, então a verificação vive na própria landing. Na prática é até mais cômodo: você vê o ponto de integração direto no código da página e o controla.

Configuração do portão passo a passo

1. Crie na ArtisanClo um fluxo para a campanha. Uma campanha, um fluxo: assim os motivos das decisões e as estatísticas se referem a um só anúncio.
2. Defina a White Page no fluxo: o portão vai precisar dela caso o serviço não responda.
3. Abra o menu do fluxo → Conectar → Portão para Binom e baixe o arquivo do portão deste fluxo.
4. Coloque o arquivo ao lado do arquivo da landing do Binom no seu servidor.
5. Na primeira linha da landing, antes de qualquer saída, inclua o arquivo:

<?php require __DIR__ . '/ac_binom_NNN.php'; ?>

No lugar de NNN, use o número que está no nome do arquivo baixado.

6. Verifique a integração: a pessoa chega à landing, o bot recebe a White Page. O resultado de cada visita aparece no log de cliques da ArtisanClo.

Dica. «Antes de qualquer saída» é literal. Um espaço ou linha em branco antes de <?php, um BOM no início do arquivo, um echo num template incluído antes, e o PHP já começou a entregar a página: o portão não consegue mais trocá-la pela White Page. Se o portão "não funciona", verifique primeiro os primeiros bytes do arquivo da landing.

Limitações do portão

O portão decide antes de responder ao visitante, por isso não há página de verificação no navegador:

• verificação de JavaScript, tempo na página e interação real não se aplicam;
• a decisão é tomada pela rede e pelos sinais da requisição: IP, provedor, data center, VPN e proxy, cabeçalhos, geo, dispositivo, agenda;
• se o serviço não responder em 3 segundos, o visitante recebe a White Page embutida no arquivo no momento do download.

Do último ponto sai uma regra: trocou a White Page no fluxo, baixe de novo o arquivo do portão e substitua no servidor. Senão, no caso raro de timeout, será entregue a página antiga.

Sombra e «Tracker»: primeiro medir, depois cortar

O cenário mais útil para a primeira semana é ligar no portão o modo sombra ou colocar o fluxo no modo «Tracker». Nos dois casos, todos os visitantes veem a landing, e a ArtisanClo só registra quem barraria. No «Diagnóstico» aparece que parte do tráfego pago é bot, e no log, por quais motivos. É uma avaliação honesta da qualidade da fonte antes de começar a filtrar qualquer coisa.

Como os bots são identificados e por que um único sinal não decide nada está no artigo sobre sinais de tráfego de bots.

Forma 2: cloaker no site, Binom como tracker externo

A segunda opção é para quando importa a verificação completa, inclusive do navegador. O link do anúncio leva ao seu site, onde está a tag JS ou o arquivo PHP da ArtisanClo. O site continua sendo seu, na sua hospedagem e no seu domínio. O fluxo verifica o visitante e decide se mostra a White Page ou a oferta. A «oferta» no fluxo é o link da campanha do Binom, e dali em diante funciona o seu esquema de sempre.

Detalhes da instalação no artigo sobre como instalar o cloaker: tag JS ou arquivo PHP.

Como devolver as conversões do Binom para o cloaker

No modo «Cloaking», o fluxo sem tracker externo não recebe conversões, e CR e receita ficam zerados nas estatísticas. Para corrigir isso, feche o ciclo do click id:

1. No fluxo da ArtisanClo, abra o passo 3. Tracker → Tracker externo e escolha Binom. O botão «?» mostra uma nota e o link para a documentação do tracker.
2. Copie o parâmetro para o link de anúncio, do tipo external_id={click_id}, e clique em Adicionar ao link: ele é acrescentado a todas as ofertas do fluxo. O campo fica verde quando o parâmetro já está no link da oferta.
3. Na campanha do Binom, salve o parâmetro de entrada external_id em um dos tokens, para que o tracker guarde o número do clique da ArtisanClo.
4. Abra na ArtisanClo a janela com o endereço de postback e configure no Binom o envio de conversões para esse endereço, preenchendo o token salvo e o status.
5. Faça uma conversão de teste e confira a linha de status no passo «Tracker».

O link da oferta no fluxo fica mais ou menos assim:

https://binom.seu-dominio.com/click.php?key=abc123&external_id={click_id}

A ArtisanClo preenche o número do clique, o Binom o guarda, e quando a rede enviar a conversão ao tracker, o Binom a repassa de volta, e ela se liga à visita original. Se a mecânica do click id ainda não é familiar, comece pelo artigo sobre Click ID e Sub ID; o esquema geral das notificações entre servidores está no material sobre postback.

Como ler a linha de status

Os detalhes de cada mensagem recebida ficam em Recebimento de conversões → Registro, com resultados como «lead registrado», «clique não encontrado», «sem click_id» e outros.

Quais relatórios ver no Binom e quais na ArtisanClo

Para não duplicar trabalho, divida as perguntas entre os sistemas. Se você ainda está escolhendo a base do seu controle, compare as opções com o artigo sobre como escolher o melhor tracker para afiliados.

O último ponto é especialmente útil em nativo e push: passe o número do placement no parâmetro da campanha, por exemplo sub1={zoneid}, e bloqueie na própria rede os placements em que o filtro barra quase tudo. Assim você para de pagar por tráfego que nunca converte.

Status e dinheiro: para os números baterem

Quando as conversões vão para dois lugares, surge a pergunta inevitável: por que o Binom mostra um valor e o cloaker outro. Normalmente o motivo é um destes três:

• Datas diferentes. O registro de conversões da ArtisanClo filtra, por padrão, pela data de chegada, enquanto os relatórios atribuem a receita à data do clique. O seletor «Data de chegada / Data do clique» resolve.
• Retenção. Pagamentos com status «Em espera» não entram na receita até a rede aprovar. Como ler os status está no artigo sobre status de conversão: em espera, aprovado, lixo.
• Duplicados. Um novo lead do mesmo visitante dentro da janela de unicidade é registrado como «Lixo», marcado como duplicado.

Erros comuns

• Portão incluído fora da primeira linha. A página já começou a ser entregue, e a White Page não pode mais entrar.
• Arquivo de portão de outro fluxo. Cada arquivo está vinculado ao seu fluxo.
• White Page trocada, arquivo não baixado de novo. No timeout, sai a página antiga.
• Postback com o ID do Binom em vez de external_id. As conversões chegam, mas não encontram os cliques.
• Conclusões nas primeiras horas. A taxa de passagem para a oferta depende da fonte: no tráfego pago com click id verificado ela costuma ser alta, e isso é normal. Preocupe-se quando a passagem for muito baixa: é sinal de que o filtro está cortando pessoas reais.

Resumo

A integração do Binom com a ArtisanClo é construída em volta do seu tracker, não no lugar dele. O portão na landing entra com uma linha de PHP e decide pela rede e pelos sinais da requisição; o cloaker no site, com postback do Binom, traz a verificação completa do navegador e as conversões nas estatísticas do cloaker. Comece pelo modo sombra, veja o que o filtro encontra no seu tráfego e só depois ative o bloqueio. Os detalhes da integração estão na página ArtisanClo e Binom, e a lista de todos os trackers suportados, no catálogo de trackers.