Biblioteca de creativos
La pestaña Creatives de la Content Gallery responde una pregunta: qué creativos ganan de verdad. Crece a partir de la galería existente — los archivos sincronizados de las plataformas (imágenes y videos de Facebook, portadas de TikTok) conviven con tus propias subidas, cada creativo lleva gasto/ingresos/ROI, y un borrador que subiste a mano toma métricas en el momento en que un anuncio empieza a usarlo.
Cómo llegan los datos
Nada se configura a mano. La cadena es:
- La sincronización de costos (el cron del agregador o Sync now) trae las filas de gasto de Facebook/TikTok. Cada fila lleva ahora también los nombres de anuncio/adset/campaña y los contadores propios de impresiones/clics de la plataforma (
cost_records.impressions,cost_records.platform_clicks), y los inserta con upsert enad_entities. - La pasada de metadatos de creativos (
core/CreativeSync.php, limitada a una pasada cada 3 horas por conexión) le pregunta a la plataforma qué contienen esos anuncios: el hash de imagen / id de video / texto del anuncio del creativo. Las vinculaciones aterrizan encreative_usages, las tareas de descarga encreative_fetch_queue. - El worker de archivos (
cli/creative_fetch_cron.php, programado por install.sh cada 5 minutos) descarga los archivos reales: los originales de Facebook (/act_X/adimagespor hash, fuente del video + portada), portadas y vistas previas de TikTok (/file/video/ad/info/,/file/image/ad/info/). La deduplicación es exacta por sha256; los casi-duplicados se emparejan por un dHash de 64 bits con un umbral de Hamming ≤6 — ese es el vínculo de "el borrador se activó": tu borrador subido a mano se ata a la copia de la plataforma en vez de generar un duplicado. - El agregado diario (
core/CreativeStats.php::rebuildWindow) reconstruyecreative_dailytras cada sincronización de costos: gasto (con la comisión de agencia), impresiones, clics de plataforma, clics/visitantes del tracker, instalaciones, registros, FTD e ingresos — las métricas del tracker se agrupan en los días de la zona horaria propia de la cuenta publicitaria vía la columna indexadaclicks.ad_ref.
El worker valida las descargas por firma (mp4 ftyp / webm EBML para video, getimagesize para imágenes), hace cumplir los topes de tamaño (10 MB imágenes, 100 MB video) abortando la transferencia a mitad de flujo, y pasa por el proxy de la conexión. Un banner en la pestaña te avisa cuando hay archivos en cola pero el worker no ha corrido.
La pestaña
- Filters: período (por defecto los últimos 7 días), plataforma, formato, etiqueta, búsqueda, active only (creativos cuyos anuncios siguen corriendo), orden por gasto/ingresos/ROI/clics.
- KPI cards sobre assets únicos — un carrusel de 3 imágenes es un solo creativo, y el gasto del día se reparte en partes iguales entre los tres archivos.
- El ROI sin ingresos es un guion, nunca −100 %: un creativo que simplemente aún no convirtió no es uno quemado. Colores: verde ≥ 30 %, ámbar 0–30 %, rojo bajo cero.
- Creative card: series por día (barras de gasto, marcas de ROI), los anuncios que lo usaron con estados y gasto (el drill Cabinet › Campaign › Adset), el texto del anuncio, la familia de casi-duplicados, tus etiquetas, descarga.
- Las etiquetas son de formato libre (
offer, geo, approach, creator) — el informe por etiqueta responde "qué enfoque funciona mejor".
Dónde aparecen los creativos en otros lugares
- Los informes de campaña ganan una agrupación Creative (el nombre del archivo en vez de un id de anuncio pelado) y una miniatura de vista previa en las filas de anuncios.
- El editor de campaña tiene una pestaña Creatives: qué trajo tráfico a esta campaña en los últimos 7 días, con el ROI de todo el tracker.
- El resumen diario de Telegram lista los top-3 y los peores-3 creativos del día y dispara una alerta de burnout cuando el ROI o el CTR de plataforma cayeron más fuerte que el umbral (por defecto −50 %) en los últimos 7 días contra los 7 anteriores, con gasto por encima del mínimo (por defecto $50). Umbrales: ajustes
telegram_creative_burnout_drop_pct,telegram_creative_burnout_min_spend. - La extensión de Ads Manager muestra CREATIVE ROI (de por vida) junto a las columnas por día de un anuncio.
- MCP:
orbitra_creatives_top,orbitra_creative_detail. - Los assets sincronizados de plataforma están disponibles en el MediaPicker para pósters de PWA/landing como cualquier otro archivo.
Banner de salud de atribución
El banner superior del informe ("Revenue linked to ads: 62%") viene de action=revenue_attribution_health: los ingresos cuentan como vinculados cuando cualquier parámetro de clic a nivel de anuncio lleva un id real de plataforma — una macro __CID__ / {{ad.id}} sin reemplazar cuenta como faltante, la misma regla que usan los diagnósticos del importador de costos. El botón Fix salta al editor de la fuente culpable con la pestaña de parámetros resaltada.
Notas
- Los archivos de video de TikTok no se descargan (la API requiere derechos de asset aparte); la portada se guarda y el creativo sigue llevando métricas completas.
- Los ítems de la segunda cola (extracción de texto con IA, etiquetas automáticas) se dejaron sin construir a propósito.
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 →