Vídeo tutorial
Al configurar Flows para Google Ads/Bing Ads, es esencial habilitar:
JavaScript Fingerprinting;
Detección automática de bots;
También se recomienda habilitar:
Opción Click ID Filtering (solo para Google Ads, Facebook, TikTok, X);
Filtrado por zona horaria;
Coincidencia de la zona horaria del navegador con la ubicación del visitante;
Filtrado por pantalla táctil (en caso de orientar campañas publicitarias solo a dispositivos móviles);
Al configurar Flows para Facebook/TikTok y redes nativas, no se recomienda habilitar:
JavaScript Fingerprinting
debido a la posible pérdida significativa de tráfico.
Es necesario crear un Flow separado para cada white page porque los archivos de integración son únicos en cada Flow para evitar la similitud del código.
¡No es necesario volver a descargar el script de integración para aplicar los ajustes del Flow!
Después de realizar cambios, simplemente guarde el Flow.
¶ Configuración básica
Para crear un Flow, vaya a la sección Agregar Flow.
Especifique el nombre del Flow:
Elija los países desde los cuales los visitantes deben ser redirigidos a la black page.
Si sus visitantes objetivo pueden provenir de cualquier país, deje el campo vacío.
Seleccione los tipos de dispositivos para los cuales desea redirigir visitantes a la black page.
¶ Click ID Filtering (solo para Google Ads, Facebook, TikTok, X)
Esta opción mejora la protección contra bots y por lo tanto es recomendable.
La mayoría de las redes publicitarias agregan automáticamente parámetros especiales de seguimiento —conocidos como Click IDs— a los enlaces de los anuncios.
Plataformas como Google Ads, Facebook, TikTok y X etiquetan todos los clics con parámetros como gclid, fbclid, ttclid y twclid.
Cuando Click ID Filtering está habilitado en un Flow, nuestro sistema verifica la presencia de estos parámetros. Solo los visitantes que lleguen desde estas plataformas con un Click ID válido serán redirigidos a la black page.
Los usuarios que accedan directamente a la white page (por ejemplo, https://whitepage.com) sin Click ID permanecerán en la white page.
Con Click ID Filtering habilitado, para verificar la redirección a la black page debe acceder a la white page usando proxies residenciales o su IP doméstica (agregando temporalmente su país al Flow) con uno de los parámetros especiales:
/?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 se agregan al dominio de la white page:
https://whitepage.com/?gclid=Cj0KCQiAmpyRBhC-ARIsABs2EArUH0fVxaDZJyqvuAUjkHhEgQAWmTfENIrJyQ7tJtteDAdfryCV4REaAoXnEALw_wcB
Estos parámetros Click ID se usan solo para verificar la configuración correcta del Flow y la redirección a la black page.
No necesita agregarlos en la campaña publicitaria: simplemente especifique el enlace normal de la white page (por ejemplo, https://whitepage.com).
¶ Añadir el enlace de la Black Page
Especifique el enlace a la black page en formato absoluto (con el protocolo https:// o http://).
Recomendamos habilitar siempre SSL en todos sus sitios, ya que las políticas de seguridad del navegador pueden causar pérdida de tráfico.
La URL puede ser:
un directorio separado en el mismo dominio donde está la white page:
https://whitepage.com/black_page
o un subdominio de la white page:
https://black.whitepage.com
o un sitio en un dominio externo:
https://blackpage.com
Esto completa la configuración básica para el filtrado automático de bots en redes publicitarias como Facebook, TikTok, Native y Teaser.
Para la configuración opcional y descarga del script de integración, vaya a las secciones Configuración opcional y Configuración de la Integración.
Si está configurando un Flow para Google Ads y Bing Ads, continúe a la siguiente sección.
¶ Opción JavaScript Fingerprinting
Una configuración obligatoria para filtrar bots de Google Ads y Bing Ads.
Si no activa esta opción, la distribución del tráfico se basará únicamente en parámetros PHP.
Tenga en cuenta que PHP no puede proporcionar suficiente información para un filtrado efectivo de bots de Google y Bing.
¶ Filtrado por zona horaria (recomendado)
El filtrado por zona horaria no es obligatorio, pero puede usarlo si es necesario.
Tenga en cuenta que muchos países abarcan varias zonas horarias.
Debe especificar todas las zonas horarias de los países cuyos visitantes deben tener acceso a la black page.
Nota: agregar el filtrado por zona horaria puede aumentar la pérdida de tráfico
¶ Coincidencia de la zona horaria del navegador con la ubicación del visitante (recomendado)
Habilitar esta opción verifica la coincidencia entre la zona horaria configurada en el sistema operativo del visitante y su ubicación real.
¶ Filtrado por pantalla táctil
Si el Flow personalizado está destinado solo para tráfico móvil, puede habilitar adicionalmente el filtrado por pantalla táctil.
En la black page, solo se permitirá el acceso a visitantes cuyos dispositivos tengan pantalla táctil.
¶ Detección automática de bots (Tecnología Matchex®)
La tecnología Matchex® es un filtro obligatorio para el cloaking de Google Ads y Bing Ads, que permite identificar características comunes incluso entre los bots más avanzados.
Los parámetros que se desvían de la norma se determinan para cada visitante y, posteriormente, el filtro los busca entre otros visitantes.
De este modo, el sistema se auto-entrena y filtra bots automáticamente.
¶ Configuración opcional
Este bloque de configuración no es obligatorio (clic para expandir)
Esta funcionalidad permite un filtrado adicional del tráfico según:• Proveedores de Internet (ISP);
• Subredes (CIDR);
• Direcciones IP individuales;
• User-Agent;
También permite admitir visitantes en la black page según:
• Referers HTTP específicos;
• Subredes específicas (CIDR);
Al agregar parámetros, asegúrese de utilizar el formato correcto, ya que dentro de los campos se proporcionan plantillas.
Tenga en cuenta que agregar una lista de referers HTTP permitidos puede provocar una pérdida significativa de tráfico objetivo.
Si desea filtrar UserAgents por subcadena (es decir, si el UserAgent contiene un texto específico), envuelva la cadena objetivo en llaves {}.
Por ejemplo, para bloquear todos los UserAgents que contengan el siguiente fragmento:
Macintosh; Intel Mac OS X 10_15_7
ingréselo en el campo Block UserAgents así:
{Macintosh; Intel Mac OS X 10_15_7}
Esto bloqueará cualquier UserAgent que incluya este texto. Por ejemplo:
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
Después de configurar todos los parámetros de filtrado, guarde el Flow y luego continúe con la configuración en la sección Configuración de la Integración.
¶ Configuración de la Integración
¶ Tipos de integración
Se admiten dos tipos de integración:
-
Integración PHP
En este tipo de integración, la conexión entre el Flow en hoax.tech y la white page se realiza mediante el archivo PHPindex.php, que se descarga en el Flow y se sube a su servidor en el directorio de la white page.
Este es el método de integración más utilizado. -
Integración JavaScript
Se utiliza cuando la white page está alojada en servicios web que no admiten procesamiento de código PHP.
Por ejemplo, plataformas como Tilda, Shopify, Wix, Blogspot, Github.
En este caso, el archivo PHP del Flow se sube a cualquier servidor secundario y se genera un script especial que se agrega al código HTML de la white page.
En la integración PHP clásica con su propio servidor para la white page, la acción predeterminada para la black page es Redirect 302, que se reemplaza automáticamente por un JavaScript Redirect cuando JavaScript Fingerprinting está habilitado en el Flow.
Por lo tanto, se recomienda usar los parámetros predeterminados:
En la integración JavaScript usando servicios externos para alojar la white page, la acción predeterminada para la black page es JavaScript Redirect.
También se recomienda usar los parámetros predeterminados:
¶ Tipos de acciones para la Black Page
Dependiendo del tipo de filtrado habilitado en la configuración del Flow y del tipo de integración, existen siete tipos de acciones para la black page:
Todos los tipos de acciones y sus combinaciones con los tipos de integración (clic para expandir)
-
JavaScript Redirect
La redirección ocurre del lado del navegador, lo que resulta en una velocidad de redirección más lenta en comparación con otros tipos.
Este es el único tipo de redirección posible cuando JavaScript Fingerprinting está habilitado, necesario para filtrar bots avanzados de Google Ads/Bing Ads. -
iframe
Este método de visualización, mediante la etiqueta<iframe>, permite incrustar la black page y otros contenidos directamente en la white page dentro de una ventana separada.
La visualización de la black page en un iframe puede deshabilitarse mediante encabezados X-Frame-Options. En este caso, la acción iframe no funcionará. -
Redirect 301
Redirección permanente.
Si activa un redirect 301, después de la primera visita a la black page, su URL y contenido se almacenarán en caché en el navegador del visitante.
En visitas posteriores, el visitante será dirigido siempre a esa página, pasando por alto nuestro sistema.
Incluso si cambia la URL de la black page o los ajustes del Flow, será necesario limpiar la caché del navegador para que los cambios surtan efecto. -
Redirect 302
Redirección temporal.
Cuando se usa este método, el navegador recibe la señal de que la dirección es temporal, por lo que no almacena el contenido en caché.
Este tipo de acción se establece por defecto para la filtración PHP. -
Redirect 303
View other.
Este tipo de redirección es similar al redirect temporal 302. -
HTML Meta Refresh
Redirección mediantemeta http-equiv="refresh", que ordena al navegador recargar la página después de cierto tiempo o dirigir al usuario a otra URL. -
Insert HTML Code
Reemplazo de contenido. Cuando se ejecuta esta acción, la black page se carga mediante una solicitud síncrona XMLHttpRequest o vía cURL y reemplaza el contenido de la white page sin realizar una redirección. -
Set Cookie
Acción sin redirección. Si el visitante es identificado como bot, se establece una cookie con el hash del Flow en este formato:
58cfe539d816ec78a117474c2a76617f
Este método puede utilizarse, por ejemplo, para mostrar contenido diferente en el sitio o entregar distintos archivos al presionar un botón.
¶ Combinación de tipos de integración y acciones
Si se seleccionan acciones incompatibles como Redirect 301, Redirect 302, Redirect 303 o HTML Meta Refresh, serán reemplazadas automáticamente por JavaScript Redirect.
¶ Tipo de acción Insert HTML Code
Cuando se ejecuta esta acción, la black page se carga mediante una solicitud síncrona XMLHttpRequest o vía cURL y reemplaza el contenido de la white page sin realizar una redirección.
Al utilizar el tipo de acción Insert HTML Code:
-
El dominio de la white page permanece sin cambios en la barra de direcciones del navegador después de cargar la black page.
-
La black page se muestra directamente a la audiencia objetivo sin redirección.
Requisitos para un funcionamiento correcto
- Rutas absolutas a los recursos de la black page.
En el código fuente de la black page, todas las rutas de los recursos deben ser absolutas e incluir el dominio.
<link href="https://black.hoax.tech/assets/main.css">
<script src="https://black.hoax.tech/assets/main.js"></script>
Ejemplo:
Si su black page utiliza rutas relativas, agregue el siguiente código con el dominio de la black page inmediatamente después de la etiqueta <title> para simplificar su conversión a rutas absolutas:
<base href="insertar_enlace_de_black_page_aqui/">
Ejemplo:
- Ubicación del dominio de la black page.
El dominio de la black page puede colocarse de una de las siguientes maneras:
- En un directorio separado dentro del dominio de la white page.
Por ejemplo: https://whitepage.com/black
En este caso, no se requiere configuración adicional.
- En un dominio diferente o en un subdominio de la white page.
Por ejemplo:
https://black.hoax.tech/
https://black.whitepage.com/
En este caso, se deben habilitar solicitudes cross-origin (CORS).
Agregue el siguiente código al inicio del archivo de la 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");
?>
Ejemplo:
Importante:
— PHP debe estar instalado en el servidor de la black page.
— El archivo de entrada debe tener extensión .php (por ejemplo, index.php).
— Si la black page está ubicada en un subdirectorio del dominio, el servidor puede agregar automáticamente una barra final (/) y realizar una redirección adicional para que el navegador resuelva correctamente las ubicaciones de archivos y cargue los recursos relacionados. Esta redirección puede afectar el funcionamiento de la black page. Para evitar problemas, asegúrese de que la URL de la black page esté especificada correctamente o colóquela en el directorio raíz del dominio.
- Particularidades de carga de la black page.
- Si JavaScript Fingerprinting está habilitado en el Flow, la black page se carga de forma asíncrona mediante XMLHttpRequest.
- Si solo está habilitado el filtrado PHP en el Flow, la black page se obtiene mediante cURL.
¶ Instalación
¶ Instalación para integración PHP
Después de seleccionar el tipo de integración (en este caso, PHP) y el tipo de acción (puede dejar Redirect 302):
- Descargue el archivo index.php;
- Vaya al panel de hosting;
- Cambie el nombre del archivo de inicio de la white page a index2.php (si el archivo de inicio es index.html, cámbielo también a index2.php ajustando la extensión a .php);
- Cargue el archivo index.php previamente descargado desde el Flow al directorio raíz del sitio;
Debería quedar algo así (index2.php es el archivo renombrado de inicio de la white page, e index.php es el archivo descargado del Flow):
¶ Instalación alternativa para integración PHP (Beta)
Con este tipo de integración, el script se conecta mediante una solicitud GET que emula la carga de un archivo JavaScript externo. Este proceso se ejecuta automáticamente dentro del código de la white page, lo que permite incrustar el script PHP sin ajustes manuales.
El proceso de instalación es idéntico al de la integración PHP clásica, implicando renombrar el archivo de inicio de la white page y cargar el script PHP descargado del Flow.
Después de la instalación, dentro del código de la white page, se inyecta una solicitud GET al script JS de integración dentro de la etiqueta en una ubicación aleatoria.
Al utilizar nombres reales de scripts, el código parece natural para un frontend típico y se mezcla con otras conexiones, dificultando el entrenamiento de modelos de detección y ralentizando la identificación de patrones repetitivos.
¶ Instalación para integración JavaScript
La instrucción completa está aquí
Después de seleccionar el tipo de integración (en este caso, JavaScript) y el tipo de acción (puede dejar JavaScript Redirect):
- Descargue el archivo de integración query.php y súbalo a cualquier servidor o hosting compartido;
- Especifique el enlace al archivo de integración en formato absoluto (⚠️solo se admiten dominios con certificado SSL — protocolo https://);
(por ejemplo, https://myscriptpage.com/query.php) - Genere el código para la integración en el constructor del sitio;
- Copie el código y péguelo en la white page después de la etiqueta
<body>:
<!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
▶ pegue aquí el código copiado ◀
...
</body>
</html>
¶ Verificación de la corrección de la configuración
Verifique la configuración accediendo a la white page desde su IP doméstica, permitida en los países del Flow, o utilizando proxies residenciales.
Si desea probar la redirección con una IP VPN/IPv4 proxy, agregue la dirección IP al Flow en el campo "Test IP". Con este método, todos los filtros del Flow y las huellas del navegador se ignoran.
Si la opción Click ID Filtering está habilitada, para verificar la redirección a la black page, vaya a la white page con el parámetro especial:
/?gclid=Cj0KCQiAmpyRBhC-ARIsABs2EArUH0fVxaDZJyqvuAUjkHhEgQAWmTfENIrJyQ7tJtteDAdfryCV4REaAoXnEALw_wcB
que se añade al dominio de la white page:
https://whitepage.com/?gclid=Cj0KCQiAmpyRBhC-ARIsABs2EArUH0fVxaDZJyqvuAUjkHhEgQAWmTfENIrJyQ7tJtteDAdfryCV4REaAoXnEALw_wcB
Este parámetro Click ID se usa únicamente para comprobar la correcta configuración del Flow y la transición a la black page cuando la opción Click ID Filtering está habilitada.
No lo agregue en la campaña publicitaria. Simplemente especifique el enlace normal a la white page.
Abra el Panel, donde deberían mostrarse las visitas:
Si las visitas de prueba no aparecen en el Dashboard, la white page no funciona o encuentra errores en el navegador, utilice la sección Troubleshooting o contáctenos vía Telegram o Live chat.