Vídeo Tutorial
Ao configurar Flows para Google Ads/Bing Ads, é essencial ativar:
JS Fingerprinting
Detecção automática de bots
Também é recomendado ativar:
Click ID Filtering (somente para Google Ads, Facebook, TikTok, X)
Filtragem por fuso horário
Verificar se o fuso horário do navegador corresponde à localização do visitante
Filtragem por touchscreen (no caso de campanhas de anúncio direcionadas apenas para dispositivos móveis)
Ao configurar Flows para Facebook/TikTok e redes nativas, não é recomendado ativar:
JS Fingerprinting
devido à possível perda significativa de tráfego.
É necessário criar um Flow separado para cada White Page, pois os arquivos de integração são únicos em cada Flow para evitar similaridade de código.
Não é necessário baixar novamente o script de integração para aplicar as configurações do Flow!
Após fazer alterações, basta salvar o Flow.
¶ Configuração básica
Para criar um Flow, acesse a seção Adicionar Flow.
Especifique o nome do Flow:
Escolha os países dos quais os visitantes devem ser redirecionados para a Black Page.
Se o seu público-alvo puder vir de qualquer país, deixe o campo vazio.
Selecione os tipos de dispositivo que devem ser redirecionados para a Black Page.
¶ Click ID Filtering (somente para Google Ads, Facebook, TikTok, X)
Esta opção aumenta a proteção contra Bots e, portanto, é recomendada.
A maioria das redes de anúncios adiciona automaticamente parâmetros especiais de rastreamento — conhecidos como Click IDs — aos links de saída dos anúncios.
Plataformas como Google Ads, Facebook, TikTok e X marcam todos os cliques em anúncios com parâmetros como gclid, fbclid, ttclid e twclid, respectivamente.
Quando o Click ID Filtering está ativado em um Flow, nosso sistema verifica a presença desses parâmetros. Somente visitantes que chegaram por essas plataformas com um Click ID válido serão redirecionados para a Black Page.
Usuários que acessarem a White Page diretamente (por exemplo, https://whitepage.com) sem um Click ID permanecerão na White Page.
Com o Click ID Filtering ativado, para verificar o redirecionamento para a Black Page, você precisa acessar a White Page usando proxies residenciais ou IP doméstico (adicionando temporariamente seu país no Flow) com um dos parâmetros especiais:
/?gclid=Cj0KCQiAmpyRBhC-ARIsABs2EArUH0fVxaDZJyqvuAUjkHhEgQAWmTfENIrJyQ7tJtteDAdfryCV4REaAoXnEALw_wcB
/?fbclid=IwZXh0bgNhZW0BMABhZGlkAasiGubG6G8BHqZjGzm7XfLiVu9HxL0Tg26N-UW1caX1LivHv7Bs6a9V2lKfwpXfyWCafh5n_aem_3D1vsYzVVLVEAxbwWO1xTg
/?ttclid=E_C_P_Cs4Bd-b1Zat3i8BM2PCbJUrjR6A12vLy-xLlNTlFH2c04k_lxzIsoLIbeLUyADgPOQiQBfY0TLNL9h4QNL9V8wP82qW-gS7J2uvco_gsiSbmCgk0QfO1bQrENYcct0U8Rr2fY9_LFRUOohCYIoJfpWvHdT2b_rerYcmawgwz5SR-oo3-zPFx00pEU1ybeBRqAB_CCBVyKelPxDYk2A9HQ_OCTdFwADN5hdLtN-TBsyQn3UbT
/?twclid=22govadmpiikxivhnlk2lvzgjw
que devem ser adicionados ao domínio da White Page:
https://whitepage.com/?gclid=Cj0KCQiAmpyRBhC-ARIsABs2EArUH0fVxaDZJyqvuAUjkHhEgQAWmTfENIrJyQ7tJtteDAdfryCV4REaAoXnEALw_wcB
Esses parâmetros de Click ID servem somente para verificar a configuração do Flow e o redirecionamento quando o Click ID Filtering está ativado.
Você não precisa adicioná-los à campanha de anúncios.
Basta especificar o link comum da White Page sem Click ID (por exemplo, https://whitepage.com).
¶ Adicionando o link da Black Page
Especifique o link para a Black Page no formato absoluto (com os protocolos https:// ou http://). Recomendamos ativar SSL em todos os seus sites, pois você pode perder tráfego devido às políticas de segurança dos navegadores.
Esse link pode ser:
um diretório separado no mesmo domínio da White Page:
https://whitepage.com/black_page
ou um subdomínio da White Page:
https://black.whitepage.com
ou um site em um domínio externo:
https://blackpage.com
Com isso, a configuração básica de filtragem automática de Bots para Facebook, TikTok, redes nativas e teaser está concluída.
Para configurações opcionais e download dos scripts de integração, acesse as seções Configuração opcional e Configuração de Integração.
Se você estiver configurando um Flow para Google Ads e Bing Ads — prossiga para a próxima seção.
¶ Opção de JS Fingerprinting
Configuração obrigatória para filtrar Bots de Google Ads e Bing Ads.
Se você não ativar essa opção, a distribuição do tráfego será baseada apenas em parâmetros PHP.
Lembre-se: PHP não fornece dados suficientes para filtragem eficaz de Bots dessas redes.
¶ Filtragem por fuso horário (recomendado)
A filtragem por fuso horário não é obrigatória, mas pode ser usada se necessário.
Ao selecionar fusos horários, considere que muitos países têm múltiplos fusos.
Você deve especificar todos os fusos horários dos países que devem ter acesso permitido à Black Page.
Observação: adicionar filtragem por fuso horário pode aumentar a perda de tráfego.
¶ Verificar se o fuso horário do navegador corresponde à localização do visitante (recomendado)
Ao ativar esta opção, o sistema verifica se o fuso horário configurado no sistema operacional do visitante corresponde à sua localização real.
¶ Filtragem por touchscreen
Se o Flow for usado apenas para tráfego mobile, você pode ativar a filtragem por touchscreen.
Na Black Page, somente visitantes usando dispositivos com touchscreen serão permitidos.
¶ Detecção automática de bots (Tecnologia Matchex®)
A Tecnologia Matchex® é um filtro obrigatório para Cloaking em Google Ads e Bing Ads, permitindo identificar padrões comuns mesmo entre Bots avançados.
Parâmetros fora do padrão são determinados para cada visitante, e o filtro passa a buscá-los entre outros visitantes.
Assim, o sistema se autoajusta e filtra Bots automaticamente.
¶ Configuração opcional
Este bloco de configuração não é obrigatório (clique para expandir)
Esta funcionalidade permite filtrar o tráfego adicionalmente com base em:
• Internet Service Providers (ISPs);
• Sub-redes (CIDR);
• Endereços IP individuais;
• UserAgent;
Também permite autorizar visitantes na Black Page com base em:
• HTTP referrers específicos;
• Sub-redes específicas (CIDR);
Ao adicionar parâmetros, verifique se o formato está correto — os campos exibem modelos como referência.
Observe que adicionar uma lista de HTTP referrers permitidos pode causar perda significativa de tráfego alvo.
Se quiser filtrar UserAgents por substring (ou seja, se o UserAgent contiver um texto específico), coloque a string desejada entre chaves {}.
Por exemplo, para bloquear todos os UserAgents que contêm o seguinte trecho:
Macintosh; Intel Mac OS X 10_15_7
insira no campo Block UserAgents:
{Macintosh; Intel Mac OS X 10_15_7}
Isso bloqueará qualquer UserAgent que inclua esse texto. Por exemplo:
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36
Após configurar todos os parâmetros de filtragem, salve o Flow e prossiga com a configuração na seção Configuração de Integração.
¶ Configuração de Integração
¶ Tipos de Integração
Existem dois tipos de integração suportados:
-
Integração PHP
Neste tipo de integração, a conexão entre o Flow no hoax.tech e a White Page é feita usando o arquivo PHPindex.php, que é baixado no Flow e enviado para seu servidor no diretório da White Page. Este é o método de integração mais utilizado. -
Integração JavaScript
Usado quando a White Page está hospedada em serviços externos que não suportam processamento de código PHP. Por exemplo: Tilda, Shopify, Wix, Blogspot, GitHub.
Nesse caso, o arquivo PHP do Flow é enviado para qualquer servidor secundário, e um script especial é gerado e inserido no código HTML original da White Page.
Na integração PHP clássica com seu servidor para a White Page, a ação padrão para a Black Page é o Redirect 302, que é automaticamente substituído por JavaScript Redirect quando o JS Fingerprinting está ativado no Flow.
Portanto, é recomendado manter as configurações padrão:
Na Integração JavaScript usando serviços de builders terceirizados para hospedar a White Page, a ação padrão da Black Page é o JavaScript Redirect.
Também é recomendado usar os parâmetros padrão:
¶ Tipos de Ações da Black Page
Dependendo do tipo de filtragem ativada nas configurações do Flow e do tipo de integração, existem sete tipos de ações possíveis para a Black Page:
Todos os tipos de ações e suas combinações com os tipos de integração (clique para expandir)
-
JavaScript Redirect
O redirecionamento ocorre no lado do navegador, resultando em menor velocidade comparado aos outros tipos.
É o único tipo possível quando o JS Fingerprinting está ativado — requisito para filtrar bots avançados do Google Ads/Bing Ads. -
iframe
Esse método de exibição usa a tag<iframe>e permite incorporar páginas web (Black Page) ou outros conteúdos diretamente na White Page, dentro de uma janela separada.
A exibição da Black Page em um iframe pode ser bloqueada por meio de cabeçalhos X-Frame-Options. Nesse caso, a ação via iframe não funcionará. -
Redirect 301
Redirecionamento permanente. Após a primeira visita à Black Page, seu URL e conteúdo serão armazenados no cache do navegador. Em visitas futuras, o usuário sempre será enviado diretamente para essa página, ignorando nosso sistema. Mesmo que o URL da Black Page seja alterado nas configurações do Flow, será necessário limpar o cache do navegador para que as alterações tenham efeito. -
Redirect 302
Redirecionamento temporário. O navegador entende que o endereço é temporário e não armazena o conteúdo em cache.
Este é o tipo configurado por padrão na filtragem PHP. -
Redirect 303
"View other". Semelhante ao Redirect 302 temporário. -
HTML Meta Refresh
Redirecionamento usando a estruturameta http-equiv="refresh", instruindo o navegador a recarregar a página após determinado período ou redirecionar o visitante para outro URL. -
Inserir código HTML
Substituição de conteúdo. Quando essa ação é executada, a Black Page é carregada usando XMLHttpRequest síncrono ou via cURL e substitui o conteúdo da White Page sem realizar redirecionamento. -
Set Cookie
Sem ação de redirecionamento. Se o visitante for identificado como bot, um cookie com o hash do Flow é definido via HTTP Set-Cookie, no formato:
58cfe539d816ec78a117474c2a76617f
Esse método pode ser usado, por exemplo, para exibir conteúdos diferentes no site, entregar diferentes arquivos quando um botão é pressionado, etc.
¶ Combinando tipos de integração e ações
Se ações incompatíveis como Redirect 301, 302, 303 ou HTML Meta Refresh forem selecionadas, elas serão substituídas automaticamente por JavaScript Redirect.
¶ Tipo de ação Inserir código HTML
Quando essa ação é executada, a Black Page é carregada usando XMLHttpRequest síncrono ou via cURL e substitui o conteúdo da White Page sem realizar redirecionamento.
Ao utilizar o tipo de ação Inserir código HTML:
-
O domínio da White Page permanece inalterado na barra de endereço do navegador após o carregamento da Black Page.
-
A Black Page é exibida diretamente ao público-alvo sem redirecionamento.
Requisitos para funcionamento correto
- Caminhos absolutos para os recursos da Black Page.
No código-fonte da Black Page, todos os caminhos de recursos devem ser absolutos e incluir o domínio.
<link href="https://black.hoax.tech/assets/main.css">
<script src="https://black.hoax.tech/assets/main.js"></script>
Exemplo:
Se sua Black Page utiliza caminhos relativos, adicione o seguinte código com o domínio da Black Page imediatamente após a tag <title> para facilitar a conversão para caminhos absolutos:
<base href="insira_o_link_da_black_page_aqui/">
Exemplo:
- Posicionamento do domínio da Black Page.
O domínio da Black Page pode ser configurado de uma das seguintes formas:
- Em um diretório separado dentro do domínio da White Page.
Por exemplo: https://whitepage.com/black
Nesse caso, nenhuma configuração adicional é necessária.
- Em um domínio diferente ou em um subdomínio da White Page.
Por exemplo:
https://black.hoax.tech/
https://black.whitepage.com/
Nesse caso, é necessário habilitar requisições cross-origin (CORS).
Adicione o seguinte código no início do arquivo da Black Page:
<?php
header("Access-Control-Allow-Origin: *");
header("Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS");
header("Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With");
?>
Exemplo:
Importante:
— O PHP deve estar instalado no servidor da Black Page.
— O arquivo principal deve ter a extensão .php (por exemplo, index.php).
— Se a Black Page estiver localizada em um subdiretório do domínio, o servidor pode adicionar automaticamente uma barra final (/) e realizar um redirecionamento adicional para que o navegador resolva corretamente os caminhos dos arquivos e carregue os recursos relacionados. Esse redirecionamento pode afetar o funcionamento da Black Page. Para evitar problemas, certifique-se de que a URL da Black Page esteja especificada corretamente ou coloque-a no diretório raiz do domínio.
- Particularidades do carregamento da Black Page.
- Se o JS Fingerprinting estiver ativado no Flow, a Black Page é carregada de forma assíncrona via XMLHttpRequest.
- Se apenas a filtragem PHP estiver ativada no Flow, a Black Page é obtida via cURL.
¶ Instalação
¶ Instalação para Integração PHP
Após selecionar o tipo de integração (neste caso, PHP) e o tipo de ação (você pode deixar Redirect 302):
- Baixe o arquivo index.php;
- Acesse o painel de hospedagem;
- Renomeie o arquivo de inicialização da White Page para index2.php (se o arquivo for index.html, renomeie também para index2.php, alterando a extensão para .php);
- Envie o arquivo index.php baixado do Flow para o diretório raiz do site;
Deve ficar assim (index2.php é o arquivo renomeado da White Page e index.php é o arquivo baixado do Flow):
¶ Instalação alternativa para Integração PHP (Beta)
Nesse tipo de integração, o script é conectado por meio de uma requisição GET que emula o carregamento de um arquivo JavaScript externo.
Esse processo ocorre automaticamente dentro do código da White Page, permitindo incorporar o script PHP sem qualquer ajuste manual.
O processo de instalação é idêntico ao da Integração PHP clássica, envolvendo renomear o arquivo de inicialização da White Page e enviar o arquivo PHP baixado do Flow.
Após a instalação, dentro do código da White Page, uma requisição GET para o script de integração é injetada dentro da tag <head> em uma posição aleatória.
Usando nomes reais de scripts, o código parece natural para um frontend típico e se mistura ao restante das conexões, dificultando o treinamento de modelos de detecção e atrasando a identificação de padrões recorrentes.
¶ Instalação para Integração JavaScript
A instrução completa está aqui
Após selecionar o tipo de integração (neste caso, JavaScript) e o tipo de ação (você pode deixar JavaScript Redirect):
- Baixe o arquivo de integração query.php e envie-o para qualquer servidor ou hospedagem compartilhada;
- Especifique o link absoluto para o arquivo de integração
⚠️ somente domínios com certificado SSL são suportados (protocolo https://)
(por exemplo: https://myscriptpage.com/query.php) - Gere o código de integração no construtor do site;
- Copie o código e cole-o na White Page após a tag
<body>:
<!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
▶ cole aqui o código copiado ◀
...
</body>
</html>
¶ Verificação da correção das configurações
Verifique a configuração acessando a White Page a partir do seu IP residencial, permitido no país definido no Flow, ou usando proxies residenciais.
Se quiser testar o redirecionamento usando um IP de VPN/IPv4 proxy, adicione esse IP ao Flow no campo IP permitido para teste.
Nesse método, todas as configurações do Flow e os fingerprints do navegador são ignorados.
Se a opção Click ID Filtering estiver ativada, para verificar o redirecionamento para a Black Page, acesse a White Page com um parâmetro especial de Click ID:
/?gclid=Cj0KCQiAmpyRBhC-ARIsABs2EArUH0fVxaDZJyqvuAUjkHhEgQAWmTfENIrJyQ7tJtteDAdfryCV4REaAoXnEALw_wcB
adicionado ao domínio da White Page:
https://whitepage.com/?gclid=Cj0KCQiAmpyRBhC-ARIsABs2EArUH0fVxaDZJyqvuAUjkHhEgQAWmTfENIrJyQ7tJtteDAdfryCV4REaAoXnEALw_wcB
Esse parâmetro Click ID serve somente para verificar a configuração do Flow e o redirecionamento para a Black Page quando o Click ID Filtering está ativado.
Não o adicione à campanha de anúncios — basta especificar o link comum da White Page.
Abra o Dashboard, onde as visitas serão exibidas:
Se as visitas de teste não aparecerem no Dashboard, a White Page não está funcionando ou você encontrou erros no navegador.
Use a seção Troubleshooting ou entre em contato via Telegram ou Live chat.