Docs

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

CapaFuenteNo funciona sin
Data centers / hostingUna blocklist ASN (core/data/asn_blocklist.json), rangos publicados de nubes y crawlers, palabras clave de hosting en el nombre del ISPLa base de datos ASN (GeoLite2-ASN)
VPN / proxyIP2Proxy PX12 (VPN, TOR, residencial, threat, fraud score ≥ 80), una lista de VPN-ASNIP2Proxy PX12 / la base de datos ASN
Bot blacklistsIPs y firmas de User-Agent de Settings → Bots—
Heurísticas de User-AgentCrawlers 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).

NivelPágina segura cuando
Lowsolo una señal dura
Medium (por defecto)una señal dura, o dos suaves
Highcualquier 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):

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

AjustePor defectoQué hace
Record Safe Page clicksonLas 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 reportsonLas 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

Diagnóstico

Veredictos y motivos

Veredictos: money, passive_safe, targeting_safe, js_safe. Los motivos se escriben en clicks.cloak_reasons; los principales:

CódigoSignificado
geo_country / geo_unknownpaís fuera de la lista / no se pudo determinar el país
device_typetipo de dispositivo no permitido
bot_isp, isp_blocklistISP en la lista de bots y data centers
datacenter_asn, asn_datacenterASN de data center o hosting
vpn_proxy_asnASN de un proveedor de VPN o proxy
iprange_datacenterIP en un rango publicado de nube o crawler
hosting_isppalabra clave de hosting en el nombre del ISP
ip2proxy_*una señal de IP2Proxy: vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud
bot_blocklistIP en la lista de bots
crawler_or_tool_ua, suspicious_ua, no_user_agent, missing_accept_languageheurísticas de User-Agent y cabeceras
webdriver, js_missing, js_fingerprintverificación de JavaScript

Problemas comunes

SíntomaQué revisar
El panel de anuncios muestra clics y el tracker muestra ceroSi el registro de clics de Safe Page está desactivado; el contador de visitas suprimidas
El 100% del tráfico en la página seguraSi 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 seguraMotivo 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 ofertaSus 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
← Anterior
Campañas y flujos
Siguiente →
Browser check
Ver el código en GitHub: github.com/fenjo26/Orbitra.link/wiki
Todas las guías
Docs

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 →
Docs

Instalació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 →
Docs

Migrar 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 →
Docs

Migrar 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 →
Docs

Resumen de funciones

Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.

Leer la guía →
Docs

Campañ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 →
Docs

Cloaking: referencia completa

Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.

Leer la guía →
Docs

Browser 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 →
Docs

Landing pages (referencia)

Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.

Leer la guía →
Docs

PWA 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 →
Docs

Embudo 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 →
Docs

Popups 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 →
Docs

Grabaciones 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 →
Docs

Content 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 →
Docs

Biblioteca 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 →
Docs

PWA 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 →
Docs

Postbacks y conversiones

Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.

Leer la guía →
Docs

Costos

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 →
Docs

Redes 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 →
Docs

Facebook / Meta

Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.

Leer la guía →
Docs

Dolphin / 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 →
Docs

FB 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 →
Docs

Fuentes 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 →
Docs

Informes, 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 →
Docs

Dominios 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 →
Docs

Cloudflare

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 →
Docs

Administración

Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.

Leer la guía →
Docs

Bot de Telegram

Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.

Leer la guía →
Docs

MCP: 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 →