Aplicaciones (sitios web y apps móviles)
Cómo dar de alta un sitio web o una app móvil en Lymen, qué significa cada campo y cómo elegir qué datos recibir.
En esta página
Para qué sirve#
Observar › Aplicaciones mide la experiencia de las personas que usan tu sitio web o tu app móvil: cuánto tarda en abrir cada pantalla, qué errores ven, qué pedidos al servidor fallan o se demoran, si la app se cierra sola y qué hacen (turnos reservados, pagos, etc.). Se conoce como experiencia de usuarios reales.
Para medirlo se instala un SDK (una librería chica) en el sitio o la app. Esta página explica el alta en el portal; la instalación del SDK está en una página por plataforma:
| Plataforma | Página |
|---|---|
| Web | SDK web |
| Android | SDK Android |
| iOS | SDK iOS |
| React Native | SDK React Native |
Cuándo usarlo#
- Querés saber si tu sitio de turnos o tu app anda lento para tus pacientes o clientes.
- Querés ver errores del navegador o cierres de la app antes de que te los reporten.
- Querés unir un pedido lento del navegador o del celular con la traza de tu servidor (ver Instrumentación).
Alta paso a paso#
Tocá Aplicaciones › Agregar aplicación (o entrá desde Agregar datos › Sitios web y apps). Son tres pasos.
Paso 1: ¿Qué querés medir?#
- Elegí el tipo: Web, Android, iOS o React Native.
- Escribí el Nombre y la dirección o paquete (tabla de campos más abajo).
- Tocá Crear y seguir.
Paso 2: Instalá Lymen#
El portal arma el código listo para copiar, con tu clave. Copialo y seguí las instrucciones de la plataforma: pegarlo en el <head> del sitio, o sumar el SDK al proyecto de la app e iniciarlo. Después publicá o reiniciá la aplicación, y abrila una vez. Tocá Ya lo instalé.
Paso 3: Verificamos que llegue información#
El portal espera el primer dato (suele tardar menos de un minuto). Abrí el sitio en el navegador, o la app en un teléfono, y navegá una pantalla. Cuando llega, ves ¡Llegó el primer dato!.
Campos del alta#
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| Tipo / Plataforma | Qué se mide. | Web | Web, Android, iOS, React Native | No se cambia después de crearlo: el código y los datos dependen de la plataforma. |
| Nombre | Cómo lo ves en la lista. | — | Hasta 80 caracteres, sin <, >, {, }, $ ni \. |
Ninguno. |
| Dirección del sitio (solo Web) | Desde dónde se abre. Lymen solo acepta datos que vengan de estas direcciones. | — | Hasta 20, repetidas no; con https:// y sin ruta ni barra final (https://turnos.clinicax.com). http solo para pruebas en tu propia máquina. |
Seguridad. Una dirección de más permite que otro sitio mande datos con tu clave pública. Una de menos hace que se rechacen los datos de ese sitio. |
| Paquete de la app (Android, iOS) | El identificador de la app en la tienda (applicationId o bundle id). |
— | Hasta 150 caracteres. | Sirve para reconocer la app. |
| Paquete Android y Bundle iOS (React Native) | Los dos identificadores, ambos opcionales. | Vacíos | Hasta 150 caracteres. | Una sola app React Native recibe de Android y de iOS con la misma clave. |
Editar una aplicación#
En la lista, cada aplicación tiene un diálogo de edición con estos campos:
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| Nombre del servicio | Cómo aparece en Servicios y en Trazas. | — | Letras, números, punto, guion y guion bajo, hasta 100 (por ejemplo web-turnos). |
Cambia cómo la encontrás en otras pantallas. Evitá cambiarlo si ya armaste reglas o dashboards con ese nombre. |
| Qué parte de las visitas se mide | Muestreo: porcentaje de sesiones que se miden. | 100 % | De 1 a 100 % | Costo y visibilidad. Con 100 % se mide cada visita. Con mucho tráfico, 25 % alcanza para ver tendencias y baja el costo; pero un error poco frecuente puede no aparecer. La decisión se toma al empezar cada sesión: una sesión entra completa o no entra. Lo que pongas acá manda sobre lo que escribas en el SDK. |
| Unir con lo que pasa en tu servidor | Direcciones de tus APIs a las que se les manda la marca que une el pedido del navegador o la app con la traza del servidor. | Vacío | Hasta 20, con el mismo formato que las direcciones del sitio. | Solo a estas direcciones se les agrega la marca. Tus APIs tienen que aceptarla (CORS en web). Se suma a lo que pongas en el SDK. |
| Registrar los clics | Guarda qué botón o enlace se tocó. | Apagado | Encendido / apagado | Privacidad. Se guarda un identificador del elemento (nunca el texto ni lo escrito). Ayuda a entender qué hizo la persona antes de un error. |
| Recibir datos | Pausa o activa la aplicación. | Encendido | Encendido / apagado | Pausada, Lymen no acepta datos de esta aplicación aunque tenga el código puesto. |
| Eliminar | Borra la aplicación. | — | — | Deja de aceptar datos con su clave; lo ya guardado vence solo. Si la volvés a agregar, tiene una clave nueva: hay que actualizar el SDK. |
La clave pública (ly_pub_…) se genera en Lymen, no se puede cambiar, y no es un secreto: va dentro del sitio o la app. Por eso Lymen controla el origen (web) y podés pausar o eliminar la aplicación si hace falta.
Qué datos recibir#
En el detalle de una aplicación, la tabla Qué datos recibimos tiene un interruptor Recibir por tipo de dato. Lo que está apagado no sale del navegador ni del celular.
| Tipo de dato | Qué incluye | Por defecto |
|---|---|---|
| Visitas a páginas (en móvil: Pantallas vistas) | Cada vez que alguien abre una pantalla. | Encendido |
| Tiempos de carga (móvil: Tiempos de inicio) | Qué tan rápido abre cada página o la app. | Encendido |
| Errores de la página (móvil: Errores y cierres de la app) | Cuando algo se rompe. | Encendido |
| Pedidos al servidor | Las consultas que hace la página o la app al sistema. Con esto apagado tampoco se agrega la marca de unión con el servidor. | Encendido |
| Clics y acciones | Botones tocados (también requiere Registrar los clics). | Encendido |
| Sesiones | Cuántas personas usan el sitio y por cuánto tiempo. | Encendido |
| Mensajes de la app (logs) | Textos que la app escribe para diagnosticar. | Apagado |
Apagar un tipo reduce el volumen (costo) y la exposición de datos; encender los mensajes puede traer texto con datos personales, aunque pasen por las reglas de Privacidad. Los eventos de negocio (por ejemplo turno.reservado) siempre se mandan.
Estados de una aplicación en la lista: Recibiendo datos, Con errores y Sin datos todavía.
Privacidad#
- Las reglas de Privacidad se aplican en el dispositivo y otra vez al recibir.
- Nunca se captura lo que la gente escribe en formularios y no se graban sesiones.
- El identificador de usuario que mandes sale hasheado (SHA-256), nunca en claro.
- Si el SDK no logra bajar las reglas, usa reglas de respaldo: DNI, email, tarjetas (solo si el número es válido) y CUIT/CUIL.
Las reglas se editan en Configuración › Privacidad.
Problemas comunes#
| Síntoma | Qué hacer |
|---|---|
| Quedó "Esperando el primer dato" | ¿Publicaste o reiniciaste? ¿Abriste el sitio o la app? Revisá que la clave sea la correcta y que la aplicación esté con Recibir datos encendido. |
| En web, no llegan datos y en la consola del navegador hay errores de origen | El sitio se abre desde una dirección que no está en la lista. Agregala (con https:// y sin barra final). |
| No se unen las trazas del navegador con las del servidor | Agregá la dirección de tu API en Unir con lo que pasa en tu servidor y permití la marca en el CORS de tu API. |
| Veo menos visitas que en otra herramienta | Revisá el muestreo: 100 % mide todo. |
| Cambié la clave y dejó de andar | Al eliminar y volver a crear la aplicación, la clave cambia. Actualizala en el SDK. |