Docs

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ñaQué hay
GeneralNombre, 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
FinanceModelo de costo, unicidad, tipo de rotación de flujos
ParametersQué 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
IntegrationsPíxeles (Facebook / TikTok etc., ver Facebook / Meta) y conectar la sincronización de costos (Costos)
TrackingGenerador 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
PopupEl 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 PostbacksPostbacks salientes hacia la fuente de tráfico, un tester de postbacks, reenvío de conversiones perdidas — ver Postbacks y conversiones
NotesTexto 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

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.

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

  1. Intercepting — se comprueba primero. Adecuado para bots, páginas blancas, excepciones.
  2. Regular — el tráfico principal. Se selecciona por posición o por peso (el tipo de rotación de la pestaña "Finance").
  3. 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

FiltroCómo funciona
CountryUna 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
DeviceDesktop / mobile / tablets
Operating system, BrowserLos 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 languageen — cualquier inglés, en-IN — solo inglés (India). Se considera todo el Accept-Language, no solo el primer idioma
BotEl detector de bots a sensibilidad máxima (el mismo que se usa en el cloaking)
IP addressDirecciones y CIDR, IPv4 e IPv6
Provider (ISP)Se compara con el ISP y el ASN del visitante (requiere la base de datos ASN)
Connection typeA partir de los datos de la base de datos geo
Referer, KeywordSe compara con el valor del clic
URL parameterCualquier 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, TimeSegú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

EsquemaQué pasa
Direct redirect to offerUna 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 + OfferMuestra una landing desde la que el visitante sigue hacia la oferta. La oferta es opcional
ActionNo hacer nada, 404, mostrar texto, mostrar HTML, enviar a otra campaña (el clic se escribe en ambas)
CloakingDivide el tráfico entre una página segura y una money page — ver Cloaking

Offer selection en el esquema "Landing + Offer":

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.

TipoComportamiento
HTTP redirect302, el valor por defecto
JS redirectUna página HTML que navega vía JavaScript
Meta RefreshUna etiqueta <meta http-equiv="refresh">
IframeLa oferta en un iframe de página completa en tu dominio
Form SubmitUn formulario POST que se envía solo: los datos de tracking en el cuerpo de la petición
curl proxyLa 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

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.

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.

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

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.

← Anterior
Resumen de funciones
Siguiente →
Cloaking: referencia completa
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 →