Seções da documentação
Configuração do fluxo
Oferta ou White Page: quem vê o quê
Para cada visita, o ArtisanClo verifica as condições em ordem, de cima para baixo. Vale a primeira que se aplicar: depois dela a visita não é mais verificada. O motivo da decisão aparece no log de cliques.
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 | Endereço já identificado com certeza como bot ou revisor da plataforma — na sua conta ou na de outro cliente | White Page, sem verificações | “Endereço de bot conhecido” |
| 4 | O fluxo está em revisã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 IPs | White Page, sem verificações | “Na sua lista negra” |
| 7 | Aquecimento em andamento: o fluxo ainda tem menos de N cliques | White Page, sem verificações | “Antes da filtragem” |
| 8 | Endereço na whitelist de IPs | Oferta | “Permitido pela whitelist” |
| 9 | Limite diário de cliques por IP excedido | White Page | “Cliques demais de um IP” |
| 10 | Endereço já identificado como bot ou navegador-robô evidente | White Page | “Endereço já sinalizado”, “Navegador headless detectado” |
| 11 | Serviço de verificação de anúncios, programa em vez de navegador, robô de pré-visualização da plataforma | 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” |
| 12 | Públicos: país, dispositivo, SO, navegador, idioma, fuso horário, cidade, região, rede, provedor, site de origem, horário | White Page, se não corresponder | “País não permitido”, “Fora do horário da campanha” etc. |
| 13 | O shield está ativo e o link não tem marcador de clique de anúncio | White Page | “Shield: sem click id pago” |
| 14 | Tempo mínimo na página definido | Página de espera, depois nova verificação | — |
| 15 | Avaliaçã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. |
| 16 | A proteção inteligente considera a visita parecida com os seus bots | White Page | “Segunda opinião: parece com os seus bots” |
| 17 | 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”.
- Se o visitante não passou na verificação por script e não voltou da página de espera, o clique aparece no log mais tarde com o motivo “JavaScript obrigatório”.
- A verificação “Endereço de bot conhecido” só vale quando o fluxo filtra: em revisão, no modo sombra, no modo “Tracker” e com o cloaking desligado ela não é aplicada. Ela não barra um endereço da sua whitelist de IPs.
Shield
Por algumas horas, o shield deixa chegar à oferta apenas visitantes vindos de um clique de anúncio. Ative-o quando a plataforma estiver revisando a campanha ativamente: moderadores e revisores costumam entrar sem o marcador de clique de anúncio.
O que o shield considera uma visita de anúncio — o link tem o parâmetro de marcador 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 |
Só o site de origem (referrer) não basta — é preciso o parâmetro. Em plataformas sem marcador de clique (por exemplo, Telegram), ninguém passa com o shield ativo.
O que muda com o shield ativo:
- O visitante sem marcador de clique vê a White Page.
- O visitante com marcador segue adiante, mas é verificado com mais rigor: VPN e proxy são sempre bloqueados; o bloqueio de datacenters, navegadores-robô e por listas negras de IP é ativado; na tag JS e no arquivo PHP, JavaScript e no mínimo 2 segundos na página de espera passam a ser obrigatórios (no Keitaro e no Binom não há página de espera).
- As regras de público funcionam normalmente: um visitante de um país não permitido vê a White Page mesmo com marcador de clique.
- O modo sombra e o modo “Tracker” ficam desligados enquanto o shield estiver ativo.
- Em todo o painel aparece o aviso “Escudo ativado” com o horário de término.
Parte dos visitantes reais sem marcador de clique — acessos diretos, links encaminhados, aberturas pelos favoritos — também vê a White Page enquanto o shield estiver ativo. Mantenha-o apenas pelo tempo que durar a revisão.
Como ativar manualmente a partir do Professional: Diagnóstico → aba Risco de ban → Ativar por 6h. O título do bloco mostra quanto tempo resta. Para desativar antes — Desativar o shield. Ao fim do prazo o shield se desativa sozinho; ativá-lo de novo não encurta um shield mais longo que já esteja ativo.
Lista compartilhada de bots
Se um serviço de verificação de anúncios, um robô da plataforma ou um programa em vez de navegador for identificado com certeza em qualquer cliente, o endereço é lembrado em todo o serviço. A próxima visita dele a qualquer um dos seus fluxos recebe a White Page na hora — sem verificações e sem atraso, e o log mostra “Endereço de bot conhecido”. Visitantes reais com rede duvidosa, VPN ou sem JavaScript não entram nessa lista. Endereços de datacenters e hospedagens ficam nela praticamente sem prazo; os residenciais e móveis, por 14 dias.
Shield automático
a partir do Professional A opção Ativar o shield automaticamente assim que uma revisão for detectada na aba Risco de ban. Quando a opção está marcada e o shield não está ativo, o título do bloco é “Shield em prontidão”.
- A cada 15 minutos, o ArtisanClo olha os fluxos ativos com tráfego e conta os sinais de revisão das últimas 3 horas: serviços de verificação de anúncios e robôs de pré-visualização das plataformas, inclusive os acessos repetidos de quem o serviço já reconheceu pelo endereço. O número é comparado com o nível habitual do fluxo na semana anterior.
- Níveis de risco:
- Tranquilo — tudo como de costume;
- De olho — sinais bem acima do normal (ou um fluxo novo que já recebeu um revisor). Chega uma notificação no sino, o shield não é ativado;
- Em revisão — um pico brusco: por exemplo, 8 ou mais sinais em 3 horas com nível habitual quase zero. Com o shield automático ligado, o shield é ativado por 6 horas; sem a opção, chega só uma notificação.
- A ativação do shield é avisada no sino e no Telegram: “A plataforma está revisando a sua campanha”.
Onda de revisões na rede. Uma vez por hora, o ArtisanClo olha todas as contas ao mesmo tempo. Se em um país houver, em 3 horas, muitos sinais de revisão em vários clientes ao mesmo tempo, três vezes acima do normal, é declarada uma onda. Os fluxos com shield automático que aceitam esse país recebem o shield por 3 horas. Os demais recebem a notificação “A plataforma está varrendo a rede” com a sugestão de ativar o shield manualmente.
Em revisão
Enquanto está ativo, todos os visitantes veem a White Page sem filtragem. Ative durante a análise do anúncio pela plataforma: os moderadores veem apenas a página segura. Nada é escrito na sua lista negra. Mas os revisores e bots da plataforma que o serviço identificar com certeza nesse período ficam registrados: as próximas visitas deles a qualquer fluxo recebem a White Page na hora.
Como ativar a partir do Professional: Diagnóstico → aba Risco de banimento → Ativar moderação. Não há prazo, desliga-se manualmente. Enquanto está ativo, todas as páginas do painel mostram o aviso “Fluxo em revisão”. O tráfego real também vai para a White Page nessas horas e não chega à oferta — desative assim que o anúncio for aprovado.
Ajuste automático
a partir do Professional A aba Ajuste automático no Diagnóstico. Uma vez por hora, o ajuste automático olha o fluxo e faz no máximo uma alteração por vez, no máximo uma vez a cada 6 horas, quando a semana já acumulou pelo menos 300 visitas.
- Shield: a estratégia “Cauteloso” ativa o shield já no nível “De olho”; “Equilibrado” e “Mais tráfego”, no nível “Em revisão”. Isso funciona independentemente da opção de shield automático.
- Proteção: ativa o bloqueio de datacenters, navegadores-robô, VPN, por listas negras de IP ou de visitas sem site de origem, se ele pegaria bots suficientes sem afetar nenhum pagamento. Ou remove uma regra que cortava visitantes com pagamentos.
- Pesos: desloca 10% do tráfego para a oferta com a melhor receita.
- GEO, dispositivos e horário o ajuste automático nunca altera. Enquanto o risco não estiver tranquilo ou o shield estiver ativo, ele não muda nada. No modo sombra o ajuste automático não funciona: lá não há o que otimizar.
- Cada alteração aparece no histórico 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 gerou pagamento e quem acabou sendo bot. Ele verifica apenas quem já passou pelas demais regras e envia para a White Page as visitas parecidas com os seus bots. Enquanto houver poucos dados próprios, funciona um modelo geral. Ele é retreinado toda noite e se desliga sozinho se começar a cortar uma parte perceptível das conversões.
Modo sombra e modo “Tracker”
- Modo sombra — com a 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 cortado (“Observado, não cortado”). Cliques no modo sombra não contam para o limite do período de teste. Na tag JS e no link do fluxo, o fluxo filtra normalmente.
- Modo “Tracker” — com a 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ão apenas marcados nos relatórios. Na tag JS e no link do fluxo, o fluxo filtra como no cloaking.
- Nem o modo sombra nem o tracker anulam a pausa do fluxo ou um plano não pago: nesses casos todos veem a White Page. Com o shield ativo, os dois modos são desligados.
Exemplos
| Situação | O que vê | No log |
|---|---|---|
Moderador do Facebook em navegador comum sem fbclid, shield ativo | White Page | “Shield: sem click id pago” |
| Robô do Facebook para pré-visualização de links — com ou sem shield | White Page | “Crawler de busca ou de plataforma” |
Pessoa real vinda do anúncio com fbclid, shield ativo | 2 segundos de espera (na tag e no arquivo PHP), depois a oferta | “Permitido” |
| A mesma pessoa usando VPN, shield ativo | White Page | “Rede de alto risco” ou “Pontuação de confiança baixa demais” |
| Pessoa abriu um link encaminhado sem marcador de clique, shield ativo | White Page | “Shield: sem click id pago” |
| Primeiro clique de um fluxo com aquecimento de 50 | White Page sem verificações — assim será com os primeiros 50 cliques, inclusive o seu endereço da whitelist | “Antes da filtragem” |
| Visita às 23:00 com horário 9:00–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, shield ativo | Oferta — a whitelist é verificada antes do limite e do shield | “Permitido pela whitelist” |
| Fluxo pausado, modo “Tracker” com 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” |
| Shield automático ativado, 9 revisores chegaram em 3 horas com nível habitual zero | Em até 15 minutos o shield é ativado por 6 horas; a partir daí todos sem marcador de clique veem a White Page | “Shield: sem click id pago” |
ArtisanClo · Documentação do painel. Dúvidas: info@artisanclo.com ou @artisanclo_support no Telegram.