Docs

Administración

Todo lo que se abre desde el menú ⚙ en la esquina superior derecha del panel.

Usuarios y acceso

⚙ → Users. Dos pestañas: Users (la tabla de cuentas, visible para admins) y Profile (tu propia cuenta — para cada usuario).

Roles

Hay dos roles: admin (acceso total) y user (permisos por recurso). La cuenta creada en la instalación no se puede borrar, ni el último admin que queda. Los usuarios tienen plantillas de permisos: media buyer, editor de video / diseñador, desarrollador, o permisos personalizados.

Los permisos se otorgan por recurso: campaigns, offers, landings, sources, affiliate networks, domains, logs, gallery, push. Los niveles son full, read-only, no access. Para campañas también hay own + assigned y assigned only — entonces el usuario ve y edita solo esas campañas en todas partes: en listas, informes, logs, conversiones, en el dashboard. Los datos financieros se pueden ocultar aparte: costos, ingresos, payouts.

Los permisos se aplican en el servidor. Las acciones no asignadas a ningún recurso son solo de admin (la lista completa en REST API). Las operaciones globalmente peligrosas (borrar estadísticas, importación de Keitaro, importación de conversiones, reasignación retroactiva) no están disponibles para los usuarios con acceso "own + assigned".

Profile

Login, email, idioma de la interfaz, zona horaria (unas 250 zonas con el offset UTC actual), primer día de la semana, cambio de contraseña (requiere la contraseña actual; mínimo 8 caracteres).

Autenticación de dos factores — TOTP vía una app de autenticación. Los códigos son de un solo uso.

API keys

Las crea un admin para un usuario: read — solo lectura, write — también gestión. La clave se pasa en la cabecera Authorization: Bearer <key> o X-Api-Key. Se usa en MCP, REST API, para recibir costos de Dolphin / Fbtool y en la extensión de Ads Manager.

Inicio de sesión

Límites de intentos fallidos: 5 por 5 minutos desde una IP, y 20 por 15 minutos por cuenta (se reinician tras un inicio de sesión exitoso). La vida de la sesión es session_lifetime (un día por defecto, de 5 minutos a 30 días; la variable de entorno ORBITRA_SESSION_LIFETIME tiene prioridad sobre el ajuste).

Settings

⚙ → Settings, pestañas:

PestañaQué hay
GeneralPostback key, moneda por defecto, IP manual del servidor, permiso de landings PHP (desactivado por defecto) y su timeout de 1–9 s
BotsModo de Browser check (Off / Observe only / Soft / Strict), IPs y firmas de bots, la lista global de Bot ISP, rangos de datacenter, ASN de VPN como señal de bot — ver Cloaking
Conversion typesEstados personalizados y qué significan, estados sin mapear — ver Postbacks
Custom metricsFórmulas personalizadas para los informes
AutomationCrons: cola de postbacks, backorder
SystemRecolección de estadísticas on/off, ignorar prefetch, comprobaciones de versión nueva, períodos de retención de logs y archivo, acceso al panel por IP/subredes, ruta del panel de admin
PrivacyProtección contra escaneos: qué responder cuando un enlace en funcionamiento recibe una visita directa sin parámetros de campaña — un 302 a tu URL, 404 o una página vacía

Ruta del panel

/admin.php es lo primero que comprueba cualquier escáner. En System → Admin panel path puedes reemplazarlo por el tuyo (/my-panel), tras lo cual /admin.php empieza a responder 404. Esto esconde el formulario de login pero no reemplaza la contraseña. Si olvidas la ruta:

php /var/www/orbitra/cli/admin_path.php          # print the current path
php /var/www/orbitra/cli/admin_path.php reset    # вернуть /admin.php

Acceso al panel por IP

Una lista de IPs y subredes (IPv4 e IPv6, una por línea). Vacía — el panel está disponible desde cualquier lugar. Llena — iniciar sesión en el panel y las llamadas autorizadas a api.php funcionan solo desde esas direcciones. Las cabeceras X-Forwarded-For el tracker solo las confía si vienen de Cloudflare y de proxies privados. Cuidado: te puedes dejar fuera tú mismo. Para quitar la restricción desde el servidor:

