Costos
Orbitra trae el gasto diario de las cuentas publicitarias y lo reparte entre los clics, así que el ROI y la ganancia en los informes se calculan con dinero real, no con un costo por clic manual.
Las conexiones están en ⚙ → Integrations, en el grupo de redes publicitarias: Facebook Costs, TikTok Costs, Google Ads Costs. La pestaña Integrations del editor de campaña muestra si los clics de la campaña llevan IDs para la asignación y te permite añadir una conexión.
Cómo llega el gasto a un clic
- El cron
aggregator_cron.php(el instalador lo añade cada 15 minutos) recorre las conexiones cuyo intervalo de actualización venció. Cada pasada relee los últimos 5 días, y la primera lee 30: las cuentas publicitarias revisan el gasto retroactivamente, y el día actual crece hasta la medianoche. - Los registros aterrizan en
cost_recordscon actualizaciones claveadas por(connection_id, external_id). Volver a sincronizar el mismo día es seguro: el gasto se recalcula, no se acumula. - Para cada registro, se asignan los clics del mismo día, del nivel más específico al más amplio:
ad_id(tambiéncreative_id,creative);adset_id/adgroup_id(tambiénadgroup,adgroupid,ad_group_id);campaign_id(tambiéncampaign,campaignid,ad_campaign_id).
- El gasto del día se divide en partes iguales entre los clics asignados.
- El gasto se convierte a la moneda del tracker (tasas de
open.er-api.com, cacheadas 12 horas; tasas personalizadas vía el ajustefx_rates_manual_json, unidades por 1 USD).
El requisito principal: el enlace del anuncio debe pasar el ID de anuncio, grupo o campaña al tracker. La manera más fácil es elegir una fuente de tráfico de plantilla (Facebook, TikTok, Google Ads) en la campaña — la plantilla añade ella misma las macros necesarias.
Los registros que no encontraron clics reintentan la asignación en cada sincronización: un clic tardío, un enlace arreglado o un adgroup_id nuevo harán entrar el gasto.
"Recibidos N, asignados 0"
El botón Refresh costs de una conexión muestra el motivo concreto:
| Código | Significado |
|---|---|
no_spend | llegaron registros, pero el gasto en ellos es cero |
no_clicks | no hay clics en Orbitra esos días |
no_ids | los clics no llevan ID de anuncio, grupo o campaña — el enlace no apunta directo a la campaña de Orbitra, o los parámetros se pierden en el camino |
macros | los clics contienen macros sin resolver como __CID__ — la fuente no sustituyó los valores |
ids_differ | los IDs en los clics y en el informe de la cuenta publicitaria no coinciden; se muestran ambos |
En la tarjeta del clic, la sección "Parameters" muestra todos los parámetros capturados, con los IDs de la red publicitaria primero.
Facebook / Meta
Un Long-lived User Token o System User Token con ads_read + el ID de la cuenta publicitaria (act_…). Puedes especificar la versión de la API y un proxy. Para detalles, ver Facebook / Meta.
TikTok
Tres maneras de conectar:
| Método | Qué necesitas |
|---|---|
| Connect via TikTok MCP | Solo un login de TikTok. No hace falta app de desarrollador ni token — el tracker se registra él mismo a través del servidor MCP oficial de TikTok. Importa gasto; no importa píxeles. El panel debe abrirse sobre HTTPS (https:// sobre una IP desnuda también sirve) |
| 1-Click (Sign in with TikTok) | App ID y App Secret de tu propia app de TikTok for Business: las variables de entorno ORBITRA_TIKTOK_APP_ID / ORBITRA_TIKTOK_APP_SECRET, o los campos de conexión manual. Encuentra cuentas publicitarias y píxeles, importa píxeles al Pixel Vault |
| Manual | Un token de Marketing API de una app de desarrollador gratuita (Developer Portal → Apps & Agents → Direct Advertiser, permisos Ads Management y Reporting) + Advertiser ID |
Un token de Events Manager no sirve para importar gasto — solo envía eventos de conversión. Si la lista de cuentas publicitarias no se puede leer por MCP, puedes pegar Advertiser IDs a mano, separados por comas.
Google Ads
- 1-Click (Sign in with Google) — encuentra cuentas directas y cuentas hijas de MCC, creando una conexión por cada una que selecciones. Requiere un Developer Token (del MCC) y un OAuth Client ID + Secret (Google Cloud Console, tipo "Web application", URI de redirección
https://your-domain/api.php?action=google_ads_oauth_callback). - Manual — Customer ID, Developer Token, Client ID, Client Secret, Refresh Token.
Las claves del 1-Click se toman en orden: las variables de entorno ORBITRA_GOOGLE_CLIENT_ID, ORBITRA_GOOGLE_CLIENT_SECRET, ORBITRA_GOOGLE_DEVELOPER_TOKEN → ajustes → campos de una conexión manual ya guardada. La manera más simple es guardar una conexión manual una vez — después el botón de 1-Click también funciona. Para comprobar la configuración del servidor: php check_google_ads_oauth.php.
Las variables de entorno se leen del entorno de PHP-FPM (
env[ORBITRA_GOOGLE_CLIENT_ID] = …en la configuración del pool), no del archivo.env— el código PHP no lo carga..env.examplees solo una lista de nombres.
Google y TikTok no aceptan redirecciones OAuth a http://. Sobre una IP desnuda sin certificado, usa una conexión manual.
El gasto se asigna por los parámetros ValueTrack {campaignid} y {creative} — la plantilla de fuente de Google Ads los añade.
Redes push y pop
El gasto de las redes publicitarias push/pop — AdMaven, PropellerAds, Kadam, Galaxion, HilltopAds, Adsterra, Clickadu — se importa por el mismo cron y aterriza en los clics por campaña y, donde la red lo reporta, por zona (sitio). El Zone Killer, que bloquea las zonas que queman dinero, funciona con estos datos. Ver Redes push y pop.
Dolphin y Fbtool
Estos servicios solo pueden enviar gasto a Keitaro vía su Admin API. Orbitra acepta la misma petición en POST /admin_api/v1/campaigns/<ID>/update_costs. Para detalles, ver Dolphin / Fbtool.
Gasto manual
El botón Refresh costs del menú de campaña fija el gasto de un período a mano (acción update_costs).
Agregador de ingresos
⚙ → Revenue Aggregator — la tarea inversa: traer ingresos de cuentas de programas de afiliados que no envían postbacks. Motores: ReferOn, Affilka, Generic API. Para cada conexión fijas la red, el tipo de deal, el intervalo de sincronización y el nombre del parámetro donde el programa de afiliados guarda el click ID de Orbitra. Los ingresos y los logs de sincronización están en las pestañas de la misma página.
Agencias y la comisión
Las cuentas publicitarias alquiladas cuestan más de lo que dice el cabinet: el porcentaje de la agencia se escribe en cada importación (cost_records.fee_amount; clicks.cost lleva el gasto con la comisión, clicks.fee la parte de la comisión) — así el ROI/CPC son honestos desde el momento en que el gasto aterriza, y cambiar el porcentaje después nunca reescribe la historia.
- La pestaña Agencies de la sección del agregador gestiona agencias (nombre, % de comisión, contactos, condiciones de pago, notas) y las compara por gasto, CPC, CPM y ROI en un período.
- Cada conexión de costos elige su agencia en el editor.
- Los informes ganan las columnas Spend (cabinet) y Agency fee; cada agrupación divide ambas.
Nombres de anuncios, estados, métricas de plataforma
La sincronización de costos también recoge lo que la plataforma sabe sobre los anuncios mismos: nombres y estados en ad_entities (estados refrescados cada hora, en la misma pasada del cron), impresiones y los conteos de clics propios de la plataforma en las filas de gasto. En los informes de campaña agrupados por anuncio / adset / campaña obtienes nombres en vez de ids pelados, un chip de estado y las columnas del lado de la plataforma: Impressions, Clicks (platform), CPM, CTR (platform) y Click loss = 1 − visitantes del tracker / clics de plataforma — el número que delata al instante un problema de cloaking o de dominio, y que adset.pro no tiene.
Un banner superior en los informes muestra la proporción de ingresos que no se puede atar a un id de anuncio (una macro __CID__ / {{ad.id}} sin reemplazar cuenta como faltante) y salta al editor de la fuente culpable.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
El intervalo se comprueba por conexión, así que un cron frecuente es barato; para intervalos de menos de 15 minutos, ejecútalo más seguido. Banderas: --force (ignora el intervalo), --connection=5, --days=30.
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 →