Seções da documentação
Referência
Se algo não funciona
Quase todo problema é explicado pelo motivo da decisão no log de cliques. Comece por três passos e depois procure o seu caso na tabela.
Abra o seu clique no log
Entre você mesmo pelo link do anúncio e encontre a visita no log de cliques; clicar na linha abre o cartão com o motivo e a etapa em que a visita foi barrada.

Cartão do clique: 1 motivo da decisão, 2 visita — para onde foi enviada e como foi exibida. Verifique a conexão
Menu do fluxo → Conectar → Verificar minha página. Todos os detalhes em Conexão com o site.
Veja a análise do fluxo
O Diagnóstico mostra qual regra corta mais e quantas pessoas reais ela atinge.
| O que aparece | Por que acontece | O que fazer |
|---|---|---|
| Todos os visitantes veem a White Page | Não há plano ativo ou os cliques do período de teste acabaram; o fluxo está pausado ou em rascunho; o cloaking está desligado; o aquecimento está em andamento; o escudo está ativado e o link não tem click id. | Veja o motivo no log de cliques: «Fluxo em revisão», «Nenhum plano ativo», «Limite de cliques esgotado», «O fluxo não está ativo», «Cloaking desativado», «Antes da filtragem», «Escudo: sem click id pago». A ordem das verificações está em Oferta ou White Page. |
| Todas as visitas no log têm o mesmo IP — o do seu servidor ou da hospedagem | Há um proxy da hospedagem na frente do site, e o arquivo PHP vê o endereço dele em vez do endereço do visitante. O arquivo só aceita o endereço real do visitante pelos cabeçalhos quando eles vêm do Cloudflare. | Ative o proxy do domínio pelo Cloudflare (nuvem laranja) ou peça à hospedagem para repassar o endereço real do visitante ao servidor (configuração real IP / mod_remoteip). |
| O arquivo PHP responde com erro 503 ou a página demora a carregar | O seu servidor não consegue se conectar ao ArtisanClo: conexões de saída proibidas, sem a extensão curl e com allow_url_fopen desligado, ou o firewall da hospedagem bloqueando as requisições. O arquivo espera a resposta por até 4 segundos via curl; se o curl falhar e o allow_url_fopen estiver ligado, uma segunda tentativa espera mais até 4 segundos — no máximo 8 no total. | Confira se a hospedagem tem PHP 7.2 ou mais novo, com as extensões json e filter, e se permite requisições HTTPS de saída. O que o arquivo faz quando a conexão cai. Durante um dia ele decide com base na última resposta: visitantes com click id de anúncio vão para a oferta, os demais para a White Page, mostrada do mesmo jeito que no fluxo (por exemplo, por «Carregamento» sob o seu endereço de anúncio). Um fluxo em revisão manda todo mundo para a White Page enquanto durar a falha. Se o ArtisanClo ficar indisponível por mais de um dia, o arquivo volta a responder 503 a cada visita. Uma visita que chegar antes da primeira resposta também recebe 503. Arquivos antigos se comportam de outro jeito: os baixados entre 17 de setembro e 17 de outubro de 2026, numa falha, mandam o visitante com click id para a oferta por redirect e os demais para o próprio domínio da White Page, o que as plataformas consideram cloaking; os anteriores a 17 de setembro respondem 503 a todos. Baixe esse arquivo de novo. |
| A hospedagem responde 403 aos acessos à landing | O filtro de proteção da hospedagem (WAF, ModSecurity) toma as requisições da página de espera por ataque. | Coloque o endereço da landing nas exceções do filtro ou peça ao suporte da hospedagem para desligá-lo nesse site. |
| Todo mundo vê a página, até bots; ou as decisões não mudam na hora | Um plugin de cache do WordPress, o cache da hospedagem ou um CDN serve uma cópia salva da página, em vez de pedir a decisão para cada visitante. | Tire a landing do cache ou desligue o cache de páginas. Depois da mudança, limpe o cache e confira numa janela anônima. |
| A tag está instalada, mas a página aparece antes da decisão | O código foi instalado pelo Google Tag Manager, com async ou defer, ou não está na primeira linha do <head>. | Cole o código como primeira linha do <head> de cada página, sem gerenciador de tags. Confira pelo botão Verificar minha página. |
| Conectou pelo Cloudflare, mas a tag não está na página | Nuvem cinza, faltou clicar em Deploy depois da variável, rota no host errado ou caminho entre os ignorados. | Siga a tabela em Conexão pelo Cloudflare → Verificação e problemas. |
| A verificação da conexão diz que não foi possível abrir a página | Alguns sites e hospedagens não deixam a verificação automática entrar — por exemplo, com a verificação do Cloudflare. O motivo vem na resposta. | Isso não significa que a conexão não funciona. Abra a landing você mesmo: depois da primeira visita, o método ganha a marca «Instalado» na janela de conexão, e na lista de fluxos aparece «Conectado». |
| Os meus cliques de teste não aparecem no log | Se você entrar de novo do mesmo endereço e navegador no mesmo minuto do relógio e receber a mesma decisão, um clique novo não é registrado — ele é juntado ao anterior. Na conexão pelo arquivo PHP, uma entrada repetida dentro de um minuto nem chega até nós: a decisão fica guardada no navegador. Uma visita que não esperou o fim da página de espera não entra no log, a menos que o fluxo tenha o «Exigir JS» ligado. | Espere um minuto ou teste de outro dispositivo ou rede; na página de espera, aguarde o redirecionamento. |
| As configurações do fluxo mudaram, mas o visitante vê o de antes | Na conexão pelo arquivo PHP, a decisão de cada visitante fica guardada no navegador por até um minuto. | Teste numa janela anônima nova. Não precisa reenviar o arquivo PHP depois de editar o fluxo: as configurações não ficam no arquivo. Só é preciso baixar o arquivo de novo se a janela de conexão disser «Você está usando um arquivo antigo». |
| A oferta em iframe não abre ou os links nela abrem na aba inteira | O site da oferta proíbe a exibição em frame. Na conexão pela tag JS, essa oferta é mostrada pelo nosso servidor, e os links nela abrem na aba inteira; na conexão pelo arquivo PHP, o frame fica vazio. | Escolha o modo «Carregamento» ou «Redirect». No modo «Iframe», o painel avisa sobre isso abaixo do endereço da oferta: «Este site se recusa a ser exibido em um frame». |
| Pessoas com VPN ou de outro país não passam | É assim mesmo. Uma visita de um país que não está no GEO do fluxo é cortada pela regra de GEO — a chave de VPN não influi nisso. Com o «Bloquear VPN/Proxy» ligado, VPNs e proxies são recusados com «Rede de alto risco»; se o bloqueio estiver desligado, a VPN ainda baixa um pouco a pontuação de confiança e, junto com outros sinais, pode resultar em «Pontuação de confiança baixa demais». | Se você precisa do público com VPN, desligue o «Bloquear VPN/Proxy», mas antes confira no Diagnóstico quanto vai perder. Precisa de outros países — adicione-os ao GEO do fluxo. |
Não achou o seu problema? Escreva para o suporte e mande um exemplo da decisão errada.
ArtisanClo · Documentação do painel. Dúvidas: info@artisanclo.com ou @artisanclo_support no Telegram.