Seções da documentação
Configuração do fluxo
Oferta ou White Page: quem vê o quê
A cada visita, o ArtisanClo verifica as condições em ordem, de cima para baixo. Vale a primeira que se aplicar, e as verificações param ali. Por que a visita foi para onde foi aparece no log de cliques.
Nesta página
Ordem das verificações
| # | Condição | O que o visitante vê | Motivo no log |
|---|---|---|---|
| 1 | Não há plano ativo ou os cliques do período de teste acabaram | White Page | «Nenhum plano ativo», «Limite de cliques esgotado» |
| 2 | Fluxo pausado ou em rascunho | White Page | «O fluxo não está ativo» |
| 3 | O endereço já é conhecido com certeza como bot ou revisor da plataforma — com você ou com outro cliente | White Page, sem verificações | «Endereço de bot conhecido» |
| 4 | Fluxo em moderação | White Page, sem verificações | «Fluxo em revisão» |
| 5 | Cloaking desligado | White Page | «Cloaking desativado» |
| 6 | Endereço na sua lista negra de IP | White Page, sem verificações | «Na sua lista negra» |
| 7 | Aquecimento em andamento: o fluxo ainda não chegou a N cliques | White Page, sem verificações | «Antes da filtragem» |
| 8 | Endereço na whitelist de IP | Oferta | «Permitido pela whitelist» |
| 9 | Limite de cliques de um IP por dia ultrapassado | White Page | «Cliques demais de um IP» |
| 10 | O endereço já foi pego como bot (se «Listas negras de IP» estiver ligado) ou é um navegador headless evidente (se «Navegadores headless» estiver ligado) | White Page | «Endereço já sinalizado», «Navegador headless detectado» |
| 11 | Serviço de verificação de anúncios, programa no lugar de navegador, robô de preview da plataforma, navegador com rastros comprovados de automação | White Page — sempre, com quaisquer configurações | «Serviço de verificação de anúncios ou spy», «Um programa, não um navegador», «Crawler de busca ou de plataforma», «Tráfego de navegador automatizado» |
| 12 | Visita de um endereço de datacenter sem um provedor comum por trás — e ainda via VPN ou sem JavaScript; o navegador ainda não foi confirmado | Página de espera com verificação do navegador, depois nova verificação | «Navegador não verificado» |
| 13 | Público: país, dispositivo, SO, navegador, idioma, fuso horário, cidade, região, rede, provedor, site de origem, agenda | White Page, se não se encaixar | «País não permitido», «Fora do horário da campanha» etc. |
| 14 | Escudo ativado e o link sem identificador de clique de anúncio | White Page | «Escudo: sem click id pago» |
| 15 | Tempo mínimo na página definido | Página de espera, depois nova verificação | — |
| 16 | Pontuação de confiança: VPN, datacenter, IPv6, sem provedor, sem site de origem, sem JavaScript e outros sinais | White Page, se houver sinais suspeitos demais | «Pontuação de confiança baixa demais», «Rede de alto risco» etc. |
| 17 | A proteção extra acha a visita parecida com os seus bots | White Page | «Segunda opinião: parece com os seus bots» |
| 18 | Todas as verificações aprovadas | Oferta (escolhida por ramos e pesos) | «Permitido» |
- Se a oferta foi escolhida, mas a página dela não abriu (modo «Carregamento»), o visitante vê a White Page, e o log mostra «A oferta não carregou».
- Se o fluxo não tem nenhuma oferta ativa — White Page e «O fluxo não tem oferta para onde enviar».
- Com o «Exigir JS» ligado, o visitante que não passou na verificação por script e não voltou da página de espera aparece no log mais tarde com o motivo «JavaScript obrigatório». Se a chave estiver desligada ou o visitante tiver caído na página de espera por outro motivo, a visita que não volta não entra no log.
- A verificação «Endereço de bot conhecido» só funciona quando o fluxo está filtrando. Em moderação, no modo sombra, no modo «Tracker» e com o cloaking desligado ela não existe. Ela não barra um endereço da sua whitelist de IP.
Escudo
Enquanto o escudo está ativado (algumas horas), só chega à oferta quem veio de um clique no anúncio. Ative-o quando a plataforma estiver revisando a campanha ativamente: moderadores e revisores costumam entrar sem o identificador de clique do anúncio.
O escudo considera de anúncio a entrada cujo link traz o identificador de clique da plataforma:
| Plataforma | Parâmetro no link |
|---|---|
fbclid | |
gclid, wbraid, gbraid, gad_source | |
| TikTok | ttclid |
| Microsoft | msclkid |
| X | twclid |
| Snapchat | sc_click_id |
epik | |
rdt_cid | |
| Taboola | tblci |
| Outbrain | ob_click_id, obOrigUrl |
| Amazon | aaaid |
O site de origem (referrer) sozinho não basta — precisa ser o parâmetro. Se a plataforma não coloca identificador de clique (por exemplo, Telegram), com o escudo ativado ninguém chega à oferta.
O que muda com o escudo ativado:
- O visitante sem identificador de clique vê a White Page.
- O visitante com identificador segue em frente, mas a verificação é mais rígida: VPN e proxy são bloqueados sempre; ligam-se sozinhos o bloqueio de datacenters, de navegadores headless e de endereços das listas negras de IP. Na conexão por tag JS ou arquivo PHP, passam a ser obrigatórios o JavaScript e no mínimo 2 segundos na página de espera (Keitaro e Binom não têm página de espera).
- As regras de público valem normalmente: um visitante de um país não permitido vê a White Page mesmo com identificador de clique.
- O modo sombra e o modo «Tracker» ficam desligados enquanto o escudo estiver ativado.
- Em todas as páginas do painel aparece o aviso «Escudo ativado» e o horário em que ele vai baixar.
Parte dos visitantes reais sem identificador de clique — acessos diretos, links encaminhados, aberturas pelos favoritos — também vê a White Page enquanto o escudo estiver ativado. Mantenha o escudo pelo tempo que durar a revisão.
Como ativar à mão a partir do Professional: Diagnóstico → aba Risco de ban → Ativar por 6h. O título do bloco mostra quanto falta. Para tirar antes — Desativar o escudo. No prazo, o escudo sai sozinho; se ele já estiver ativado por mais tempo, ativar de novo não o encurta.

