Dolphin / Fbtool
Dolphin y Fbtool.pro no tienen integraciones propias con trackers. Ambos servicios hacen exactamente una cosa: enviar costos a Keitaro a través de su Admin API. Por eso el "soporte de Dolphin/Fbtool" en Orbitra es un endpoint entrante compatible que los servicios llaman creyendo que hablan con Keitaro:
POST https://your-tracker.com/admin_api/v1/campaigns/CAMPAIGN_ID/update_costs
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"start_date": "2026-08-15",
"end_date": "2026-08-15",
"cost": 12.34,
"currency": "USD",
"timezone": "Europe/Berlin",
"filters": { "sub_id_4": "120212558973560058" }
}
La respuesta sigue el formato de Keitaro: {"success":true, ...} o un código HTTP + {"success":false,"error":"..."}.
El endpoint está implementado en admin_api.php; el enrutamiento vive en .htaccess (Apache) y core/nginx_config.php (nginx). Regenerar la configuración de nginx tras una actualización incorpora la location automáticamente.
1. Crear una clave de API
El endpoint acepta las claves personales del tracker (tabla user_api_keys) — las mismas que usa MCP.
- Un admin abre ⚙ → Users → API keys.
- Crea una clave con permisos de write (las claves de solo lectura reciben un
403). - La clave se pasa en la cabecera
Authorization: Bearer <key>oX-Api-Key: <key>.
2. Configuración de Dolphin
Dolphin → Settings → Cost export → Keitaro:
- Tracker URL:
https://your-tracker.com - API key: la clave del paso 1
- Matching: por Adset ID (por defecto) — entonces el filtro
sub_id_3coincidirá automáticamente
con el parámetro adset_id del clic.
3. Configuración de Fbtool.pro
Fbtool → Costs → Keitaro:
- Admin panel URL:
https://your-tracker.com - API key: la clave del paso 1
- Fbtool hace la coincidencia por
ad.idy envía el filtrosub_id_4— coincidirá
automáticamente con el parámetro ad_id del clic.
4. Qué debe estar configurado en la campaña
Los filtros comparan contra los parámetros del clic (clicks.parameters_json). La plantilla de fuente de tráfico de Facebook pone esos parámetros en cada clic: la campaña debe recibir tráfico con un enlace que contenga
ad_id={{ad.id}}&adset_id={{adset.id}}&campaign_id={{campaign.id}}
En el editor de campaña esto se hace eligiendo la fuente "Facebook Ads": los parámetros se rellenan automáticamente (la pestaña "Parameters", el enlace con macros).
5. Cómo se reparte el costo
- Los clics de la campaña entre
[start_date .. end_date], acotados por los filtros. - La clave del filtro se prueba como nombre de parámetro tal cual (
ad_id,adset_id,
campaign_id, …) más los valores por defecto de la plantilla FB de Keitaro: sub_id_3→adset_id, sub_id_4→ad_id. Varios filtros se combinan con AND.
- La suma se convierte a la moneda del tracker (
core/CurrencyRates.php) y se reparte
en partes iguales entre los clics coincidentes (CPC plano) — el mismo modelo que usa core/CostImporter.php.
- Reenviar el mismo período sobrescribe el reparto en vez de sumarse a él (los servicios
envían costos cada 60–90 minutos).
- Si no se encontró ningún clic, la suma se guarda en
cost_recordsbajo una conexión oculta
external_api sin asignación — así el costo no desaparece en silencio. Revisa los filtros y los parámetros de la campaña si el costo "nunca llega".
6. Verificación
curl -X POST 'https://your-tracker.com/admin_api/v1/campaigns/10/update_costs' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"start_date":"2026-08-15","end_date":"2026-08-15","cost":10,"currency":"USD","filters":{"ad_id":"123456"}}'
La respuesta {"success":true,"clicks":N,...} significa que el costo se registró y se repartió entre N clics. clicks:0 — el costo quedó estacionado sin asignación: el filtro no coincidió con ningún clic del período.
Añadido en la v0.9.7.7.
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 →