Campañas y flujos
Una campaña es la URL por la que llega el tráfico más un conjunto de flujos que deciden a dónde va cada visitante. La sección Campaigns está en el menú superior.
El editor de campaña
El editor abre a pantalla completa. En una pantalla ancha (1280px o más) se divide en dos paneles: ajustes de campaña a la izquierda, flujos a la derecha; en una pantalla más estrecha se vuelve una sola columna.
Pestañas de ajustes
| Pestaña | Qué hay |
|---|---|
| General | Nombre, alias (6 caracteres, generado automáticamente), URL de campaña, dominio, grupo, fuente de tráfico, estado, test link; más abajo en la pestaña — la tarjeta de social link preview y la regla de Zone Killer |
| Finance | Modelo de costo, unicidad, tipo de rotación de flujos |
| Parameters | Qué parámetros del enlace guarda el tracker en el clic (keyword, cost, external_id, creative_id, ad_campaign_id, source, sub_id_1 … sub_id_30) y de qué parámetros de la fuente tomarlos |
| Integrations | Píxeles (Facebook / TikTok etc., ver Facebook / Meta) y conectar la sincronización de costos (Costos) |
| Tracking | Generador de código de integración: el script de tracking, kclient.js, kclient.php, el píxel, banners (script / iframe), el plugin de WordPress, widgets (un temporizador de cuenta regresiva, el "botón de atrás", exit-intent). Disponible tras el primer guardado — el código contiene el token de la campaña |
| Popup | El popup de conversión propio de la campaña: on/off (un punto en la pestaña mientras está activo), una vista previa en vivo, cuatro pasos y una sección Advanced |
| S2S Postbacks | Postbacks salientes hacia la fuente de tráfico, un tester de postbacks, reenvío de conversiones perdidas — ver Postbacks y conversiones |
| Notes | Texto libre |
Modelos de costo
CPC, CPV, CPuC (por clic único), CPM, CPA, CPS, RevShare. El costo manual se sobrescribe con la importación de costos si está conectada (Costos).
Unicidad
- Método: IP, IP + User-Agent, o Cookies.
- Periodo: en horas.
- La unicidad se calcula en tres ámbitos — por campaña, por flujo y global; los tres son visibles en los informes.
Estado de la campaña
Una campaña detenida (paused / disabled) responde con 503, una archivada con 404. Esto aplica a la URL del alias, a click.php y a la Click API.
Social link preview
Una tarjeta en la pestaña General del editor. Al activarlo, un bot de vista previa de redes sociales o mensajería que abra la URL de campaña — facebookexternalhit, telegrambot, whatsapp, twitterbot y los demás fetchers de vista previa de enlaces — recibe una tarjeta mínima og:* con tu título, descripción e imagen en lugar del flujo de clics. Cada humano se enruta exactamente como siempre: sin retraso, sin página distinta.
Los crawlers de buscadores (googlebot & co) a propósito siguen viendo la respuesta real de la campaña — esto es solo para los fetchers de vista previa de mensajería; el manejo completo de bots es tarea del cloaking. El aviso de una sola vez deja constancia de que las reglas de la plataforma sobre vistas previas personalizadas son responsabilidad del operador.
Flujos
Un flujo es una regla de enrutamiento: filtros (a quién aplica) + un esquema (qué mostrar).
Tipos y orden
- Intercepting — se comprueba primero. Adecuado para bots, páginas blancas, excepciones.
- Regular — el tráfico principal. Se selecciona por posición o por peso (el tipo de rotación de la pestaña "Finance").
- Default — cuando nada de lo anterior coincidió.
Guardar una campaña no recrea sus flujos: cada flujo conserva un ID estable, así que el historial de clics no se dispersa entre números viejos. Los flujos nuevos se llaman "Stream 1", "Stream 2" … El chevron de una tarjeta colapsa el flujo; el estado se recuerda por campaña.
Cada tarjeta de flujo muestra visitas, únicos, bots y la proporción del tráfico de campaña de hoy / ayer / 7 / 30 días. Así es fácil ver cuánto tráfico fue al flujo blanco y cuánto al flujo de dinero.
Filtros
| Filtro | Cómo funciona |
|---|---|
| Country | Una lista de países o un perfil geo (UE, CIS…). Si el país no se puede determinar y el modo "include" está activo, el filtro no deja pasar al visitante — pero solo cuando hay una base de datos geo instalada; sin ella el filtro se abstiene |
| Device | Desktop / mobile / tablets |
| Operating system, Browser | Los valores se eligen de la lista que el tracker realmente reconoce, incluidos los navegadores in-app (TikTok, Facebook, Instagram, Telegram, WebView). Puedes escribir tu propio valor y pulsar Enter |
| Browser language | en — cualquier inglés, en-IN — solo inglés (India). Se considera todo el Accept-Language, no solo el primer idioma |
| Bot | El detector de bots a sensibilidad máxima (el mismo que se usa en el cloaking) |
| IP address | Direcciones y CIDR, IPv4 e IPv6 |
| Provider (ISP) | Se compara con el ISP y el ASN del visitante (requiere la base de datos ASN) |
| Connection type | A partir de los datos de la base de datos geo |
| Referer, Keyword | Se compara con el valor del clic |
| URL parameter | Cualquier parámetro del enlace por nombre. Coincidencia exacta sin distinción de mayúsculas, * — cualquier caracteres, "Empty" — el parámetro falta o está vacío |
| Day of week, Time | Según la hora local del visitante (zona horaria de la base de datos geo; sin ella, hora del servidor) |
Los filtros de un flujo se combinan con AND (todos deben coincidir) o OR (con uno basta). Un filtro que no puede llegar a una decisión (sin base de datos geo, sin datos de ISP) no vota: con "AND" no bloquea el flujo, con "OR" no lo abre.
Un truco contra la moderación de TikTok vía "URL parameter": añade xxx=__PLACEMENT__ a la URL de campaña; en un flujo intercepting con una página blanca, pon un filtro "URL parameter" sobre xxx con los valores __PLACEMENT__ y "Empty". En un clic real la red sustituye el valor de la macro, mientras que un moderador que abre el enlace pelado llega con __PLACEMENT__ o sin el parámetro.
Esquemas
| Esquema | Qué pasa |
|---|---|
| Direct redirect to offer | Una redirección a una oferta del catálogo (varias ofertas rotadas por peso) o a una URL directa. Cada transición así es un clic |
| Landing + Offer | Muestra una landing desde la que el visitante sigue hacia la oferta. La oferta es opcional |
| Action | No hacer nada, 404, mostrar texto, mostrar HTML, enviar a otra campaña (el clic se escribe en ambas) |
| Cloaking | Divide el tráfico entre una página segura y una money page — ver Cloaking |
Offer selection en el esquema "Landing + Offer":
- After the click (el valor por defecto en flujos nuevos) — la oferta se elige cuando el visitante realmente deja la landing. LP clicks, LP CTR y tiempo hasta la oferta son honestos.
- Before the click — cada vista de la landing cuenta como un clic a la oferta (comportamiento legacy, LP CTR cercano al 100%).
Cómo construir el enlace de oferta en la propia landing ({offer}, /?_lp=1, pasar sub_id_N a la oferta) se cubre en Landing pages.
Tipos de redirect de oferta
Se configuran en la oferta. Las macros y la comprobación SSRF son iguales para todos los tipos.
| Tipo | Comportamiento |
|---|---|
| HTTP redirect | 302, el valor por defecto |
| JS redirect | Una página HTML que navega vía JavaScript |
| Meta Refresh | Una etiqueta <meta http-equiv="refresh"> |
| Iframe | La oferta en un iframe de página completa en tu dominio |
| Form Submit | Un formulario POST que se envía solo: los datos de tracking en el cuerpo de la petición |
| curl proxy | La página de la oferta servida a través de tu servidor con una etiqueta <base> |
Rotación con auto-optimización
El interruptor Auto junto a la lista de ofertas o landings de un flujo activa el recálculo automático de pesos por una métrica: ventas confirmadas, CR, EPV, EPC o ROI (el ROI necesita costos). Configurable: la ventana en días, el número mínimo de ventas antes de participar en el reparto, los límites inferior y superior de la proporción, y el intervalo de recálculo. El recálculo lo hace el cron rotation_optimiser_cron.php; el registro de decisiones es visible en la tarjeta del flujo. Mientras "Auto" está activo, la entrada manual de pesos queda bloqueada.
Otros ajustes del flujo
- Collect clicks — al desactivarlo, el visitante sigue recibiendo una dirección, pero el clic no se escribe (no hay nada a qué adjuntar una conversión).
Bot Challenge es un ajuste de campaña, no de flujo: una comprobación de humanidad (reCAPTCHA v2/v3 o tu propio código) antes de elegir un flujo.
Test link
La fila Test link de la pestaña "General" produce una URL de campaña firmada con ?_t=<id>:<hmac>. Por ella funciona el enrutamiento real — flujos, filtros, rotación, landings, ofertas — pero el clic no se registra, así que las estadísticas se mantienen limpias.
&_geo=DE— sobrescribe el país del visitante: prueba flujos geo sin VPN.&_dbg=1— en lugar de una redirección, una página de traza: cada flujo con su tipo, esquema y el voto de cada filtro (coincidió / no coincidió / se abstuvo y por qué), el flujo seleccionado y la URL final con las macros sustituidas.
La firma se deriva de la postback key de la instalación, así que sobrevive a un cambio de token de campaña; cambiar la postback key revoca todos los test links. Una firma inválida o ajena convierte la petición en un clic ordinario.
Simulación de tráfico
⚙ → Traffic simulation: define una IP, User-Agent, país, dispositivo, idioma y parámetros de URL — el panel mostrará qué flujo se disparó y por qué, sin registrar nada.
Click API y tokens de campaña
Cada campaña tiene un token (32 caracteres hexadecimales). Los scripts de integración (click.php, kclient.php, tracking.js, Click API v3 /click_api/v3) direccionan la campaña por token, no por ID. Los tokens se transfieren al importar desde Keitaro, así que los scripts ya instalados siguen funcionando. El token se puede reemitir en el editor. Para detalles sobre el cliente PHP, ver Tracking Client (PHP).
Protección contra duplicados
- Un clic repetido del mismo visitante (campaña + IP + User-Agent) dentro de 2 segundos no se escribe como una segunda fila; la redirección recibe el ID del clic ya registrado.
- Las peticiones de prefetch/prerender del navegador se atienden pero no se escriben.
- Si la base de datos está ocupada (
database is locked), el clic va avar/spool/clicks.log, y el croncli/click_spool_cron.phplo escribe en menos de un minuto.
Operaciones en lote
Copia de campañas, borrado masivo, importación, mover un grupo de campañas a otro dominio (bulk_set_campaign_domain, también en MCP), renombrar grupos directamente en la lista.
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 →