sudo -u www-data php -r '$db = new PDO("sqlite:/var/www/orbitra/orbitra_db.sqlite"); $db->exec("UPDATE settings SET value = \x27\x27 WHERE key = \x27admin_ip_access\x27");'

Períodos de retención

Los campos "Log retention period" y "Archive resource retention period" solo funcionan cuando el cron de limpieza corre. El instalador no lo configura — añádelo a mano:

0 3 * * * php /var/www/orbitra/cli/cleanup_cron.php >> /var/www/orbitra/var/logs/cleanup.log 2>&1

El borrado corre en lotes para que la base de datos no se bloquee.

Personalization

⚙ → Personalization — logo, nombre, tema claro u oscuro y paletas: Cobalt, Canary, Parchment, Indigo (en variantes clara y oscura), Terminal, Aurora. El tema se aplica antes del primer pintado, así que el tema oscuro es oscuro desde el primer cuadro.

El idioma de la interfaz está en el profile: English, Русский, Українська, Español, Deutsch, Français, 中文.

Bases de datos geo

⚙ → Geo Databases. Sin una base de datos geo, los filtros de país y el cloaking por país no funcionan (todos los visitantes son Unknown); sin una base de datos ASN — las capas de datacenter y de listas de ISP.

Base de datosClaveQué da
Sypex Geo Cityno hace faltaPaís, región, ciudad. La instala el instalador
MaxMind GeoLite2 City / ASNclave de licencia de MaxMindCiudad, ASN y proveedor
IP2Location DB11token de IP2LocationGeo, zona horaria
IP2Proxy PX12token de IP2LocationVPN, proxy, TOR, residencial, fraud score

Las bases se actualizan cada mes por el cron cli/geo_update.php (marcado con # orbitra-geo; MaxMind e IP2 — solo si las claves están guardadas). Una actualización del panel instala Sypex por sí misma cuando no hay ninguna base. Un banner en todas las pestañas avisa cuando no hay bases o solo está Sypex.

⚙ → Geo profiles — conjuntos de países listos para los filtros (EU, CIS, etc.) y personalizados.

Update

⚙ → Update — comprueba si hay una versión nueva en GitHub y actualiza con un botón (git pull como el usuario web). La comprobación se cachea una hora, 10 minutos en caso de error; se desactiva en System → Notify about new versions.

Tras una actualización el panel, por sí solo:

Los cambios que requieren root (reglas de sudo, helpers de SSL) no se pueden hacer con el botón — el panel muestra un banner con el comando cli/server_setup.sh (Instalación y actualizaciones).

Si exec está deshabilitado en el hosting, la página muestra los comandos para actualizar a mano vía Git.

Varios

Ítem del menúQué hace
ArchiveCampañas, ofertas, landings, fuentes y redes de afiliados borradas: restaurar o borrar para siempre
Clear statisticsBorrar los clics y las conversiones de un período o todos
MigrationsVersión del esquema de la base de datos, importación de Keitaro (Migrar desde Keitaro)
StatusDisco, CPU, RAM, tamaño de la base de datos
LogsTraffic, postbacks, S2S, system, audit (Informes, logs y métricas)
GalleryBiblioteca de medios para PWA, landings y ofertas (Content Gallery)
AI / MCPConectar un asistente de IA (MCP)
Support and feedbackContactos y el bloque de partners

Extensión de Ads Manager

Una extensión para Chrome y navegadores antidetect basados en Chromium muestra las métricas de Orbitra junto a las filas de campaña, grupo de anuncios y anuncio en el Facebook Ads Manager (refrescando cada 30 segundos), y al pulsar — un desglose de tres días: historia diaria, landings y ofertas, precisión de entrega de Pixel / CAPI.

  1. ⚙ → Integrations → Chrome & Antidetect Extension — descarga el archivo y descomprímelo.
  2. Carga la carpeta como una extensión desempaquetada (o un ZIP, donde esté soportado).
  3. En el popup de la extensión, pega la URL del tracker y la clave read resaltada que muestra Orbitra.

La extensión solo necesita una clave read. Las visitas a la página segura se excluyen igual que en los informes.

← Anterior
Cloudflare
Siguiente →
Bot de Telegram
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 →