Un cloaker solo funciona cuando está delante de tu página: el visitante llega por el enlace publicitario, el filtro comprueba la visita y decide qué mostrar, la oferta o la White Page. Mientras el código no esté instalado, ninguna configuración del flujo actúa: bots, escáneres y spy tools ven lo mismo que el comprador, y tú pagas sus clics. Por eso conectar el cloaker es el primer paso técnico después de crear el flujo, y merece atención. Si aún no has elegido servicio, empieza por el artículo comprar un cloaker: qué revisar antes.
Dónde vive el sitio cuando conectas un cloaker
Un error frecuente de los principiantes es pensar que el servicio de filtrado se lleva la landing a sus servidores y que en el anuncio va una dirección ajena. En ArtisanClo no es así. El sitio sigue siendo tuyo: tu hosting, tu dominio, tus archivos. En la página se pone un pequeño código o archivo, y todo lo demás (comprobar la visita, evaluar la confianza, elegir el destino) ocurre en el lado del servicio. En qué se diferencia este esquema en la nube de un script propio lo explicamos en cloaker en la nube o script propio.
De ahí se desprenden dos cosas prácticas:
- en el administrador de anuncios va la dirección de tu sitio, no un enlace a un dominio de terceros;
- la disponibilidad de la landing, el certificado SSL y la velocidad del hosting son responsabilidad tuya: el filtro no arregla un servidor lento.
Si te estás iniciando en el tema, lee primero qué es el cloaking y qué recorrido hace un clic: así entenderás mejor por qué el código debe ejecutarse antes que todo lo demás en la página.
Dos formas de conectar: comparación
La ventana de conexión se abre desde el menú del flujo: Flujos → fila del flujo → Más → Conectar. Ahí aparecen los métodos en tarjetas plegadas, con una sola abierta a la vez. Basta un método por flujo. El que funciona se marca en verde con la etiqueta «Instalado».
| Etiqueta JS | Archivo PHP | |
|---|---|---|
| Dónde actúa | En el navegador del visitante | En tu servidor, antes de entregar la página |
| Qué necesitas | Acceso al <head> de la página |
Hosting con PHP 7.2 o superior |
| Depende de bloqueadores y del orden de carga | Sí | No |
| Modo «Tracker» y modo sombra | Filtra como un cloaker normal | Funcionan |
| White Page por código de estado (403/404) | No puede cambiar el código de respuesta | Funciona |
| Actualización | No hace falta | El archivo no se actualiza solo; hace falta la versión nueva |
En pocas palabras: la etiqueta se pone más rápido y el archivo es más fiable. La configuración del filtrado es la misma en ambos casos: vive en el flujo, no en el código del sitio, y puedes cambiar de método sin tocar el flujo.
Cloaker JS: conexión con etiqueta
La etiqueta JS es una línea de script que insertas en el código de la landing. Mientras no llega la decisión, la etiqueta oculta la página, y si no hay decisión, lleva al visitante a la White Page.
Instalar la etiqueta JS paso a paso
- En la ventana Conectar, abre el método «Etiqueta JS» y copia el código.
- Pégalo como primera línea del
<head>en todas las páginas de la landing, no solo en la principal. - Guarda el archivo o publica la página y recárgala en el navegador.
- Pulsa Revisar mi página: el panel abrirá la página y buscará el código en ella.
Lo que no debes hacer con la etiqueta
- No la cargues con Google Tag Manager ni con otro gestor de etiquetas. Ejecutan los scripts más tarde y la página se muestra a todos, incluidos bots y spy tools, antes de la decisión.
- No añadas
asyncnidefer, por el mismo motivo. - No la pongas debajo de otros scripts: analítica, píxeles y widgets van después.
Consejo. Si el script de la etiqueta no carga (por ejemplo, porque lo corta la red o un bloqueador en el servidor), la página no se oculta y bots y spy tools verán la oferta. Por eso, después de cada cambio en el sitio, vuelve a pulsar «Revisar mi página».
Limitaciones de la etiqueta
La etiqueta funciona en el navegador, así que no puede cambiar el código de respuesta del servidor. Si la White Page está configurada en modo «Código de estado (200/403/404)», con la etiqueta JS quedará una página en blanco en lugar de la landing. El modo «Tracker» y el modo sombra tampoco funcionan con la etiqueta: un flujo con etiqueta filtra el tráfico como un cloaker normal.
Cloaker PHP: conexión con un archivo en el servidor
El archivo PHP es el método para sitios en un hosting con PHP. La decisión se toma en el servidor, antes de que el navegador reciba un solo byte de la página, así que no depende de los bloqueadores de anuncios ni de la velocidad de carga de los scripts.
Instalar el archivo PHP paso a paso
- En la ventana Conectar, pulsa Descargar archivo.
- Colócalo en la raíz de la landing con el nombre
index.php. - Cambia el nombre de tu landing, por ejemplo a
offer.php. - En la ficha de la oferta del flujo, indica la nueva dirección de la landing, por ejemplo:
https://tu-sitio.com/offer.php
- Pulsa Revisar mi página: el panel comprobará que el archivo responde.
El esquema queda así: el anuncio lleva a tu-sitio.com, allí recibe al visitante index.php, pide la decisión y muestra offer.php o la White Page.
Actualizar el archivo PHP
El archivo del servidor no se actualiza solo. Cuando sale una versión nueva, en la ventana de conexión aparece el aviso «Estás usando un archivo antiguo» con la lista de lo que tu versión actual no puede hacer. Descarga el archivo de nuevo y sustituye el anterior. La versión nueva hace falta, por ejemplo, para la White Page lista del catálogo, las reglas de «Parámetros del enlace de la oferta» y la verificación de interacción real.
Eso sí, tras cambiar la configuración del flujo no hace falta volver a subir el archivo: la configuración no se guarda en él, vive en el panel y se aplica desde la siguiente visita.
Qué necesita el hosting
- PHP 7.2 o superior;
- peticiones HTTPS salientes permitidas (el archivo tiene que comunicarse con el servicio);
- la extensión curl o
allow_url_fopenactivado.
El archivo espera respuesta hasta 4 segundos. Si no hay conexión, durante un día atiende las visitas según la última respuesta: a los visitantes con identificador de clic publicitario los lleva a la oferta y al resto, a la White Page. Una visita que llegue antes de la primera respuesta recibirá un error 503.
WordPress: un plugin en lugar de la instalación manual
Si la landing está hecha en WordPress, no hace falta tocar archivos: el plugin se instala desde el panel de administración y funciona con el mismo método de servidor. Está disponible desde el plan Professional; durante el periodo de prueba el sitio se conecta con la etiqueta JS o el archivo PHP. La instalación paso a paso, el trabajo con la caché y los errores típicos están en un artículo aparte: cloaker para WordPress.
Si tu tráfico pasa por un tracker, ArtisanClo también se integra ahí; lo explicamos en Keitaro y el cloaker y Binom y el cloaker. La lista de trackers compatibles está en la sección de integraciones con trackers.
Cómo comprobar que el cloaker está conectado
El botón Revisar mi página da una de tres respuestas:
| Respuesta | Qué significa |
|---|---|
| «Encontrado en tu página» | Todo en orden |
| «No encontrado en tu página» | El código no está o está en otra página |
| «No pudimos abrir tu página; eso no significa que no esté conectada» | El sitio o el hosting no dejó pasar la comprobación, lo que no quiere decir que la conexión falle |
Se puede comprobar una vez cada 20 segundos. Ten en cuenta que la comprobación borra las marcas anteriores de «Instalado» y «Conectado»: vuelven con la primera visita. Debajo del método se ve «Funciona ahora» o la fecha de la última actividad.
Después, haz una prueba real:
- Abre el enlace publicitario del flujo en una ventana de incógnito.
- Entra en el registro de clics: la visita debe aparecer con la decisión y el motivo.
- Si quieres ver la oferta tú mismo, añade tu dirección a la lista blanca de IP en el paso 4 del flujo (botón «Añadir mi IP»).
Consejo. Una visita repetida desde la misma dirección y navegador en menos de un minuto se une al clic anterior. Si la prueba no aparece en el registro, espera un minuto o entra desde otro dispositivo.
Si en el registro la visita tiene el motivo «Antes del filtrado», el flujo tiene activado el calentamiento: los primeros clics ven la White Page sin comprobaciones, y la lista blanca no ayuda aquí. Cómo leer los motivos lo explicamos en por qué un clic fue a la White Page.
Errores al conectar el cloaker
La mayoría de los casos de «el cloaker no funciona» se reducen a cinco situaciones.
Todos ven la página, incluso los bots
Casi siempre la culpa es de la caché: un plugin de caché, la caché del hosting o una CDN sirven una copia guardada de la página en lugar de pedir la decisión para cada visitante. Excluye la landing de la caché, vacíala y prueba en incógnito.
La página parpadea antes de la decisión
La etiqueta está cargada con un gestor de etiquetas, con async/defer o no está en la primera línea. Llévala a lo más alto del <head>.
Todas las visitas tienen la misma IP
Delante del sitio hay un proxy del hosting, y el archivo PHP ve la dirección del proxy en lugar de la del visitante. Pide al hosting que pase la dirección real (configuración real IP o mod_remoteip). Mientras no se corrija, el filtro no evalúa personas, sino tu servidor.
El hosting responde 403
El filtro de seguridad del hosting (WAF, ModSecurity) toma las peticiones de la página de comprobación por un ataque. Añade la dirección de la landing a las excepciones o pide al soporte del hosting que desactive el filtro para ese sitio.
El archivo PHP responde 503 o la página tarda mucho
El servidor no logra comunicarse con el servicio: las conexiones salientes están prohibidas o no hay curl. Revisa la versión de PHP y los permisos de red.
El análisis completo de averías y el orden de comprobación están en el cloaker no funciona: cómo comprobarlo y arreglarlo.
Conexión y velocidad de la landing
Cualquier filtro añade a la carga de la página el tiempo de la decisión, así que es lógico preguntarse si se perderá conversión por velocidad. Algunas consideraciones prácticas:
- La etiqueta oculta la página hasta que llega la decisión. Cuanto antes cargue, menor es la pausa: otro motivo para ponerla en la primera línea.
- El archivo PHP pide la decisión desde el servidor. Aquí importa la conexión de tu hosting con el exterior: un hosting barato y saturado ralentizará tanto la landing como la comprobación.
- El tiempo mínimo en la página y la verificación de interacción real añaden espera a propósito. Actívalos donde la plataforma justifique el rigor, no en todas partes por defecto.
- Una landing pesada (imágenes grandes, diez scripts de analítica) suele frenar más que el filtro. Optimizar la propia página a menudo da más que elegir el método de conexión.
Qué método elegir para tu caso
- Landing en un constructor o en un hosting ajeno sin PHP: etiqueta JS. Lo esencial, la primera línea del
<head>. - Hosting propio con PHP: archivo PHP. No depende del navegador y ofrece más posibilidades: código de estado en lugar de White Page, modo sombra, modo «Tracker».
- WordPress: el plugin, si tu plan lo incluye; si no, el archivo PHP.
- Flujo en modo «Tracker»: solo el archivo PHP; la etiqueta no aparece en la ventana de conexión para ese modo.
Para Google Ads, Facebook y TikTok la documentación recomienda cualquiera de los dos métodos; para las redes nativas, el archivo PHP. Las configuraciones listas por plataforma están en el catálogo de fuentes de tráfico, y la configuración del propio flujo (filtros, White Page, ofertas) en el artículo configuración del cloaker paso a paso.
Resumen
Conectar el cloaker es, o bien una línea de etiqueta JS como primera del <head>, o bien un archivo PHP como index.php con la landing renombrada. El sitio y el dominio siguen siendo tuyos. Tras la instalación, pulsa «Revisar mi página», abre el enlace en incógnito y busca la visita en el registro de clics. Si algo falla, la causa suele estar en la caché, el gestor de etiquetas o el proxy del hosting, y el registro de clics normalmente indica dónde exactamente.
