Docs

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.

  1. Un admin abre ⚙ → Users → API keys.
  2. Crea una clave con permisos de write (las claves de solo lectura reciben un 403).
  3. La clave se pasa en la cabecera Authorization: Bearer <key> o X-Api-Key: <key>.

2. Configuración de Dolphin

Dolphin → Settings → Cost export → Keitaro:

con el parámetro adset_id del clic.

3. Configuración de Fbtool.pro

Fbtool → Costs → Keitaro:

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

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.

en partes iguales entre los clics coincidentes (CPC plano) — el mismo modelo que usa core/CostImporter.php.

envían costos cada 60–90 minutos).

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.

← Anterior
Facebook / Meta
Siguiente →
FB Comment Cleaner
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 →