O Keitaro é um dos trackers mais usados por equipes de tráfego pago: nele ficam campanhas, fluxos, ofertas e relatórios, e ninguém quer sair dele. A boa notícia é que nem precisa. O ArtisanClo fica ao lado do Keitaro e cuida de uma única tarefa: decidir se quem chegou é uma pessoa real ou um bot, e registrar o motivo dessa decisão. Todo o resto continua no seu tracker. O Keitaro é instalado no seu próprio servidor; a diferença em relação a uma opção em nuvem está no artigo tracker em nuvem ou no servidor.
Por que integrar Keitaro e cloaker
Tracker e cloaker resolvem tarefas diferentes. O tracker conta: de onde veio o clique, para onde foi, quanto custou e quanto rendeu. O cloaker decide: quem vê a oferta e quem vê a White Page neutra. A diferença em detalhe está em cloaker e tracker: qual a diferença.
Se você já trabalha no Keitaro, não precisa de um segundo sistema de contabilidade, e sim de uma resposta confiável a «deixar passar ou não» dentro do esquema de sempre. Daí as duas formas de integração.
| Esquema 1: filtro no Keitaro | Esquema 2: cloaker na landing + Keitaro | |
|---|---|---|
| Quem vê a visita primeiro | O Keitaro | Sua landing com a tag ou o arquivo PHP |
| Onde fica a verificação | Filtro de fluxo na campanha do Keitaro | Na página da landing |
| Quem define o destino | Os fluxos do Keitaro | O fluxo do ArtisanClo; a oferta é um link para o Keitaro |
| Verificação do navegador (JavaScript, tempo na página) | Não | Sim |
| O que fazer | Colocar o arquivo do filtro no servidor do Keitaro | Instalar a tag JS ou o arquivo PHP e configurar o postback |
| Quando escolher | O tráfego já passa pelos links do Keitaro | Precisa da verificação completa e das conversões nas estatísticas do cloaker |
Esquema 1: cloaking pelo Keitaro — o ArtisanClo como filtro de fluxo
Aqui o link do anúncio leva para a campanha do Keitaro, como antes. Antes de entregar a oferta, o Keitaro pergunta ao ArtisanClo se aquela visita pode passar. Se a resposta for «sim», entra o fluxo da oferta. Se for «não», a visita cai para o fluxo de baixo, o da White Page.
Configuração passo a passo
- Crie um fluxo no ArtisanClo. Ele equivale a uma campanha: fonte, regras de filtragem, geo e proteção.
- Abra o menu do fluxo → Conectar → Filtro para Keitaro e baixe o arquivo do filtro desse fluxo.
- Coloque o arquivo no servidor do Keitaro, na pasta
/var/www/keitaro/var/filters(em versões antigas,application/filters), e recarregue a página do Keitaro. - Na campanha do Keitaro, abra o fluxo da oferta e adicione o filtro com o nome do arquivo no modo «Sim».
- Abaixo, coloque o fluxo com a sua White Page — para lá vão todos que o filtro não liberou.
Atenção: os endereços de oferta e White Page definidos no fluxo do ArtisanClo não são usados neste esquema. Para onde levar a pessoa e para onde levar o bot, quem decide são os seus fluxos no Keitaro. O ArtisanClo só responde «liberar?». Na prática, o Keitaro funciona aqui como um sistema TDS — distribui o tráfego, e o filtro só lhe dá a resposta.
Limitações do filtro
O Keitaro consulta o filtro antes de responder ao visitante. Nesse momento não há como mostrar uma página de verificação ao navegador, por isso:
- a checagem de JavaScript, o tempo mínimo na página e a interação real não se aplicam;
- a decisão é tomada pela rede e pelas características da requisição: endereço IP, provedor, datacenter, VPN e proxy, cabeçalhos, marcador do clique, regras de geo, dispositivo e agenda;
- se o serviço não responder em 3 segundos, a visita vai para a White Page.
Para muitas fontes isso basta: tráfego de servidor, datacenters e redes de proxy se denunciam já no nível da rede. Bots que abrem um navegador de verdade e fingem ser gente nem sempre aparecem pela rede — esses são pegos pela verificação do navegador do esquema 2.
Modo sombra e modo «Tracker»
O filtro do Keitaro suporta o modo sombra: o filtro não barra ninguém, só marca no log quem ele bloquearia. Isso é útil quando você suspeita que está perdendo pessoas reais ou quer ver como um endurecimento das regras se comportaria, sem arriscar o tráfego. Não deixe o modo sombra ligado por muito tempo: enquanto ele estiver ativo, a oferta fica aberta para todos.
O modo de fluxo «Tracker» também funciona no filtro do Keitaro: todos vão para a oferta e os bots só são marcados nos relatórios. Serve quando você quer saber a parcela de bots no tráfego pago, mas ainda não quer filtrar.
Dica. Logo depois de conectar, abra o log de cliques no ArtisanClo e veja os motivos das decisões nas primeiras visitas. Se todos estão sendo cortados pelo mesmo motivo, provavelmente uma regra de público (o geo, por exemplo) não está ajustada ao seu tráfego.
Esquema 2: cloaker na landing e Keitaro como tracker externo
No segundo esquema, quem recebe a visita primeiro é o seu site. Nele fica a tag JS ou o arquivo PHP do ArtisanClo — o site continua com você, na sua hospedagem e no seu domínio. O cloaker verifica o visitante por completo, inclusive o navegador, e decide: White Page ou oferta. E a «oferta» aqui é o link da sua campanha do Keitaro; daí em diante tudo funciona como sempre.
Como conectar o cloaker ao site está descrito no artigo sobre integração do cloaker: tag JS ou arquivo PHP.
Como devolver as conversões do Keitaro ao cloaker
No modo «Cloaking», o cloaker por si só não vê conversões: ele sabe quem liberou, mas não quem comprou. Para que CR e receita apareçam nas estatísticas dele, é preciso fechar o ciclo:
- No fluxo do ArtisanClo, abra a etapa 3. Tracker → bloco Tracker externo e escolha Keitaro na lista. O botão «?» ao lado mostra uma nota e o link para a documentação do tracker.
- Copie o parâmetro para o link de anúncio, do tipo
external_id={click_id}. O botão Adicionar ao link acrescenta-o a todas as ofertas do fluxo. O campo fica verde se o parâmetro já está no link da oferta e vermelho se não está. - No Keitaro, receba esse parâmetro em um dos parâmetros da campanha, para que o número do clique do ArtisanClo fique guardado no tracker.
- Abra no ArtisanClo a janela com o endereço de postback e cole-o nas configurações de postback da campanha do Keitaro, preenchendo o parâmetro guardado e o status da conversão.
- Envie uma conversão de teste e confira a linha de status.
O link da oferta no fluxo vai ficar mais ou menos assim:
https://trk.seu-dominio.com/AbCdEf?external_id={click_id}
No lugar de {click_id} o ArtisanClo coloca o número daquele clique. O Keitaro guarda esse número e, quando a rede de afiliados envia a conversão ao tracker, o Keitaro a repassa adiante — e a conversão se liga ao clique original no cloaker. O esquema «Como o click_id vai e volta», no painel, mostra esse caminho de forma visual. Se click id é assunto novo para você, veja o artigo Click ID e Sub ID.
O que significa a linha de status
| Mensagem | O que fazer |
|---|---|
| «As conversões já estão chegando» | Nada — o ciclo está fechado |
| «Os postbacks chegam até nós, mas nenhum foi vinculado a um clique ainda» | O Keitaro está mandando o parâmetro errado: confira se no postback vai o valor de external_id, e não o ID de clique do próprio tracker |
| «Falta um passo: aponte o postback do seu tracker para o nosso endereço» | Nenhum postback do Keitaro chegou ainda |
Confira também Recebimento de conversões → Registro: lá estão as últimas mensagens recebidas com o resultado — «lead registrado», «clique não encontrado», «sem click_id». Pelo resultado você vê na hora em que passo a cadeia se rompe.
Qual esquema escolher
- As campanhas já estão montadas no Keitaro e você não quer refazer landings — esquema 1: ele entra no fluxo existente e não mexe nas páginas.
- Você precisa da verificação do navegador e de CR e receita nas estatísticas do cloaker — esquema 2: tag ou arquivo PHP na landing mais postback do Keitaro.
- Fonte com muito tráfego de servidor (nativo, push, pop) — o esquema 1 costuma bastar, porque esse tráfego aparece pela rede. Mais sobre plataformas no catálogo de fontes de tráfego.
- Você só quer contar bots, sem barrar — esquema 1 com o modo «Tracker» ou o modo sombra.
Os dois esquemas podem conviver em campanhas diferentes: uma campanha, um fluxo, cada um com sua forma de integração.
Como testar a integração antes de soltar o tráfego
Antes de ligar o orçamento, passe pela integração na mão. Leva dez minutos e poupa um dia de investigação.
- Seu próprio acesso. Abra o link do anúncio no celular, pelos dados móveis. No log de cliques do ArtisanClo deve aparecer a visita com o motivo da decisão, e no Keitaro o clique no fluxo certo. Se não quiser que seus acessos de teste sejam verificados, adicione seu endereço à lista branca de IPs do fluxo com o botão Adicionar meu IP.
- Acesso de datacenter. Abra o mesmo link por VPN ou de um servidor. A visita deve ir para o fluxo da White Page e, no log, receber um motivo como «VPN ou proxy» ou «Rede de alto risco».
- Parâmetros. Confira se os parâmetros da campanha (
utm_campaign,sub1e outros) chegam inteiros ao Keitaro: abra a ficha do clique no log do ArtisanClo e compare com o que o tracker registrou. - Conversão. No esquema 2, envie uma conversão de teste pelo Keitaro e verifique se a linha de status mudou para «As conversões já estão chegando».
Só depois disso mude o fluxo para o status «Ativo» e comece a anunciar.
Erros comuns na integração Keitaro e cloaker
- O fluxo da White Page está acima do fluxo da oferta. Aí a visita nem chega ao filtro. A ordem é: primeiro o fluxo da oferta com o filtro em «Sim», abaixo a White Page.
- Filtro no modo «Não». A lógica se inverte: vão para a oferta justamente os que o cloaker barrou.
- Arquivo de filtro de outro fluxo do ArtisanClo. O arquivo é ligado a um fluxo específico; cada campanha tem o seu.
- Postback com o ID de clique do Keitaro no lugar de
external_id. As conversões chegam, mas «nenhuma foi vinculada a um clique». - Comparar números de datas diferentes. O registro de conversões filtra, por padrão, pela data de chegada, enquanto os relatórios atribuem a receita à data do clique. Mude o registro para «Data do clique» e os números do cloaker vão bater com os do Keitaro. Como conferir a receita por status está no artigo sobre status de conversão.
O que você vê no fim
Com a integração pronta, o ArtisanClo mostra para cada visita o motivo da decisão: «Permitido», «VPN ou proxy», «Serviço de verificação de anúncios ou spy», «Fora do horário da campanha» e dezenas de outros. No Keitaro ficam o dinheiro, as ofertas e os relatórios de sempre. Se algo deu errado — menos conversões que o normal, a passagem caiu —, a análise começa pelo log de cliques e pelo diagnóstico do fluxo, descritos no artigo por que o clique foi para a White Page.
Os detalhes da integração estão na página ArtisanClo e Keitaro.
Resumo
Keitaro e cloaker não competem, se complementam. O esquema com filtro de fluxo entra nas campanhas existentes em poucos minutos e decide pela rede e pelas características da requisição. O esquema com tag ou arquivo PHP na landing traz a verificação completa do navegador, e o postback do Keitaro devolve ao cloaker as conversões e a receita. Escolha conforme onde suas campanhas já estão e o quanto de verificação o seu tráfego precisa.