Lista comum de bots
Quando identificamos com certeza um serviço de verificação de anúncios, um robô da plataforma ou um programa no lugar de navegador, o endereço dele fica registrado para todos os clientes do ArtisanClo. A próxima visita desse endereço a qualquer fluxo seu recebe a White Page na hora — sem verificação e sem atraso, com «Endereço de bot conhecido» no log.
- Endereços de datacenters e hospedagens entram na lista na primeira vez e ficam lá praticamente para sempre.
- Endereços residenciais e móveis são usados por muita gente real, então uma vez não basta. Um endereço assim só entra na lista quando um bot vindo dele foi pego em três clientes diferentes — dentro de uma hora depois do terceiro caso. Ele fica lá 14 dias.
- Ocorrências em contas de teste não colocam o endereço na lista na hora, mas no recálculo de hora em hora contam como as demais.
- Pessoas reais com rede suspeita, VPN ou sem JavaScript não entram nessa lista.
Escudo automático

a partir do Professional A caixa Ativar o escudo automaticamente assim que uma revisão for detectada na aba Risco de ban. Se a caixa estiver marcada e o escudo desativado, acima do bloco aparece «Escudo em prontidão» — ele se ativa sozinho quando notarmos uma revisão.
- A cada 15 minutos o ArtisanClo conta, nos fluxos que estão recebendo tráfego, quantas revisões houve nas últimas 3 horas: entradas de serviços de verificação de anúncios e de robôs de preview das plataformas, inclusive de quem já conhecemos pelo endereço. Esse número é comparado com o nível normal do fluxo na semana anterior.
- Níveis de risco:
- Tranquilo — tudo normal;
- De olho — revisões bem acima do normal (ou o fluxo é novo e um revisor já passou por ele). Chega uma notificação no sino, e o escudo não é ativado;
- Em revisão — um pico brusco: por exemplo, 8 revisões ou mais em 3 horas, quando normalmente quase não há nenhuma. Com o escudo automático ligado, o escudo é ativado por 6 horas; sem a caixa marcada, chega só a notificação.
- Quando o escudo é ativado, chega uma notificação no sino e no Telegram: «Plataforma revisando a campanha».
Onda de revisões na rede. Uma vez por hora o ArtisanClo olha todas as contas ao mesmo tempo. Se em 3 horas aparecem revisões num mesmo país em vários clientes ao mesmo tempo, e elas são o triplo do normal, é uma onda. Fluxos com escudo automático abertos para esse país recebem o escudo por 3 horas. Os demais recebem a notificação de que a plataforma está varrendo a rede, com a sugestão de ativar o escudo à mão.
Em moderação
Enquanto o modo estiver ligado, todos os visitantes veem a White Page, sem filtragem. Ligue durante a revisão do anúncio pela plataforma: os moderadores só verão a White Page. Nada entra na sua lista negra. Já os revisores e bots da plataforma que identificarmos com certeza nesse período entram na lista comum de bots pelas regras normais: endereços de datacenter na hora, residenciais e móveis quando vários clientes os pegaram.
Como ativar a partir do Professional: Diagnóstico → aba Risco de ban → Ativar moderação. O modo não desliga sozinho — desligue-o à mão. Enquanto o modo estiver ligado, todas as páginas do painel mostram o aviso «Fluxo em revisão». O tráfego real nessas horas também vai para a White Page e não chega à oferta — desligue logo depois da aprovação.
Ajuste automático
a partir do Professional A aba Ajuste automático no Diagnóstico. O ajuste automático verifica o fluxo uma vez por hora. Se a semana somou pelo menos 300 visitas, ele pode mudar uma configuração — mas não mais de uma vez a cada 6 horas.

