Migrar desde Keitaro
Orbitra transfiere los ajustes de Keitaro — redes de afiliados, ofertas, dominios, campañas con sus tokens de Click API, flujos con filtros, postbacks de campaña, landings y fuentes. Las estadísticas de clics no se transfieren: esto es un comienzo desde cero.
Qué se transfiere
| Keitaro | Orbitra | Qué se conserva |
|---|---|---|
| Affiliate networks | Affiliate networks | Postback URL, parámetros de oferta |
| Offers | Offers | URL, payout, geo |
| Domains | Domains | Parking, solo HTTPS |
| Groups | Campaign groups | Nombre |
| Campaigns | Campaigns | Alias, token de Click API, estado, fuente |
| Streams | Streams | Tipo, posición, peso, esquema, acción, filtros (incluidos sub_id_N y filtros de parámetro), modos "allow / deny", asociaciones con ofertas y landings |
| Campaign postbacks | S2S Postbacks | URL, método, estados |
| Landing pages | Landing pages | Nombres y URLs |
| Sources | Sources | Parámetros |
No se transfieren: clics y conversiones, usuarios, archivos de landings locales (solo los registros sobre ellas). Los filtros que no se pueden transferir se listan en el informe de importación.
Las plantillas de fuentes y redes de afiliados de Keitaro ya están integradas en Orbitra — no hace falta transferirlas (Fuentes de tráfico y redes de afiliados).
1. Dump en el servidor de Keitaro
Conéctate al servidor de Keitaro por SSH como root y ejecuta el comando completo. Toma las credenciales de la base de datos de /etc/keitaro/env/inventory.env, funciona tanto con un cliente MariaDB en el host como con MariaDB dentro de un contenedor Docker de Keitaro, vuelca solo las tablas de ajustes (sin logs de clics) y se niega a ejecutarse si no encuentra las tablas — así nunca vuelcas la base de datos entera por accidente.
bash <<'ORBITRA_DUMP'
set -eo pipefail
# Sourced before set -u: the env file is Keitaro's, not ours.
source /etc/keitaro/env/inventory.env
set -u
# Password goes through the environment, never through argv or a file left on disk.
export MYSQL_PWD="$MARIADB_KEITARO_PASSWORD"
DB="$MARIADB_KEITARO_DATABASE"
# MariaDB client on the host, or inside the Keitaro MariaDB container.
if CLI=$(command -v mariadb || command -v mysql) && DUMP=$(command -v mariadb-dump || command -v mysqldump); then
sql() { "$CLI" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
dump() { "$DUMP" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
else
CT=$(docker ps --format '{{.Names}}' 2>/dev/null | grep -i -m1 -E 'mariadb|mysql' || true)
if [ -z "$CT" ]; then
echo "ERROR: no MariaDB client on this server and no MariaDB container found" >&2
exit 1
fi
echo "Using MariaDB inside container: $CT"
sql() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb || command -v mysql) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
dump() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb-dump || command -v mysqldump) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
fi
# Settings tables only: campaigns, offers, domains, streams... - no click logs.
TABLES=$(sql -N "$DB" -e "
SELECT table_name FROM information_schema.tables
WHERE table_schema = DATABASE()
AND table_name IN (
'keitaro_affiliate_networks', 'keitaro_groups', 'keitaro_offers',
'keitaro_domains', 'keitaro_campaigns', 'keitaro_campaign_postbacks',
'keitaro_landings', 'keitaro_streams', 'keitaro_stream_filters',
'keitaro_stream_offer_associations', 'keitaro_stream_landing_associations',
'keitaro_traffic_sources', 'keitaro_ref_sources')
ORDER BY table_name" | tr '\n' ' ')
# Without a table list mysqldump would dump the WHOLE database, click logs included.
if [ -z "$(echo $TABLES)" ]; then
echo "ERROR: no Keitaro tables found in database $DB" >&2
exit 1
fi
OUT=/root/keitaro_orbitra_full.sql.gz
echo "Dumping tables: $TABLES"
dump --single-transaction --quick --skip-lock-tables "$DB" $TABLES | gzip -1 > "$OUT"
ls -lah "$OUT"
echo "DONE: $OUT"
ORBITRA_DUMP
Al final verás DONE: /root/keitaro_orbitra_full.sql.gz. El archivo suele pesar 1–5 MB.
2. Descarga el archivo
En la página ⚙ → Migrations, escribe la IP del servidor de Keitaro — el panel la rellenará en los comandos listos para copiar. Ejecuta el comando en tu equipo, no en el servidor:
# macOS / Linux
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz ~/Downloads/
# Windows (PowerShell)
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz $env:USERPROFILE\Downloads\
3. Importar a Orbitra
⚙ → Migrations → Import from Keitaro (SQL dump):
- Elige un archivo
.sql.gzo.sql. El dump no se ejecuta como SQL — solo se analiza. - Marca qué importar. Keep campaign IDs (ID de Orbitra = ID de Keitaro) solo funciona en una instalación limpia donde la tabla de campañas está vacía, incluido el archivo.
- Show preview — una prueba en seco sin escribir: cuántos objetos de cada tipo se importarán y qué filtros no se transfieren.
- Import into Orbitra.
Para importaciones repetidas en un servidor de prueba hay un bloque Cleanup: borra toda la configuración del tracker (dominios, ofertas, redes de afiliados, campañas, flujos, postbacks, píxeles, fuentes, landings, grupos) sin tocar estadísticas ni usuarios. Debes escribir DELETE para confirmar.
4. Después de la importación
- Tokens. Abre un par de campañas — el token de Click API debería coincidir con el de Keitaro. Así los scripts de integración en tus sitios (
click.php, KClient) siguen funcionando; solo necesitas cambiar la dirección del tracker en ellos. - Dominios. Apunta los registros A de los dominios al nuevo servidor (o conecta Cloudflare / Namecheap / Dynadot — los registros se configurarán solos) y espera los certificados (Dominios y SSL).
- Postbacks de las redes de afiliados. La Postback URL en Orbitra es distinta:
https://your-domain/<postback_key>/postback?…. Actualízala en los paneles de las redes (Postbacks). - Base de datos geo. Sin ella, los filtros de país no funcionan — revisa ⚙ → Geo databases.
- Comprobación del enrutamiento. El test link de la campaña con
&_dbg=1muestra qué flujo se selecciona y por qué, sin registrar ningún clic (Campañas y flujos).
Problemas comunes
| Síntoma | Causa y solución |
|---|---|
El comando de dump dice no Keitaro tables found | Base de datos equivocada en inventory.env o una instalación de Keitaro no estándar. Revisa MARIADB_KEITARO_DATABASE |
no MariaDB client … and no MariaDB container found | No hay cliente MariaDB ni contenedor MariaDB en ejecución — arranca Keitaro o instala el cliente |
| La importación no encontró nada | El dump está vacío o es de la base de datos equivocada — revisa el tamaño del archivo y la línea Dumping tables: en la salida del comando |
| Los flujos no se transfirieron | La opción "Import streams" no estaba marcada, o al dump le faltan keitaro_streams y las tablas de asociación |
| El dominio responde 404 | El DNS aún no apunta al nuevo servidor, o el dominio no tiene una campaña Index asignada |
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 →