Embudo de PWA
Renderer v16 · migración 51. La visita en el navegador a una landing PWA es ahora un embudo configurable: una lista ordenada de pantallas donde el primer paso activado es lo que ve primero un visitante frío, cada activación de pantalla envía un beacon y se reporta, y cada pantalla puede llevar su propio script de tracking.
El modelo del embudo
La columna landings.config_json gana una clave, funnel — un array ordenado de pasos:
"funnel": [
{ "id": "scr_k3x9_2a", "type": "screen", "enabled": true,
"template": "lobby", "title": "...", "text": "...",
"button": "...", "image": "...", "custom_html": "...", "custom_js": "..." },
{ "id": "store", "type": "store", "enabled": true },
{ "id": "instructions", "type": "instructions", "enabled": true },
{ "id": "push", "type": "push", "enabled": true }
]
Tipos de paso:
| tipo | qué renderiza |
|---|---|
store | La ficha de Google Play / App Store (markup existente; el UA elige el diseño) |
screen | Una pantalla del operador: HTML de plantilla lobby / slot / wheel / custom — las mismas plantillas que usa la pantalla de la app instalada. Hasta 5 por embudo |
instructions | Una pantalla completa de instrucciones de instalación. Se renderizan ambas listas de plataforma; el CSS clave en data-store (el sniffing de UA en <head>) muestra los pasos de Safari en iOS y los del menú de Chrome en el resto |
push | La tarjeta de opt-in de push dentro del flujo del navegador. Solo cuando Push enabled — sin la clave VAPID o sin soporte del navegador el paso sería un callejón sin salida, así que el flujo también lo salta en tiempo de ejecución |
Reglas (PwaLanding::normalizeFunnel() es la whitelist, el editor solo produce estructuras que esta acepta):
- los ids cumplen
^[a-z0-9_]{1,32}$, son únicos y nunca colisionan con los
ids incorporados; los inválidos se regeneran en el servidor;
- un
store/ uninstructions/ unpushpor embudo (los duplicados se descartan); - máximo 5 pasos
screen; funnelausente o inválido →[store]. **Toda configuración previa al embudo
renderiza exactamente lo que renderizaba antes** — la ficha de tienda sigue siendo la primera pantalla, ios_flow sigue gobernando la superposición del clic de instalación y la tarjeta de push sigue perteneciendo a la app instalada.
Semántica del flujo (JS de la página)
- El primer paso activado se muestra en una visita fría; un primer paso que
no sea la tienda oculta los diseños de la ficha desde el primer render (data-flow-first, fijado por el script del <head> antes de que exista el body).
- Cualquier CTA
.install-triggerdentro del flujo **avanza al siguiente paso
activado**; cuando el flujo se queda sin pasos, el CTA cae al intento de instalación clásico (prompt nativo / superposición iOS / redirección según la configuración). El operador decide dónde se dispara el prompt de instalación ordenando el embudo.
- La tarjeta de push del flujo: Allow ejecuta el mecanismo estándar de
permisos (la entrega a sw.js no se toca), Not now responde al paso y avanza. Cuando el flujo se agota tras responder a la push, el visitante pasa a la oferta (flowExhausted); con app_action = screen se muestra en su lugar la pantalla de la app instalada.
- La app instalada (abierta en standalone) no forma parte del flujo: la rama
standalone — beacon de apertura, confirmación de instalación en iOS, sincronización de push y luego app_action — se comporta exactamente como antes.
- Los temporizadores
auto_redirect/decline_redirect/install_redirect
conservan su significado global y disparan hacia la oferta sin importar el paso visible.
Tracking por pantalla
Cada activación de una pantalla del flujo envía un beacon a /pixel.gif?action=pwa&kind=screen&screen=<id>&subid=<click>:
clicks.pwa_entry_screen— la primera pantalla que vio el clic (protegido
contra NULL; la fila del clic actúa de filtro de deduplicación, igual que en toda columna pwa_*);
clicks.pwa_last_screen— el paso en el que estuvo el clic por última vez
(gana la última escritura);
pwa_screen_views— el log de eventos 1:N en crudo
(click_id, landing_id, screen, created_at), limitado a 100 filas por clic para que una pestaña aparcada que rota pantallas no pueda inflar la tabla. La migración 51 la crea; el DDL de autocuración siempre activo garantiza que exista en cada versión del esquema, porque el SQL de los informes la referencia incondicionalmente.
Cada paso screen puede llevar además custom_js (el campo "Screen tracking script" del editor). Se ejecuta en la primera activación de la pantalla, no al parsear la página — un píxel publicitario no debe dispararse para una pantalla que el visitante nunca alcanzó. Los motores interactivos de las plantillas (rodillos de slot, ruleta de bonus) se refactorizaron en factorías por contenedor para que varias copias de la misma plantilla puedan coexistir en una página; los ids de elemento llevan el prefijo del paso (fs<id>_…). Helpers disponibles para los scripts personalizados: window.orbitraFlow.next(), window.orbitraFlow.goto(id), además de los ya existentes orbitraRedirect / orbitraBeacon.
Estadísticas
- Métrica
pwa_screen_views— vistas totales de pantallas del flujo,
agregadas en las tarjetas del dashboard, la lista de campañas, campaign_report, y las tablas de Landings y Offers (paridad informes == campañas). Un clic contribuye legítimamente con varias vistas; no hay ninguna ratio derivada por encima.
- Dimensiones
pwa_entry_screen/pwa_last_screen— columnas de clics
registradas en $allowed_dimensions (api.php, campaign_report), así que ambas funcionan como capas de Group By y como filtros. NULL (filas anteriores a la función, tráfico no PWA) se agrupa como Unknown.
- Endpoint
pwa_funnel_stats— tarjeta de embudo por landing en la página
Landings (el botón de gráfico de barras en las filas PWA): vistas/únicos por pantalla, distribuciones de entrada y salida (una salida = la última pantalla del clic sin transición a la oferta), y la matriz de transiciones pantalla→pantalla recorriendo el log de eventos ordenado. El orden de pantallas refleja primero la configuración del embudo.
Editor y vista previa
El paso 1 del constructor de PWA estrenó la sección Visit funnel: una lista de pasos reordenable (arrastrar por el grip, botones ↑/↓), interruptores de activación, la insignia de primera pantalla, editores por pantalla (plantilla, título/texto/botón, imagen hero vía MediaPicker, HTML personalizado + JS de tracking) y un medidor de límite (0/5). La vista previa en vivo puede abrir el embudo en cualquier paso activado — pwa_preview acepta el id de un paso como view y lo fuerza vía window.__PWA_FORCE_SCREEN.
Versión del renderer y autocuración
Se subió RENDERER_VERSION de 15 → 16: la ruta del lander y el servidor de raíz de dominio regeneran los estáticos escritos por el renderer anterior en la siguiente vista, así que las PWA ya creadas incorporan el arranque del flujo (y el beacon de vista de pantalla de la tienda) sin volver a guardar. Las configuraciones heredadas se regeneran con el embudo [store] y quedan visualmente idénticas.
Tests
tests/pwa_funnel_http_test.php— el modelo de configuración del embudo, el
markup del flujo, la deduplicación/límite/atribución de beacons y el endpoint de estadísticas del embudo (HTTP, sandbox del harness).
tests/report_metrics_test.php— valores de referencia calculados a mano
para pwa_screen_views en el SQL de dashboard, landings y ofertas (vistas 1:N: un clic aporta cada pantalla que vio, reaperturas incluidas).
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 →