O cloaker só funciona quando fica na frente da sua página: o visitante chegou pelo link do anúncio, o filtro verificou a visita e decidiu o que mostrar, a oferta ou a White Page. Enquanto o código não estiver instalado, nenhuma configuração do fluxo vale, e bots, scanners e spy tools veem o mesmo que o comprador, enquanto você paga pelos cliques deles. Por isso instalar o cloaker é o primeiro passo técnico depois de criar o fluxo, e merece atenção. Se você ainda não escolheu o serviço, comece pelo artigo comprar cloaker: o que verificar antes.
Onde fica o site quando você instala o cloaker
Um engano comum de quem está começando: achar que o serviço de filtragem leva a landing para ele e que o anúncio aponta para um endereço de terceiros. No ArtisanClo não é assim. O site continua com você: a sua hospedagem, o seu domínio, os seus arquivos. Na página vai um código ou arquivo pequeno, e todo o resto (verificação da visita, pontuação de confiança, escolha do destino) acontece do lado do serviço. Como esse esquema em nuvem se diferencia de um script próprio está no artigo cloaker em nuvem ou script de cloaker.
Disso saem duas coisas práticas:
- no gerenciador de anúncios vai o endereço do seu site, não um link para um domínio de terceiros;
- a disponibilidade da landing, o certificado SSL e a velocidade da hospedagem são responsabilidade sua; o filtro não conserta servidor lento.
Se você está conhecendo o assunto agora, leia primeiro o que é cloaker e qual caminho o clique percorre; assim fica mais claro por que o código precisa disparar antes de tudo na página.
Dois métodos de instalação: comparação
A janela de conexão abre pelo menu do fluxo: Fluxos → linha do fluxo → Mais → Conectar. Ali os métodos aparecem em cartões recolhidos; um fica aberto por vez. Um método por fluxo é suficiente. O método que está funcionando fica verde, com a marca Instalado.
| Tag JS | Arquivo PHP | |
|---|---|---|
| Onde atua | No navegador do visitante | No seu servidor, antes de entregar a página |
| O que é preciso | Acesso ao <head> da página |
Hospedagem com PHP 7.2 ou mais novo |
| Depende de bloqueadores e da ordem de carregamento | Sim | Não |
| Modo Tracker e Modo sombra | Filtra como um cloaker comum | Funcionam |
| White Page por código de status (403/404) | Não consegue mudar o código de status | Funciona |
| Atualização | Não é necessária | O arquivo não se atualiza sozinho; é preciso baixar a versão nova |
Em resumo: a tag é mais rápida de colocar, o arquivo é mais confiável. As configurações de filtragem são as mesmas: ficam no fluxo, não no código do site, e o método de conexão pode ser trocado sem mexer no fluxo.
Cloaker JS: instalação por tag
A tag JS é uma linha de script que você insere no HTML da landing. Até a decisão chegar, a tag esconde a página; se não houver decisão, leva o visitante para a White Page.
Instalação da tag JS passo a passo
- Na janela Conectar, abra o método Tag JS e copie o código.
- Cole-o como primeira linha do
<head>, em cada página da landing, não só na principal. - Salve o arquivo ou publique a página e recarregue no navegador.
- Clique em Verificar minha página: o painel abre a página e procura o código nela.
O que não fazer com a tag
- Não instale o código pelo Google Tag Manager nem por outro gerenciador de tags. Eles executam scripts mais tarde, e a página aparece para todos, inclusive bots e spy tools, antes da decisão.
- Não acrescente
asyncnemdefer, pelo mesmo motivo. - Não coloque o código abaixo de outros scripts: analytics, pixels e widgets vêm depois dele.
Dica. Se o script da tag não carregar (por exemplo, se a rede ou um bloqueador no servidor o cortar), a página não se esconde, e bots e spy tools veem a oferta. Por isso, depois de cada alteração no site, clique em Verificar minha página de novo.
Limitações da tag
A tag funciona no navegador e, portanto, não consegue mudar o código de status do servidor. Se a White Page estiver configurada no modo Código de status (200/403/404), com a tag JS fica uma página em branco no lugar da landing. O modo Tracker e o Modo sombra também não valem na tag: um fluxo com tag filtra o tráfego como um cloaker comum.
Cloaker PHP: instalação por arquivo no servidor
O arquivo PHP é o método para sites em hospedagem com PHP. A decisão é tomada no servidor antes de o navegador receber um único byte da página, por isso não depende de bloqueadores de anúncio nem da velocidade de carregamento dos scripts.
Instalação do arquivo PHP passo a passo
- Na janela Conectar, clique em Baixar arquivo.
- Coloque o arquivo na raiz da landing com o nome
index.php. - Renomeie a sua landing, por exemplo para
offer.php. - No cartão da oferta do fluxo, informe o novo endereço da landing, por exemplo:
https://seu-site.com/offer.php
- Clique em Verificar minha página: o painel confere se o arquivo responde.
O esquema fica assim: o anúncio leva a seu-site.com, ali o index.php recebe o visitante, pede a decisão e mostra o offer.php ou a White Page.
Atualização do arquivo PHP
O arquivo no servidor não se atualiza sozinho. Quando sai uma versão nova, a janela de conexão mostra o aviso Você está usando um arquivo antigo, com a lista do que a sua versão atual não consegue fazer. Baixe o arquivo de novo e substitua o antigo. A versão nova é necessária, por exemplo, para a White Page pronta do catálogo, as regras de Parâmetros do link da oferta e a verificação de interação real.
Por outro lado, depois de mudar as configurações do fluxo não é preciso reenviar o arquivo: as configurações não ficam no arquivo, ficam no painel e valem a partir da próxima visita.
O que a hospedagem precisa ter
- PHP 7.2 ou mais novo;
- requisições HTTPS de saída permitidas (o arquivo precisa se comunicar com o serviço);
- extensão curl ou
allow_url_fopenativado.
O arquivo espera a resposta por até 4 segundos. Se não houver conexão, durante um dia ele atende as visitas com base na última resposta: visitantes com identificador de clique de anúncio vão para a oferta, os outros para a White Page. Uma visita que chegar antes da primeira resposta de todas recebe erro 503.
WordPress: plugin em vez de instalação manual
Se a landing é feita em WordPress, não é preciso mexer nos arquivos: o plugin é instalado pelo painel e funciona pelo mesmo método de servidor. Ele está disponível a partir do plano Professional; no período de teste gratuito, o site é conectado por tag JS ou arquivo PHP. A instalação passo a passo, o trabalho com cache e os erros comuns estão em um artigo próprio, cloaker para WordPress.
Se o seu tráfego passa por um tracker, o ArtisanClo também se integra a ele; veja os materiais Keitaro e cloaker e Binom e cloaker. A lista de trackers suportados está na seção integrações com trackers.
Como verificar se o cloaker está instalado
O botão Verificar minha página dá uma de três respostas:
| Resposta da verificação | O que significa |
|---|---|
| Encontrado na sua página | Está tudo certo |
| Não encontrado na sua página | O código não foi encontrado ou está em outra página |
| Não foi possível abrir sua página | O site ou a hospedagem não deixaram a verificação entrar; isso ainda não significa que a conexão não funciona |
Dá para verificar a cada 20 segundos. Lembre que a verificação zera as marcas anteriores Instalado e Conectado; elas voltam com a primeira visita. Abaixo do método aparece Funcionando agora ou a data da última atividade.
Depois disso, faça a verificação real:
- Abra o link de anúncio do fluxo numa janela anônima.
- Entre no Log de cliques: a visita deve aparecer com a decisão e o motivo.
- Se quiser ver a oferta você mesmo, coloque o seu endereço na Whitelist de IPs na etapa 4 do fluxo (botão Adicionar meu IP).
Dica. Um novo acesso do mesmo endereço e navegador em até um minuto é unido ao clique anterior. Se o acesso de teste não apareceu no log, espere um minuto ou use outro aparelho.
Se no log a visita aparece com o motivo Antes da filtragem, o fluxo está com aquecimento ativo: os primeiros cliques veem a White Page sem verificação, e a whitelist não ajuda aqui. Como ler os motivos está no artigo por que o clique foi para a White Page.
Erros ao instalar o cloaker
A maioria dos chamados de cloaker não funciona cai em cinco situações.
Todo mundo vê a página, até os bots
Quase sempre a culpa é do cache: um plugin de cache, o cache da hospedagem ou a CDN entregam uma cópia salva da página em vez de pedir a decisão para cada visitante. Tire a landing do cache, limpe o cache e teste numa janela anônima.
A página pisca antes da decisão
A tag está num gerenciador de tags, com async/defer ou não está na primeira linha. Mova-a para o topo do <head>.
Todas as visitas têm o mesmo IP
Há um proxy da hospedagem na frente do site, e o arquivo PHP vê o endereço do proxy em vez do endereço do visitante. Peça à hospedagem para repassar o endereço real (configuração real IP ou mod_remoteip). Enquanto isso não for corrigido, o filtro avalia o seu servidor, não as pessoas.
A hospedagem responde 403
O filtro de proteção da hospedagem (WAF, ModSecurity) confunde as requisições da página de verificação com um ataque. Coloque o endereço da landing nas exceções ou peça ao suporte da hospedagem para desligar o filtro nesse site.
O arquivo PHP responde 503 ou a página demora a carregar
O servidor não consegue falar com o serviço: conexões de saída bloqueadas ou falta de curl. Confira a versão do PHP e as permissões de rede.
A análise completa de problemas, com a ordem de verificação, está no artigo cloaker não funciona: como verificar e corrigir.
Instalação e velocidade da landing
Qualquer filtro acrescenta ao carregamento da página o tempo da decisão, e os media buyers perguntam com razão se não vão perder conversão por velocidade. Algumas observações práticas:
- A tag esconde a página até a decisão chegar. Quanto antes ela carrega, menor a pausa: mais um motivo para colocá-la na primeira linha.
- O arquivo PHP pede a decisão a partir do servidor. Aqui importa a conexão da sua hospedagem com o mundo: uma hospedagem barata e sobrecarregada deixa lentas tanto a landing quanto a verificação.
- O Tempo mínimo na página e a Verificação de interação real acrescentam espera de propósito. Ligue-os onde a plataforma justifica o rigor, não em todo lugar por padrão.
- Uma landing pesada (imagens grandes, dez scripts de analytics) costuma atrasar mais do que o filtro. Otimizar a própria página muitas vezes rende mais do que escolher o método de conexão.
Qual método escolher para o seu caso
- Landing em construtor de sites ou hospedagem de terceiros sem PHP: tag JS. O essencial é a primeira linha do
<head>. - Hospedagem própria com PHP: arquivo PHP. Não depende do navegador e dá mais recursos: código de status em vez de White Page, Modo sombra, modo Tracker.
- WordPress: plugin, se o plano o incluir; senão, arquivo PHP.
- Fluxo no modo Tracker: só arquivo PHP; a tag nem aparece na janela de conexão para ele.
Para Google Ads, Facebook e TikTok, a documentação recomenda qualquer um dos dois métodos; para redes nativas, o arquivo PHP. Configurações prontas por plataforma estão no catálogo de fontes de tráfego, e sobre a configuração do fluxo em si (filtros, White Page, ofertas) leia o artigo configuração do cloaker passo a passo.
Resumo
Instalar o cloaker é colocar uma linha de tag JS no início do <head> ou um arquivo PHP no papel de index.php, com a landing renomeada. O site e o domínio continuam com você. Depois da instalação, clique em Verificar minha página, abra o link numa janela anônima e encontre a visita no log de cliques. Se algo der errado, a causa mais comum é o cache, o gerenciador de tags ou o proxy da hospedagem, e o log de cliques geralmente mostra onde exatamente.
