Redes push y pop
Importación de gasto de las redes publicitarias push y pop, más el Zone Killer — reglas que encuentran (y, si se los permites, bloquean) las zonas que queman dinero. Todo vive en un solo lugar: la tarjeta Push/Pop networks en ⚙ → Integrations, en el grupo de redes publicitarias junto a los costos de Facebook / TikTok / Google.
Redes
| Red | Nivel de gasto | Clave API |
|---|---|---|
| AdMaven | campaña × zona | Advertiser panel → API section → API token |
| PropellerAds | campaña × zona | SSP → Profile → API token |
| Kadam | campaña × zona | Advertiser account → API section → API token |
| Galaxion | campaña × zona | E-mail + contraseña de la cuenta (el tracker consigue el token él mismo), o un token API ya listo |
| HilltopAds | solo campaña | My Account → API tab → API key |
| Adsterra | solo campaña | Settings → API tab → Generate new token (solo el token más nuevo funciona) |
| Clickadu | solo campaña | Advertiser account → API section → API key |
Las redes marcadas solo campaña sí tienen un desglose por zona en su API, pero sus filas no llevan id de campaña — una zona ahí no se puede atar a la campaña cuyos clics compró. Su gasto se reparte entre los clics de la campaña, y la tarjeta de conexión advierte de esto antes de que conectes.
Conexión
Elige un mosaico de red, pega la clave, pulsa Check connection — muestra el saldo real de la cuenta — y guarda. Cada conexión tiene su propio intervalo de actualización; los botones de la lista: Update spend (ahora), pausar, editar, borrar. El gasto ya importado se queda en los informes tras un borrado.
La sincronización corre en la misma pasada de aggregator_cron.php que las demás conexiones de costos (ver Costos): cada pasada relee los últimos 5 días, la primera 30. Resincronizar un día es seguro — el gasto se recalcula, no se acumula.
Cómo llega el gasto a un clic
El requisito principal es el mismo que para Facebook o TikTok: la campaña debe usar la plantilla de fuente de tráfico de la red, para que el enlace pase el id de campaña de la red (a ad_campaign_id) y el id de zona (las plantillas de fuente de Keitaro lo escriben en source, la plantilla integrada de PropellerAds en zone). Sin la macro de zona el gasto igual aterriza — pero solo por campaña, nunca dividido por zona.
La asignación, del nivel más específico al más amplio:
- campaña × zona — una fila de zona se atribuye solo a los clics del mismo día que llevan tanto el id de zona como el id de campaña de la red. Un id de zona solo no basta: los ids de zona no son únicos entre redes.
- campaña — una fila de zona cuya zona no asignó ningún clic se suma a los clics de la campaña sin zona (nunca se sube a clics ya valorados por sus propias filas de zona — varias zonas sin asignar se suman entre sí en vez de sobrescribirse).
Las claves de parámetro de clic que cuentan como "la zona": zone, zone_id, zoneid, sub_source_id.
Si una sincronización responde "registros recibidos, pero ninguno se pudo adjuntar a clics", lo más probable es que la campaña no use la plantilla de fuente de esta red — el enlace no trae id de campaña para asignar. Los diagnósticos de "Recibidos N, asignados 0" de Costos aplican aquí también.
Zone Killer
Una tarjeta en la pestaña General del editor de campaña (la campaña debe estar guardada primero). Una regla vincula la campaña a una conexión de costos push/pop y decide qué zonas son candidatas:
- window — cuántos días hacia atrás juzgar (el gasto y las conversiones se suman por zona en la ventana);
- min spend — una zona que gastó menos no vale la pena tocarla;
- zero conversions y/o max ROI — las condiciones de eliminación;
- mode —
dry_run(por defecto) oautocon un tope de bloqueos por corrida.
Las candidatas se calculan a partir de clicks.cost / clicks.revenue por zona — los mismos números repartidos que muestran los informes, con las mismas claves de zona con las que asignó la importación de costos, así que una regla nunca puede juzgar una zona que el importador valoró distinto.
- Dry-run lista las candidatas; seleccionas y pulsas Block selected.
- Auto deja que
zone_rules_cron.phpejecute las candidatas él mismo (con tope por corrida) y envía una notificación de Telegram sobre lo que bloqueó.
El bloqueo pasa por la API de escritura de la red para AdMaven, HilltopAds, PropellerAds, Kadam y Galaxion. Adsterra y Clickadu no tienen una API de escritura de zonas utilizable: sus reglas se quedan en dry-run, y la tarjeta copia los ids de zona seleccionados para que los pegues a mano en la blacklist de la red.
Cada bloqueo y desbloqueo — manual o automático — aterriza en un diario de solo añadir con las métricas que respaldaron la decisión; el conjunto bloqueado actual es una zona cuya última acción exitosa es "block". El diario se muestra bajo la regla.
Para las redes solo campaña (HilltopAds, Adsterra, Clickadu) el Zone Killer juzga las zonas de forma aproximada — por su parte de los clics de la campaña, porque la API no da gasto por zona. Mantén sus reglas en dry-run y revisa la lista antes de bloquear.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
*/30 * * * * php /var/www/orbitra/zone_rules_cron.php >> /var/www/orbitra/var/logs/zone_rules.log 2>&1
La primera línea es el cron que el instalador añade para la sincronización de costos. La segunda — el ejecutor del Zone Killer — la añades tú, y solo si usas reglas auto; una pasada es barata (una regla sin candidatas es un solo GROUP BY sobre los clics de la campaña). Banderas: --campaign=12 (una campaña), --quiet.
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 →