Browser check
Atrapa bots, máquinas virtuales de moderadores, emuladores y anti-detect browsers por contradicciones que el navegador reporta sobre sí mismo. Ejemplos: una GPU de software en lugar de una tarjeta gráfica real, "iPhone" en el User-Agent mientras la plataforma es Linux, un "teléfono" sin pantalla táctil. Los teléfonos reales, incluidos los navegadores in-app de Facebook, Instagram y TikTok, no muestran tales contradicciones, así que la comprobación puede actuar sobre ellos sin cortar visitantes reales.
Se configura en un solo lugar para todo el tracker: ⚙ → Settings → Bots → Browser check.
Lo que no es
No es un ID de visitante y no cuenta visitantes únicos. Las huellas de los teléfonos reales colisionan: cada iPhone del mismo modelo y versión de iOS se ve prácticamente idéntico, y los navegadores in-app más todavía. Usar una huella para la unicidad fusionaría a personas distintas en una y subcontaría los únicos. Orbitra nunca hace eso: los únicos se cuentan exactamente como antes, por IP / IP+User-Agent. Una huella corta se guarda solo como diagnóstico en la tarjeta del clic.
Modos
| Modo | Qué hace | Riesgo de perder visitantes reales |
|---|---|---|
| Off | No se recoge nada; todo funciona como antes | — |
| Observe only | No bloquea nada. La tarjeta del clic muestra qué se veía sospechoso y qué navegador era | Ninguno |
| Soft (recomendado) | Actúa solo con pruebas duras (tabla de abajo) | Mínimo: los dispositivos reales no muestran estos signos |
| Strict | También actúa sobre signos indirectos | Sí: una persona real en una VPN, en roaming o con ajustes inusuales puede marcarse como bot |
Por defecto: una instalación nueva empieza en Soft. Una instalación existente que actualiza a esta versión empieza en Off y el panel muestra un banner de una sola vez: Turn on soft mode / Learn more / Not now. Una actualización nunca cambia tu enrutamiento por sí sola.
Qué significa "actuar"
- En un flujo de cloak con el JS check activado (flujo → ajustes del cloak → JavaScript check), las señales se recogen durante ese mismo paso de JS y se juzgan antes de servir la money page. Un navegador sobre el que el modo actúa recibe la página segura de inmediato. El motivo del cloak muestra cuál signo fue, por ejemplo
bc_software_gpu. - En todo lo demás (landings sin el JS check, páginas externas con
tracking.js/kclient.js/kclient.php), las señales se envían desde la landing después de cargar. El clic se marca como bot (is_bot), lo que limpia los informes y alimenta el filtro de flujo "bot". La visita en sí no se detiene: no hay un paso intermedio donde detenerla, y añadirlo ralentizaría a cada visitante real.
Así que si quieres que la comprobación envíe los navegadores sospechosos a la página segura, activa el JS check en el flujo de cloak. El modo Soft protege entonces ese flujo sin costo extra: el paso de JS ya existe, y la comprobación simplemente corre dentro de él.
Un flujo de cloak concreto puede eximirse: ajustes del cloak → Browser check → Off for this stream.
Los signos
Pruebas duras (Soft y Strict actúan sobre ellas):
| Signo | Por qué un dispositivo real nunca lo muestra |
|---|---|
| Automatización del navegador | navigator.webdriver es true, o el navegador es HeadlessChrome |
| Máquina virtual sin GPU | El renderer de WebGL es software: SwiftShader, llvmpipe, Microsoft Basic Render Driver, VirtualBox, VMware. Los teléfonos siempre tienen una GPU de hardware |
| User-Agent de teléfono en un escritorio | "iPhone" en el UA pero la plataforma no es iPhone; "Android" en el UA sobre una plataforma Windows/Mac. iOS siempre reporta iPhone |
| Teléfono sin pantalla táctil | Un UA de teléfono con maxTouchPoints = 0 y sin eventos táctiles |
| Client Hints: "not mobile" | Un UA de teléfono Android mientras userAgentData.mobile es false |
Signos indirectos (solo Strict actúa sobre ellos):
| Signo | Cuándo también lo muestra una persona real |
|---|---|
| Zona horaria de otro país | Usuarios de VPN, viajeros, roaming. Las zonas vecinas con el mismo offset no cuentan |
| Idioma del navegador ≠ cabecera | Configuraciones raras, algunas extensiones de privacidad |
| Android en x86 | Emuladores (BlueStacks, AVD) y algunos Chromebooks |
| Spoof de plataforma en escritorio | Una extensión cambiadora de UA |
| Ventana de tamaño cero | Builds headless viejas. Solo escritorio: los navegadores in-app de Android reportan 0 legítimamente |
Una señal ausente nunca cuenta en contra del visitante. Si WebGL está apagado (modo Lockdown del iPhone, ajustes de privacidad), el signo de GPU simplemente no aplica.
Dónde ver los resultados
- Tarjeta del clic → Browser check: el veredicto (Clean / Suspicious / Bot), cada signo con su detalle (por ejemplo la cadena exacta de la GPU), la plataforma, la zona horaria del navegador y dónde se comprobó (paso JS del cloak o landing).
- Motivos del cloak:
bc_software_gpu,bc_ua_platform,bc_mobile_no_touchy demás, con descripciones en lenguaje llano en el diagnóstico del cloak. - Settings → Bots → Browser check: visitas comprobadas en los últimos 7 días, cuántas fueron bots y sospechosas, y los signos más frecuentes.
Cómo empezar con seguridad
- Activa Observe only por un día o dos y mira las estadísticas y unas cuantas tarjetas de clic. Ves cuánto de tu tráfico se vería afectado, sin ningún riesgo.
- Cambia a Soft. Activa el JS check en los flujos de cloak donde quieras a esos visitantes en la página segura.
- Usa Strict solo en tráfico donde los usuarios de VPN y los viajeros no te importan.
Notas técnicas
- Recolección:
/bc.js(≈2 KB). En el paso JS del cloak va inline y sus señales viajan en la siguiente URL como_ocb. En landings se carga condefery hace un solo POST aPOST /pixel.gif?action=bc, firmado con un HMAC del clic. - Veredictos: tabla
click_browser_checks(una fila por clic comprobado, limpiada con la retención de estadísticas de clics). Migración 77. Un segundo reporte del mismo clic se ignora. - Modo: ajuste
browser_check_mode(off/observe/soft/strict). Exención de un flujo:"browser_check": "off"en los ajustes del flujo de cloak. - Código:
core/BrowserCheck.php,bc.js. Test:tests/browser_check_test.php.
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 →