Landing pages (referencia)
Una landing es la página que el visitante ve de camino a la oferta. Orbitra sirve cuatro tipos, y las diferencias importan sobre todo para una pregunta: cómo llega el botón de compra a la oferta.
| Tipo | Dónde vive | Enlace de oferta |
|---|---|---|
| Local | ZIP subido, servida por el tracker | {offer} o /?_lp=1 |
| Redirect | tu propio hosting, otro dominio | /?_lp=1 + el adaptador JS |
| Preload | traída por el tracker, mostrada bajo tu dominio | {offer} |
| Action | no se muestra nada; el tracker hace algo | — |
Landings locales
El archivo se descomprime en landings/<landing id>/. El punto de entrada es index.html, o index.php si las landings PHP están habilitadas.
Requisitos
- La página de entrada debe llamarse
index.html(oindex.php). - Usa rutas relativas:
img/hero.jpg, no/img/hero.jpg. Ambas funcionan, pero las rutas relativas también funcionan cuando abres el archivo localmente. - Sin redirección interna a
index.html— el visitante saldría de la URL trackeada.
A diferencia de Keitaro, Orbitra no añade una etiqueta <base> y no reescribe tu marcado. La página se sirve byte a byte tal como la subiste, y sus archivos se resuelven contra la landing que se mostró. Dos consecuencias que vale conocer:
- Una etiqueta
<base>propia se deja intacta. - Los enlaces de ancla (
href="#form"), los scripts de popup y el smooth scrolling siguen funcionando. En Keitaro estos se rompen, porque reescribe cadahref.
Enlazar a la oferta
La forma más simple, y la que conviene usar:
<a href="{offer}">Buy</a>
{offer} se reemplaza por la transición firmada landing→oferta (desde 1.6.14, igual que Keitaro): el clic pasa por el tracker, así que el embudo se cuenta y las macros de la oferta se sustituyen en el redirect. Antes de 1.6.14 incrustaba la URL directa del anunciante, que se saltaba el tracker — los flujos con "offer selection: before" mostraban cero clics.
Con varias ofertas en una página, cualquiera de las dos formas funciona — la explícita en todas las versiones:
<a href="/?_lp=1&offer_id=10">Offer 10</a>
<a href="{offer}&offer_id=22">Offer 22</a>
Añadir &offer_id= a {offer} cambia la oferta (desde 1.6.14): {offer} se expande al enlace de transición firmado, así que el tracker lee el parámetro y re-atribuye el clic — una conversión aterriza en la oferta que nombraste. Antes de 1.6.14 {offer} se expandía a la URL directa del anunciante y el parámetro simplemente se le pasaba; la forma explícita /?_lp=1&offer_id=N funciona en todas las versiones.
Pasar una elección hecha en la landing (un producto, un plan o una respuesta de quiz) funciona a la manera de Keitaro: añade sub_id_1 … sub_id_30 al enlace de transición y actualizan el clic.
<a href="/?_lp=1&sub_id_5=Blue%20Watch&sub_id_6=https%3A%2F%2Fcdn.example%2Fblue.jpg">Buy the blue one</a>
La URL de la oferta los recoge luego como {sub_id_5} / {sub_id_6}, p. ej. https://network.example/?sub1={clickid}&product={sub_id_5}&image={sub_id_6}. Los valores también se escriben en el clic, así que informes y postbacks ven lo mismo. Solo se aceptan claves sub_id_N, los valores vacíos nunca borran lo que envió la fuente de tráfico, y cada valor se limita a 512 bytes. En una landing alojada en otro sitio, añádelos al enlace firmado: {lp_url}&sub_id_5=….
Desde 1.6.14 {offer}&sub_id_5=… también funciona — la macro es el propio enlace de transición, así que el tracker lee lo que le añadas. Si el valor se conoce antes del clic (un producto por campaña), sáltate el paso de la landing por completo y pon ?sub_id_5=… en el enlace de campaña.
Tiempo en la landing
Nada que añadir a la página: cada landing que sirve el tracker recibe un pequeño temporizador inyectado antes de </body>. Reporta cuánto tiempo se quedó el visitante — haya o no pulsado alguna vez el botón de oferta, que es la diferencia entre esto y Time to offer: una página que nadie clickea no reporta nada bajo la métrica vieja, y esa es precisamente la página que vale la pena encontrar.
Qué mide, y qué deliberadamente no:
- solo el tiempo visible — una pestaña dejada en segundo plano no acumula;
- el scroll más profundo alcanzado, 0-100 %, junto a los segundos;
- checkpoints a los 5, 15, 30 y 60 segundos y cada minuto después, más un volcado final cuando la página se oculta o se descarga, así que una pestaña cerrada igual deja un número.
Dónde aparece: la columna Time on LP en Logs (los valores bajo 5 segundos se resaltan) y en los detalles del clic, y en los informes como las métricas Time on LP, LP bounce rate, LP scroll depth y LP measured visits más la dimensión Time on LP (bucket). Una visita que nunca reportó — una landing de redirect en el dominio de otra persona sin el script de tracking, un bot que no ejecuta JS — se agrupa como Unknown en lugar de contarse como una visita de cero segundos.
Para una landing alojada en otro sitio, el mismo temporizador va dentro de tracking.js / kclient.js; una página PHP hace echo de $client->timerScript() (ver Tracking Client (PHP)).
Grabación de sesión y heatmap
La pestaña Session recording del editor de la landing activa las grabaciones estilo Clarity para esta landing: una proporción de visitantes (5–100 %), cuánto tiempo grabar, y los límites de almacenamiento compartidos. Las grabaciones se reproducen en ⚙ → Logs → Session recordings; la misma pestaña abre el heatmap de clics y el mapa de scroll de la landing. Las landings locales y de "Show HTML" no necesitan nada extra; las páginas externas graban a través de tracking.js / kclient.js / kclient.php. Los campos de formulario se enmascaran en el navegador del visitante. → Grabaciones de sesión y heatmaps de clics
Macros
Se sustituyen en el HTML de una landing local:
| Macro | Valor |
|---|---|
{offer} | transición firmada landing→oferta (/index.php?_lp=1&_token=…, desde 1.6.14 — el clic pasa por el tracker, así que el embudo cuenta y los parámetros añadidos &offer_id= / &sub_id_N le llegan; mismo valor que {lp_url}) |
{lp_url} | la misma transición firmada, escrita para landings externas |
{offer_id} | el id de la oferta vinculada |
{clickid}, {subid} | el id del clic |
{token} | token firmado, usado por el adaptador JS |
{keyword}, {sub_id_1} … {sub_id_30} | parámetros del clic capturados de la fuente de tráfico |
Los valores tomados de la URL se escapan como HTML. Nada más se toca — {unknown}, los template literals de JS, la sintaxis de Vue y Angular sobreviven todos.
Sin oferta en el flujo, {offer} se vuelve un enlace de transición sin firmar, que explica la mala configuración al hacer clic en lugar de recargar la página en silencio.
Landings de redirect (externas)
La landing está en tu propio hosting. El tracker envía al visitante allí y añade dos parámetros:
https://your-landing.example/promo?_subid=<click id>&_token=<signed token>
El token es lo que hace que el enlace de oferta funcione en absoluto. Una landing en otro dominio no puede leer las cookies del tracker, así que sin él el tracker no tiene forma de saber qué clic está volviendo. Va firmado con HMAC-SHA256 y expira tras 24 horas; un _subid pelado de la URL no se acepta por sí solo, porque permitiría a cualquiera atribuir una visita al click id que le dé la gana. Una landing local o preload recupera el clic de su cookie en cambio, así que no necesita el token.
Un {offer} dentro de la propia URL de la landing se vuelve la misma transición, absoluta (http://your-tracker/index.php?_lp=1&_token=…), así que una landing que toma su CTA de un parámetro de query también obtiene un enlace funcional. Ambos comportamientos necesitan v1.6.14; antes de ella el par nunca llegaba de verdad y {offer} incrustaba la URL directa del anunciante.
Instala el adaptador JS y enlaza la oferta así:
<a href="/?_lp=1">Buy</a>
El adaptador reescribe eso en un enlace absoluto al tracker y añade _subid y _token.
Landings preload
El tracker trae tu página del lado del servidor, inyecta <base href> para que sus imágenes y estilos sigan cargando del host original, aplica las macros y sirve el resultado bajo tu dominio — sin redirect. Usa {offer} para el enlace de oferta.
Landings de acción
No se muestra nada. Elige qué pasa:
| Acción | Resultado |
|---|---|
| Send to campaign | entrega al visitante a otra campaña; el clic cuenta en ambas |
| Show a 404 error | página en blanco, estado 404 |
| Show as text | el texto que escribas, como text/plain |
| Show as HTML | el HTML que escribas |
| Do nothing | respuesta vacía; el visitante se queda donde está |
{offer}, {clickid} y los parámetros del clic se sustituyen en las variantes de texto y HTML.
Keitaro pasa al visitante a otra campaña sin un redirect. Orbitra usa un redirect: reentrar al tracker en la misma petición significaría incluir su script de entrada dos veces, lo cual PHP no puede hacer. El clic se registra en ambas campañas de cualquier forma — el visitante solo hace un salto extra.
Adaptador JS
<script src="https://your-tracker/js/orbitra-adapter.js"
data-postback="https://your-tracker/POSTBACK_KEY/postback"></script>
Pégalo en el <head> de cada página. El panel muestra el snippet con tu propia clave rellenada, bajo los ajustes de la landing.
Requerido para una landing de redirect. Opcional pero útil para una local con varias páginas: lleva el clic a las páginas internas y los formularios, así que la página dos sigue sabiendo quién es el visitante.
Deliberadamente deja intacto lo que el adaptador de Keitaro reescribe: los enlaces #anchors, mailto:, tel: y javascript: no se tocan, y los enlaces a dominios de terceros nunca reciben tu click id.
Reportar una conversión desde la página
<a href="{offer}" onclick="orbitraPostback(this, event, 'lead', 10)">Buy</a>
Argumentos: el elemento, el evento, un estado de conversión, un payout opcional y un id de transacción opcional. La navegación prosigue incluso si el postback falla — perder la venta por un tropiezo de reporte sería el peor trato.
Para un manejador de formulario, PHP es más simple:
file_get_contents('https://your-tracker/POSTBACK_KEY/postback?subid=' . urlencode($_COOKIE['subid']) . '&status=lead');
Landings PHP
Desactivadas por defecto. Actívalas en Settings → General → Allow PHP landings, y solo para landings cuyo código confíes: una landing PHP corre dentro del tracker, en la raíz web.
Requisitos
- La página de entrada es
index.php. - Estas llamadas se rechazan al subir:
exec,system,shell_exec,passthru,proc_open,popen,pcntl_exec,pcntl_fork,dl,eval,assert,create_function,symlink,link,set_time_limit,ini_set,ini_alter. - Incluye otros archivos por ruta absoluta:
require_once dirname(__FILE__) . '/src/lib.php'; // right
require_once 'src/lib.php'; // wrong
- Mantén la ejecución bajo el timeout (3 segundos por defecto, 9 máximo). Pon timeouts en cada llamada curl:
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
curl_setopt($ch, CURLOPT_TIMEOUT, 3);
Leer el clic
<?php
$clickId = $rawClick->get('click_id');
$keyword = $rawClick->get('keyword');
$offer = $rawClick->get('offer'); // the offer URL, same as {offer}
$rawClick es de solo lectura. Para registrar una conversión, envía un postback.
El escaneo no es una sandbox. Lee el código subido con el tokenizer propio de PHP, así que ve llamadas reales y no palabras en comentarios — pero
$f = 'sys' . 'tem'; $f();lo burla, igual que burla la comprobación equivalente en cualquier otro tracker. Lo que de verdad contiene el riesgo es que la función está desactivada por defecto, que solo un admin puede activarla, y quedisable_functionsyopen_basediren tuphp.iniaplican a una landing exactamente igual que a todo lo demás. Configúralos.
LeadForge 2.0 (analizador de landings, validación JS y puente multi-red)
LeadForge 2.0 es el motor integrado de Orbitra para analizar, limpiar y reasentar paquetes de landing pages en redes de afiliados objetivo.
Modos de integración
- Auto Mode: detecta automáticamente la red de origen por firmas de código y mapea los envíos de formularios a la red objetivo.
- Cross-Network Mode: elimina los manejadores de pedidos legacy de la red (
send.php,order.php,api.php), limpia píxeles/scripts de tracking ajenos e instala el puente universal multi-red. - Raw Mode (Clone Patch): quita contadores y scripts ajenos, inyecta el puente ClickID/SubID y las macros
{offer}sin generar manejadores de backend.
Validación telefónica 150-GEO y adaptador de cliente (orbitra_adapter.js)
Al activarlo, LeadForge inyecta orbitra_adapter.js, que proporciona:
- 150 Country Rules: patrones regex exactos nacionales e internacionales, comprobaciones de prefijos de operadores móviles y restricciones de longitud mín/máx.
- Dynamic Country Switching: actualiza automáticamente las reglas de validación, los topes de longitud y los contadores auxiliares cuando el usuario cambia
<select name="country">. - Badges interactivos en vivo: contador en tiempo real con los dígitos introducidos y restantes (p. ej. «3 cifre inserite, 7 mancanti» → «Numero complete»).
- Validación estricta de nombres Unicode: filtrado en tiempo real que impide dígitos y símbolos de spam en los nombres de los clientes.
- Feedback háptico de vibración: vibra los dispositivos móviles ante intentos con formato de teléfono inválido.
- ClickID / SubID Bridge: captura todos los parámetros de tracking entrantes (
subid,click_id,sub1..sub5,utm_*,fbp,fbc, etc.) e hidrata los campos del formulario a lo largo de embudos multipágina.
Puente universal de pedidos CPA (order.php)
Genera un manejador de pedidos autónomo y autocontenido compatible con 10 redes CPA:
- Dr.Cash, Webvork (con fallback SuperClient), Lucky.online, KMA.biz, TerraLeads (con verificación de checksum SHA1), Leadbit, LemonAD, Everad, Ezaff y Custom Webhooks.
- Normalización E.164 automática: estandariza los números de teléfono locales al formato internacional con reconciliación de prefijo de país.
- Registro dual en CRM: despacha el lead a la red de afiliados y a la vez guarda una snapshot completa del lead crudo en el Orbitra CRM Vault (
orbitraCrmRecordLead//crm-ingest). - Registro local a prueba de fallos: añade los leads a
leadforge.leads.logyorbitra_leads_backup.log.
Solución de problemas
Las imágenes y el video no cargan. Usa rutas relativas. Si son correctas y la página sigue saliendo pelada, comprueba que estás abriendo la URL de campaña y no landings/<id>/index.html directamente.
El botón de compra no lleva a ningún lado. La landing probablemente sigue apuntando directo al anunciante — una landing copiada del embudo de otra persona conserva su enlace de afiliado. Reemplaza esos href con {offer}.
Landing transition failed: original click not found. Una landing en otro dominio sin el adaptador JS, o un visitante con cookies deshabilitadas y sin _token en la URL.
no offer attached to this stream. El flujo tiene una landing pero no una oferta. Añade una, o deja la landing como página final y prescinde del enlace de oferta.
Una landing PHP muestra "disabled on this tracker". La función está apagada; ver arriba.
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 →