- Escudo: a estratégia «Cauteloso» ativa o escudo já no nível «De olho», e as estratégias «Equilibrado» e «Mais tráfego», só no nível «Em revisão». Isso funciona independentemente da caixa do escudo automático.
- Proteção: liga o bloqueio de datacenters, navegadores headless, VPN, endereços das listas negras de IP ou visitas sem referrer — se ele pegaria bots suficientes sem atingir nenhum comprador. Ou desliga uma regra que estava barrando compradores.
- Pesos: desloca 10 pontos percentuais de peso para a oferta com a melhor receita.
- GEO, dispositivos e agenda o ajuste automático nunca mexe. Enquanto o risco não estiver normal ou o escudo estiver ativado, ele não muda nada. No modo sombra o ajuste automático não funciona: não há o que otimizar.
- Cada mudança aparece no log do ajuste automático com uma explicação e pode ser desfeita. Depois de desfeita, o ajuste automático não mexe mais nessa configuração.
Proteção extra
a partir do Professional A aba Proteção extra no Diagnóstico. O modelo aprende com o histórico da sua conta: quem comprou de você e quem se revelou bot. Ele só verifica quem já passou pelas outras regras e manda para a White Page as visitas parecidas com os seus bots. Enquanto seus dados forem poucos, funciona um modelo geral. Ele se retreina toda noite e se desliga sozinho se começar a barrar uma parte relevante das conversões.

Modo sombra e modo «Tracker»
- Modo sombra — com conexão pelo arquivo PHP, pelo filtro do Keitaro ou pelo portão do Binom, todos os visitantes vão para a oferta, e o log mostra quem o filtro teria barrado («Observado, não cortado»). Os cliques no modo sombra não consomem o limite do período de teste. Na conexão por tag JS ou pelo link do fluxo, a filtragem funciona normalmente.
- Modo «Tracker» — com conexão pelo arquivo PHP, pelo filtro do Keitaro ou pelo portão do Binom, todos vão para a oferta («Rastreado, sem filtragem»), e os bots só são marcados nos relatórios. Na conexão por tag JS ou pelo link do fluxo, a filtragem funciona como no modo «Cloaking».
- Nem o modo sombra nem o «Tracker» anulam a pausa do fluxo ou o plano não pago: nesses casos todos veem a White Page. Com o escudo ativado, os dois modos são desligados.
Exemplos
| Situação | O que vê | No log |
|---|---|---|
Moderador do Facebook num navegador comum, sem fbclid, escudo ativado | White Page | «Escudo: sem click id pago» |
| Robô de preview de links do Facebook — com ou sem escudo | White Page | «Crawler de busca ou de plataforma» |
Pessoa real vinda do anúncio com fbclid, escudo ativado | 2 segundos de espera (na tag e no arquivo PHP), depois a oferta | «Permitido» |
| A mesma pessoa com VPN, escudo ativado | White Page | «Rede de alto risco» ou «Pontuação de confiança baixa demais» |
| Pessoa abriu um link encaminhado sem identificador de clique, escudo ativado | White Page | «Escudo: sem click id pago» |
| Primeiro clique de um fluxo com aquecimento de 50 cliques | White Page sem verificação — assim será com os primeiros 50 cliques, inclusive o seu endereço da whitelist | «Antes da filtragem» |
| Visita às 23:00 com agenda das 9:00 às 18:00 no fuso da campanha | White Page | «Fora do horário da campanha» |
| Seu endereço na whitelist, limite de «1 clique por IP» já esgotado, escudo ativado | Oferta — a whitelist é verificada antes do limite e do escudo | «Permitido pela whitelist» |
| Fluxo pausado, modo «Tracker» no arquivo PHP | White Page | «O fluxo não está ativo» |
| Cloaking desligado, site conectado pela tag | White Page | «Cloaking desativado» |
| Modo sombra, bot de datacenter, arquivo PHP | Oferta | «Observado, não cortado» |
| O visitante passou nas verificações, mas a oferta (modo «Carregamento») não respondeu | White Page | «A oferta não carregou» |
| Escudo automático ligado, chegaram 9 revisores em 3 horas, quando normalmente não chega nenhum | Em até 15 minutos o escudo é ativado por 6 horas; a partir daí, todos sem identificador de clique veem a White Page | «Escudo: sem click id pago» |
ArtisanClo · Documentação do painel. Dúvidas: info@artisanclo.com ou @artisanclo_support no Telegram.