Grabaciones de sesión y mapas de calor
Observa cómo se comportó un visitante en tu landing: movimiento del ratón, scroll, clics y toques, reproducidos como un video. Funciona de forma muy parecida a Microsoft Clarity o Yandex Webvisor, con la diferencia de que las grabaciones se quedan en tu propio servidor. Cada landing también gana un mapa de calor de clics y un mapa de scroll.
Desde la v1.8.3 las grabaciones también cubren sitios completos, no solo landings: un sitio orgánico (tráfico SEO, tus propias páginas de servicio) con el script del tracker en cada página graba a través de las páginas — una visita es una grabación, con las transiciones de página en el reproductor y un mapa de calor de clics por página. Ver Grabar un sitio completo más abajo.
Cómo activarlo
- Abre la landing → pestaña Session recording.
- Marca Record sessions on this landing.
- Elige qué porcentaje de visitantes grabar: 5 / 10 / 25 / 50 / 100 %. Los visitantes se eligen al azar, pero la decisión queda fija por clic (un clic se graba siempre o nunca).
- Elige cuánto tiempo grabar: hasta que lo apagues, o 1 hora / 24 horas / 3 días / 7 días. Cuando se acaba el tiempo, la grabación se detiene sola y las grabaciones ya hechas se quedan.
- Pulsa Save, el botón de guardar habitual de la landing.
La pestaña muestra una estimación en vivo construida con el tráfico real de la landing de las últimas 24 horas, por ejemplo: "about 120 recordings a day, roughly 18 MB".
Los bots y los visitantes de la página segura nunca se graban. El servidor decide antes de enviar la página, así que esos visitantes ni siquiera reciben el script del grabador.
Grabar un sitio completo (tráfico orgánico)
Para un sitio que no es una landing — un sitio de servicios que vive del SEO, del tráfico directo y social — la grabación se activa a nivel de campaña:
- Pon
tracking.jsen todas las páginas del sitio, entre<head>y</head>(el snippet está en la pestaña Tracking de la campaña). Usatracking.jspara esto —kclient.jsykclient.phpno soportan sesiones multipágina ni la API de consentimiento. - Abre la campaña → pestaña Integrations → tarjeta Session recordings.
- Los mismos ajustes que en una landing: el porcentaje de visitantes (para un sitio con mucho tráfico 5–10 % suele bastar — cada página de una visita cuesta disco), cuánto tiempo grabar y una estimación en vivo con el tráfico real de la campaña.
- Marca Multi-page site: one click per visit si además quieres que las visitas se peguen — ver la sección siguiente.
Una visita queda grabada a través de las páginas: el reproductor muestra las transiciones, la lista muestra cuántas páginas abrió el visitante y cuáles fueron la primera y la última, el mapa de calor de clics gana un selector de página (cada página tiene su propio mapa) y la lista de grabaciones puede filtrarse por campaña, por fuente de tráfico (Google / Bing / Yandex / social / directa), por una subcadena de página y por multi-page only.
El interruptor de la campaña también cubre los clics que llegan a una landing sin ajustes de grabación propios — pero una landing que hayas configurado alguna vez para grabaciones conserva el control total de sus propios clics (su interruptor apagado significa apagado).
Un clic por visita
Sin esto, cada página del sitio registra su propio clic en la campaña — igual que siempre. Con Multi-page site: one click per visit marcado, un visitante que recorre las páginas del sitio es un clic: las estadísticas dejan de inflarse con páginas vistas y la grabación se pega en una sola sesión.
El pegado tiene salvaguardas, así que un clic de pago nunca lo absorbe un clic recordado:
- el tracker pega solo cuando el visitante viene del mismo sitio (una navegación interna) y pasaron menos de 30 minutos desde la página anterior;
- una petición que lleva marcadores de anuncio nuevos o modificados (
fbclid,gclid,ttclid,msclkid,utm_,sub_id_N, …) es una entrada nueva de campaña incluso dentro de esos 30 minutos — el segundo clic de anuncio recibe su propio clic, sus propios parámetros y su propia atribución CAPI. Un sitio que propaga los mismos* marcadores por sus enlaces internos sigue pegándose sin problema; - el interruptor está apagado por defecto: una actualización nunca cambia los números de clics de nadie hasta que tú lo marcas.
Consentimiento de cookies (sitios de la UE)
Para visitantes de la UE, la grabación de sesión necesita el consentimiento del visitante. Marca Start only after cookie consent en la tarjeta de la campaña, y hasta que el visitante acepte no se escribe nada — ni siquiera los clics para el mapa de calor. El grabador se despierta desde tu banner de cookies con una sola llamada:
window.OrbitraReplay && OrbitraReplay.consent();
La guarda window.OrbitraReplay && … importa: tracking.js define el stub OrbitraReplay en cada página, pero tu banner puede dispararse antes de que cargue — la guarda hace que eso sea seguro. Dos alternativas equivalentes:
- tu gestor de consentimiento puede simplemente poner la clave de localStorage
orbitra_replay_consenta1— el grabador la consulta y arranca en la página actual, no solo en la siguiente; OrbitraReplay.revoke()retira el consentimiento y detiene la grabación sobre la marcha; tu banner debe llamarlo cuando el visitante rechaza.
Una vez dado, el consentimiento se recuerda, así que las páginas siguientes de la visita graban desde el principio. Borrarlo cuando el visitante lo retira es trabajo de tu banner. El modo de consentimiento condiciona lo que se escribe; el enmascaramiento de campos de formulario descrito en Privacidad funciona en todos los modos.
Dónde funciona la grabación
| Dónde | Cómo |
|---|---|
| Una landing subida a Orbitra (ZIP / editor), o una landing de acción "Show HTML" | Automático |
Una landing externa con tracking.js / kclient.js | Automático: el script carga /replay.js cuando la respuesta de la Click API dice que este clic se graba |
Una landing externa con kclient.php | Automático: un kclient.php actual imprime la etiqueta del grabador al final de la página. También puedes colocarla tú con <?php echo $client->replayScript(); ?> |
Un sitio completo con tracking.js en todas las páginas | Automático (v1.8.3): el interruptor a nivel de campaña en campaña → Integrations cubre cada página de la visita |
| Una campaña que redirige directo a la oferta | No es posible: no hay página que grabar |
El pegado multipágina (la continuación ?_subid=) y el stub de consentimiento existen solo en tracking.js; kclient.js y kclient.php graban su única página pero no pegan visitas ni exponen OrbitraReplay.
Ver las grabaciones
⚙ → Logs → Session recordings. Filtros: landing, campaña, período, dispositivo (desktop / mobile), fuente de tráfico (Google / Bing / Yandex / social / directa, derivada del referrer), una subcadena de página (coincide con la entrada o la última página de la visita), multi-page only, duración mínima, went to offer, converted, with rage clicks. Cada fila muestra la hora, país y dispositivo, landing y campaña, duración, clics (con una insignia 🔥 para rage clicks), profundidad de scroll, el desenlace (conversión / fue a la oferta / se fue) y el tamaño del archivo; las visitas multipágina muestran una insignia "N pages" con la ruta primera → última.
Cada encabezado de columna ordena la lista (clic de nuevo para invertir el sentido), y la lista se pagina con un selector de tamaño de página abajo.
Borrar. Marca filas para seleccionarlas, o marca la casilla del encabezado para seleccionar la página entera. Aparece una barra con Delete (N) y Clear selection. Cuando hay más páginas, ofrece además Select all recordings matching these filters (N), que selecciona de una vez toda grabación que cumpla los filtros actuales en todas las páginas. Así, "borrar todos los rebotes móviles de menos de 5 segundos de la landing X" es: pon los filtros → marca el encabezado → Select all matching → Delete. Cada fila tiene además su propio icono de basura, y el panel de almacenamiento tiene Delete this landing's recordings y Delete all recordings.
El reproductor tiene play/pausa, una línea de tiempo con marcas rojas en cada clic, velocidades de 1× a 8× y Skip inactivity, que salta las pausas donde no pasó nada. La tarjeta del clic en el log de tráfico también gana un botón Session recording cuando ese clic se grabó.
Rage click: tres clics en 0.7 s sobre el mismo punto. Normalmente significa que un botón o elemento no responde, y eso conviene arreglar.
Mapa de calor de clics y mapa de scroll
Ábrelo desde la pestaña de grabación de la landing, desde la tarjeta de grabaciones de la campaña, o con el botón Click heatmap de la lista de grabaciones una vez elegida una landing o campaña.
- Clicks: dónde hacen clic los visitantes, de azul (raro) a rojo (frecuente). Los anillos rojos marcan rage clicks. Desktop y mobile son mapas separados, porque el diseño es distinto.
- Scroll: la página dividida en 10 bandas, cada una etiquetada "X % reached Y %". Usa el temporizador de permanencia, así que cubre a todos los visitantes medidos, no solo a los grabados.
- Page selector (sitios multipágina): cada página del sitio tiene su propio mapa de clics — elige una ruta y tanto los puntos como el fotograma de fondo cambian a esa página. Sin él, las páginas se mezclarían en un espacio de coordenadas sin sentido.
La página detrás del mapa se dibuja desde la grabación más reciente de ese tipo de dispositivo (para una página elegida — desde su fotograma dentro de esa grabación). No va ninguna petición al sitio en vivo y no se registra ningún clic.
Qué buscar
Algunas maneras en que las grabaciones rinden en la compra diaria:
- Una landing que no convierte. Filtra la landing, pon Duration ≥ 15 s, deja Went to offer sin marcar y mira 5–10 visitas. Los visitantes que leen y aun así no hacen clic suelen decirte por qué: el CTA queda debajo del pliegue en móvil, un temporizador o popup tapa el botón, el formulario se ve roto.
- Rage clicks. Marca With rage clicks. Un grupo sobre un punto casi siempre significa un elemento que parece clicable y no lo es (un video falso, la imagen de un botón, un enlace ancla muerto). El mapa de calor enseña lo mismo de un vistazo, como anillos rojos.
- Móvil vs desktop. Abre el mapa de calor para ambos. Si los visitantes de teléfono nunca llegan al bloque de pedido en el mapa de scroll, acorta la página o repite el CTA más arriba.
- Calidad del tráfico. La gente real mueve el cursor en curvas, se detiene y hace scroll de forma irregular. Un chorro de grabaciones sin movimiento, con scrolls perfectos instantáneos o clics en el primer segundo apunta a tráfico malo o lleno de bots de esa fuente o placement, aunque haya pasado los filtros de cloaking.
- Antes y después. Cambia la landing, borra sus grabaciones viejas (filtra por la landing → marca el encabezado → Select all matching → Delete) y compara el mapa de calor nuevo con el viejo.
Grabar el 10 % durante uno o dos días suele bastar para ver el patrón. No necesitas el 100 % corriendo todo el tiempo.
Límites de almacenamiento
Los límites los comparte todo lo que graba — landings y campañas por igual. Se muestran en la pestaña de grabación de la landing, en la tarjeta de la campaña y bajo el botón de tamaño en la lista de grabaciones:
- Keep recordings for: 1 / 3 / 7 / 14 / 30 días. Las grabaciones más antiguas se borran automáticamente.
- Maximum disk space: de 256 MB a 20 GB. Cuando se llena, las grabaciones más antiguas se borran y las nuevas toman su lugar.
Límites de seguridad que no se pueden desactivar:
- una grabación se limita a 30 minutos y 5 MB;
- cuando el disco del servidor tiene menos de 1 GB libre, no se inicia ninguna grabación nueva;
- las grabaciones que nunca recibieron datos se limpian a las 2 horas.
Una grabación típica ocupa 50–300 KB (es la estructura de la página más los cambios, no video). La tarjeta muestra el promedio de tus grabaciones reales y cuántas caben en el límite elegido.
La limpieza corre como máximo una vez por minuto, impulsada por las grabaciones que entran y por abrir la lista. No hay cron que añadir ni comando de servidor que ejecutar tras la actualización.
Privacidad
- Todos los campos de formulario se enmascaran en el navegador del visitante. Lo que escriben (teléfono, nombre, contraseña) nunca sale del dispositivo; el replay muestra asteriscos.
- Dale a cualquier bloque la clase
orbitra-no-recordpara ocultarlo por completo (se reproduce como una caja vacía). Usaorbitra-maskpara enmascarar su texto. - Las grabaciones viven en
var/replays/de tu servidor, que la configuración de nginx nunca sirve públicamente. Se leen solo desde el panel, por usuarios con acceso a landings. - Si grabas visitantes de la UE, activa el modo de consentimiento o menciona la grabación de sesión en la política de privacidad de tu sitio.
Solución de problemas
La pestaña dice "Recording is on" pero la lista sigue vacía.
- Comprueba que las visitas de verdad llegan a esta landing: el flujo debe mandarle tráfico, y las visitas no deben ser bots ni visitantes de la página segura (esos nunca se graban).
- Con un porcentaje bajo (5 %) y poco tráfico, la primera grabación puede tardar. Para una prueba rápida, pon 100 % y abre el enlace de la campaña desde tu teléfono.
- Revisa que la ventana de grabación no se haya agotado: la pestaña de la landing muestra "Recording stopped…" cuando se agotó.
- Landing externa: la página debe tener
tracking.js,kclient.jso unkclient.phpactual. Una copia vieja dekclient.phpno sabe nada de grabaciones; descárgalo otra vez desde la pestaña Tracking de la campaña (Download kclient.php).
"The recording is too short to play". El visitante se fue antes de que se enviara la primera instantánea de la página (normalmente en menos de un segundo). Es normal para una parte de los rebotes.
Las visitas multipágina siguen apareciendo como clics separados. El pegado de One click per visit necesita las tres cosas: el interruptor marcado en la tarjeta de la campaña, tracking.js (no kclient) en todas las páginas, y el visitante navegando el sitio de verdad — una entrada desde un anuncio, un marcador u otro sitio arranca un clic nuevo a propósito, así que los clics de pago nunca se pegan. Revisa también la ventana de 30 minutos: tras una pausa larga la página siguiente arranca un clic nuevo.
El replay se ve sin estilos o faltan imágenes. El replay carga imágenes y fuentes de las URLs propias de la landing. Si los archivos de la landing se borraron o reemplazaron después de la visita, las grabaciones viejas no pueden mostrarlos.
Se detuvieron las grabaciones nuevas. Revisa la tarjeta de almacenamiento: si el disco del servidor tiene menos de 1 GB libre, la grabación se pausa hasta que liberes espacio o bajes el límite.
Una grabación muestra LIVE. El visitante sigue en la página. Los lotes llegan cada pocos segundos, así que la grabación sigue creciendo hasta que se va (30 minutos como máximo).
Notas técnicas
- Grabador: rrweb (
@rrweb/record), integrado en/replay.js(≈25 KB gzip). Se carga condefersolo para los clics grabados, y los lotes se comprimen con gzip en el navegador. - Ingesta:
POST /pixel.gif?action=rr. Un lote solo se acepta para un clic que el servidor armó y solo con su firma HMAC. - Almacenamiento: un archivo
.ndjson.gzpor grabación, más las tablassession_replays,replay_clicks(puntos del mapa de calor, se conservan 30 días) yreplay_landing_settings, añadidas por la migración 76. - Sitios orgánicos (v1.8.3, migración 78):
replay_campaign_settings(el interruptor de campaña, el modo de consentimiento, un clic por visita), las columnasentry_url/pagespara sesiones multipágina, puntos de mapa de calor por página y la continuación de visita de la Click API v3 —tracking.jsenvía?_subid=para las páginas del mismo sitio de una visita; el servidor vuelve a comprobar los marcadores de anuncio contra los parámetros del clic recordado. Fuente:core/click_api.php(la rama de continuación),core/SessionReplay.php. - Fuente:
frontend/replay/recorder.js(recompilar connpm run build:replay),frontend/src/components/replay/,tracking.js.
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 →