Docs

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.

TipoDónde viveEnlace de oferta
LocalZIP subido, servida por el tracker{offer} o /?_lp=1
Redirecttu propio hosting, otro dominio/?_lp=1 + el adaptador JS
Preloadtraída por el tracker, mostrada bajo tu dominio{offer}
Actionno 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

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:

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:

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:

MacroValor
{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ónResultado
Send to campaignentrega al visitante a otra campaña; el clic cuenta en ambas
Show a 404 errorpágina en blanco, estado 404
Show as textel texto que escribas, como text/plain
Show as HTMLel HTML que escribas
Do nothingrespuesta 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

  1. La página de entrada es index.php.
  2. 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.
  3. Incluye otros archivos por ruta absoluta:
   require_once dirname(__FILE__) . '/src/lib.php';   // right
   require_once 'src/lib.php';                        // wrong
  1. 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 que disable_functions y open_basedir en tu php.ini aplican 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

Validación telefónica 150-GEO y adaptador de cliente (orbitra_adapter.js)

Al activarlo, LeadForge inyecta orbitra_adapter.js, que proporciona:

Puente universal de pedidos CPA (order.php)

Genera un manejador de pedidos autónomo y autocontenido compatible con 10 redes CPA:


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.

← Anterior
Browser check
Siguiente →
PWA y Web Push
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 →