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.

  1. 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: motivo «Rede de alto risco», status «Filtrado», etapa «Rede e requisição»; bloco «Visita» com horário, fluxo, fonte, site e método de conexão
    Cartão do clique: 1 motivo da decisão, 2 visita — para onde foi enviada e como foi exibida.
  2. Verifique a conexão

    Menu do fluxo → Conectar → Verificar minha página. Todos os detalhes em Conexão com o site.

  3. Veja a análise do fluxo

    O Diagnóstico mostra qual regra corta mais e quantas pessoas reais ela atinge.

O que aparecePor que aconteceO que fazer
Todos os visitantes veem a White PageNã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 hospedagemHá 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 carregarO 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 à landingO 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 horaUm 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ãoO 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áginaNuvem 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áginaAlguns 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 logSe 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 antesNa 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 inteiraO 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.