Cloaking: referencia completa
El esquema de flujo Cloaking divide el tráfico en dos ramas: los visitantes sospechosos (bots, moderadores, data centers, VPNs) ven la página segura, las personas reales la money page. Un solo módulo (core/CloakDetector.php) toma la decisión para todos los puntos de entrada: la URL de campaña (index.php), click.php y la Click API v3.
Un artículo técnico detallado en inglés: How the Orbitra Cloaker Works.
Configuración del flujo
Safe page
HTML integrado, una URL externa, una landing local o una oferta local. Las landings y ofertas de la lista se agrupan por grupo, con buscador.
Money page
Funciona como el esquema "Landing + Offer", incluida la selección de oferta "before the click / after the click".
Visitantes limpios al siguiente flujo
El checkbox "Send clean visitors to the next stream" convierte el cloak en un filtro de entrada. Los visitantes sospechosos reciben la página segura, mientras que los limpios continúan por la lista de flujos — geos, dispositivos e idiomas se reparten por flujos regulares. La money page de este flujo no se usa en este modo. Pon ese flujo primero o hazlo intercepting para que cada visitante pase la comprobación.
Capas de detección
| Capa | Fuente | No funciona sin |
|---|---|---|
| Data centers / hosting | Una blocklist ASN (core/data/asn_blocklist.json), rangos publicados de nubes y crawlers, palabras clave de hosting en el nombre del ISP | La base de datos ASN (GeoLite2-ASN) |
| VPN / proxy | IP2Proxy PX12 (VPN, TOR, residencial, threat, fraud score ≥ 80), una lista de VPN-ASN | IP2Proxy PX12 / la base de datos ASN |
| Bot blacklists | IPs y firmas de User-Agent de Settings → Bots | — |
| Heurísticas de User-Agent | Crawlers y herramientas (facebookexternalhit, meta-externalagent, curl, python, headless…), un User-Agent vacío, un Accept-Language ausente | — |
Si falta una base de datos requerida, el editor de campaña muestra una advertencia justo en la tarjeta del cloak.
Sensibilidad
Las señales son duras (una coincidencia explícita en una blocklist o base de datos de reputación) o suaves (heurísticas ruidosas por sí solas).
| Nivel | Página segura cuando |
|---|---|
| Low | solo una señal dura |
| Medium (por defecto) | una señal dura, o dos suaves |
| High | cualquier señal por sí sola |
Filtros de targeting
Se aplican después de las capas pasivas; un fallo significa la página segura (TARGETING_SAFE):
- Countries — permitir o bloquear una lista. Si el país no se puede determinar, el motivo se registra como
geo_unknownen lugar degeo_country. Sin una base de datos geo todo visitante esUnknown, y el filtro de país enviará el 100% del tráfico a la página segura; el editor avisa de esto. - Device types — solo los seleccionados, o todos menos los seleccionados.
- Block bots and data-center providers — el ISP y el ASN del visitante comparados contra una lista: la lista local del flujo o, si está vacía, la global de Settings → Bots.
Verificación de JavaScript
Desactivada por defecto. El visitante primero recibe la página segura y pasa a la money page vía un enlace firmado de un solo uso (TTL 5 minutos) solo después de ejecutar JS. navigator.webdriver = true se queda en la página segura. Igual que todo lo que no ejecuta JS. El precio es un salto extra para cada visitante vivo.
Con el browser check activado (Settings → Bots), el mismo paso también recoge señales del navegador: en modo Soft o Strict una máquina virtual, un emulador o un teléfono falseado reciben aquí la página segura, con un motivo bc_. El campo Browser check* del flujo puede desactivarlo solo para ese flujo.
Preloader. Mientras el paso de JS corre (una fracción de segundo) el visitante ve una página de carga, configurada por flujo bajo JS Challenge Preloader: la página integrada, o tu propio HTML con vista previa en vivo. Históricamente este paso reutilizaba el HTML de la página segura — ese marcado se sigue mostrando cuando no hay preloader configurado, así que las campañas existentes conservan su aspecto; elige Custom HTML para sobreescribirlo. La sonda de verificación se inyecta en tu HTML automáticamente — no añadas tus propios scripts de redirección, compiten con el enlace firmado.
Registro e informes
| Ajuste | Por defecto | Qué hace |
|---|---|---|
| Record Safe Page clicks | on | Las visitas a la página segura se escriben con is_safe_page = 1. Desactívalo y no llegarán a la base de datos |
| Exclude Safe Page clicks from reports | on | Las visitas se quedan en el registro de clics pero salen de cada métrica de los informes — clics, visitas, únicos, bots, referers vacíos, costo, CPV. Una visita safe sigue siendo una visita al enlace de la campaña, así que con la casilla apagada cuenta también en "Clicks" (desde 1.8.5 los clics cuentan cada visita) |
Incluso cuando las visitas no se escriben, el contador de visitas suprimidas (cloak_suppressed_stats) las cuenta por campaña, flujo, día y veredicto — los "cero clics" no esconderán el tráfico real.
Ajustes globales: Settings → Bots
- Bot IP addresses — IPs y CIDR, IPv4 e IPv6. Cada entrada tiene una fuente (manual o de un feed); la limpieza puede borrar entradas de una sola fuente.
- Signatures (User-Agent) — subcadenas.
- Global Bot ISP blacklist — un proveedor por línea. Las cadenas demasiado cortas y genéricas (
Inc,LLC) se ignoran: coincidirían con casi cualquier ISP. - Rangos de IP de data centers y crawlers — rangos publicados de AWS, Google Cloud y Googlebot, Bing, Azure, Oracle, DigitalOcean, Facebook, Telegram, OpenAI, Cloudflare, Apple Private Relay, y otros de lord-alfred/ipranges. Actualizados a diario por el cron
ipranges_cron.php(manualmente con el botón "Update now" ophp ipranges_cron.php --force), guardados envar/ipranges/. Hasta que las listas se descarguen, la capa está inactiva. - Browser check — Off / Observe only / Soft / Strict: bots, VMs y emuladores atrapados por contradicciones en el navegador. → Browser check
- Treat VPN ASN as a bot signal — activado por defecto. Desactívalo si tu audiencia está en gran medida detrás de una VPN comercial.
Diagnóstico
- La tarjeta del cloak en el editor — cuántas visitas fueron a money y a safe en el periodo seleccionado, los motivos principales y un enlace al registro de clics con la misma ventana. Si casi todo el tráfico va a la página segura, la tarjeta avisa.
- El registro de clics — las columnas "Route" y "Reason" aparecen automáticamente cuando hay clics de cloak en la página, con filtro por ruta y motivo. La tarjeta del clic muestra el veredicto y los motivos, pero solo para los clics que el cloak juzgó de verdad.
- El test link con
_dbg=1— una traza de enrutamiento sin registrar clic;_geo=XXsobrescribe el país (Campañas y flujos). - El log de PHP — líneas como
Orbitra cloak [campaign=12 stream=34]: stage=PASSIVE_SAFE ... reasons=[crawler_or_tool_ua].
Veredictos y motivos
Veredictos: money, passive_safe, targeting_safe, js_safe. Los motivos se escriben en clicks.cloak_reasons; los principales:
| Código | Significado |
|---|---|
geo_country / geo_unknown | país fuera de la lista / no se pudo determinar el país |
device_type | tipo de dispositivo no permitido |
bot_isp, isp_blocklist | ISP en la lista de bots y data centers |
datacenter_asn, asn_datacenter | ASN de data center o hosting |
vpn_proxy_asn | ASN de un proveedor de VPN o proxy |
iprange_datacenter | IP en un rango publicado de nube o crawler |
hosting_isp | palabra clave de hosting en el nombre del ISP |
ip2proxy_* | una señal de IP2Proxy: vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud |
bot_blocklist | IP en la lista de bots |
crawler_or_tool_ua, suspicious_ua, no_user_agent, missing_accept_language | heurísticas de User-Agent y cabeceras |
webdriver, js_missing, js_fingerprint | verificación de JavaScript |
Problemas comunes
| Síntoma | Qué revisar |
|---|---|
| El panel de anuncios muestra clics y el tracker muestra cero | Si el registro de clics de Safe Page está desactivado; el contador de visitas suprimidas |
| El 100% del tráfico en la página segura | Si la base de datos geo está instalada (⚙ → Geo databases); motivos geo_unknown en el registro de clics |
| Usuarios móviles reales en la página segura | Motivo ip2proxy_vpn_proxy — quita la capa VPN/proxy (es una señal dura; la sensibilidad baja no la cancela) |
| Los revisores de Meta o Telegram llegan a la oferta | Sus redes no están marcadas como data centers por ASN; una sola coincidencia de rango a sensibilidad media es solo una señal suave. Sube la sensibilidad o añade un filtro "Bot" a un flujo intercepting |
Inicio rápido: tu primera campaña
El camino corto: instala el tracker, crea la red, la oferta y la campaña, y consigue tus primeros clics y conversiones en menos de una hora.
Leer la guía →DocsInstalación y actualizaciones
Instala Orbitra en un servidor Ubuntu o Debian recién creado con un solo comando, actualiza PHP y las versiones nuevas de forma segura.
Leer la guía →DocsMigrar desde Keitaro
Mueve campañas, ofertas, fuentes y dominios de Keitaro a Orbitra con un dump SQL — qué se transfiere y qué revisar después.
Leer la guía →DocsMigrar desde Binom
Mueve campañas y flujos de Binom v2 a Orbitra vía su Public API — qué se transfiere automáticamente y qué se ajusta a mano.
Leer la guía →DocsResumen de funciones
Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.
Leer la guía →DocsCampañas y flujos
La referencia completa: ajustes de campaña, tipos de flujo, esquemas, rotación, filtros, test links y cada opción explicada.
Leer la guía →DocsCloaking: referencia completa
Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.
Leer la guía →DocsBrowser check
Cómo el check JS atrapa bots, VMs y emuladores por contradicciones del navegador: modos Off / Observe / Soft / Strict y sus signos.
Leer la guía →DocsLanding pages (referencia)
Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.
Leer la guía →DocsPWA y Web Push
Crea apps PWA instalables y tu propia base de suscriptores push: constructor, claves VAPID, mensajes, atribución y solución de problemas.
Leer la guía →DocsEmbudo de PWA
Cómo funciona el embudo configurable de una PWA: pasos y tipos de pantalla, tracking por pantalla, estadísticas del embudo y vista previa en el editor.
Leer la guía →DocsPopups de conversión
Muestra conversiones reales como popups en tus landings: activación por campaña, plantillas por vertical, disparadores y ubicación.
Leer la guía →DocsGrabaciones de sesión y mapas de calor
Reproduce visitas reales y consulta el mapa de calor de clics y de scroll. Límites de almacenamiento y notas de privacidad.
Leer la guía →DocsContent Gallery (referencia)
Almacenamiento central de iconos, capturas y creativos usados en PWAs y landings: carpetas, límites y el MediaPicker en los editores.
Leer la guía →DocsBiblioteca de creativos
Almacena creativos con tracking de subid y pruébalos en distintas campañas: métricas por creativo sincronizadas con Facebook y TikTok.
Leer la guía →DocsPWA externas y canales de Telegram
Publica PWAs en dominios externos y usa canales de Telegram como fuente de tráfico con suscriptores atribuidos.
Leer la guía →DocsPostbacks y conversiones
Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.
Leer la guía →DocsCostos
Importa el gasto de Facebook, TikTok y Google Ads, o actualízalo por API y cron — y cómo funciona el agregador de ingresos.
Leer la guía →DocsRedes push y pop
Trabajo con fuentes de tráfico push y pop: importación de gasto por campaña y zona, optimización de zonas y el Zone Killer.
Leer la guía →DocsFacebook / Meta
Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.
Leer la guía →DocsDolphin / Fbtool
Recibe los costos de Facebook vía la API de Dolphin (Fbtool) en tiempo real: clave de API, configuración de cada servicio y cómo se reparte el gasto entre los clics.
Leer la guía →DocsFB Comment Cleaner
Modera en bloque los comentarios bajo tus anuncios de Meta: ocultar, borrar y filtrar por palabras clave, con dry run, journal y auto-pausa.
Leer la guía →DocsFuentes de tráfico y redes de afiliados
Los dos directorios que configuran los bordes del embudo: plantillas y parámetros de fuentes y redes, postback global, macros de oferta y LeadForge.
Leer la guía →DocsInformes, logs y métricas
El constructor de informes, tendencias y cohortes, el log de tráfico y la tarjeta del clic, más la definición de cada métrica.
Leer la guía →DocsDominios y SSL
Añade dominios, apunta el DNS y emite certificados Let's Encrypt gratis: ajustes del dominio, modos SSL, registrars conectados y Backorder.
Leer la guía →DocsCloudflare
Cómo pasar los dominios de campaña por Cloudflare vía API: token, parking automático del registro A, modos SSL de zona y proxy.
Leer la guía →DocsAdministración
Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.
Leer la guía →DocsBot de Telegram
Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.
Leer la guía →DocsMCP: un asistente de IA en el tracker
Conecta Claude o cualquier cliente MCP a Orbitra y maneja campañas con comandos en lenguaje natural: claves de API, conexión y seguridad.
Leer la guía →