Docs

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:

tipoqué renderiza
storeLa ficha de Google Play / App Store (markup existente; el UA elige el diseño)
screenUna 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
instructionsUna 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
pushLa 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):

ids incorporados; los inválidos se regeneran en el servidor;

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)

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).

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.

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.

standalone — beacon de apertura, confirmación de instalación en iOS, sincronización de push y luego app_action — se comporta exactamente como antes.

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>:

contra NULL; la fila del clic actúa de filtro de deduplicación, igual que en toda columna pwa_*);

(gana la última escritura);

(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

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.

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.

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

markup del flujo, la deduplicación/límite/atribución de beacons y el endpoint de estadísticas del embudo (HTTP, sandbox del harness).

para pwa_screen_views en el SQL de dashboard, landings y ofertas (vistas 1:N: un clic aporta cada pantalla que vio, reaperturas incluidas).

← Anterior
PWA y Web Push
Siguiente →
Popups de conversión
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 →