Sesiones
El módulo de Sesiones proporciona funcionalidad para rastrear y analizar las interacciones de los usuarios, respetando la privacidad y optimizando el rendimiento.
Visión general
El Rastreador de Sesiones te permite capturar y analizar las interacciones de los usuarios con tu aplicación, ayudándote a comprender su comportamiento e identificar posibles problemas.
Uso básico
import { SessionTracker } from '@your-sdk/core';
// Inicializar el rastreador
const sessionTracker = new SessionTracker();
// Comenzar a grabar una sesión
sessionTracker.start();
// Añadir etiquetas personalizadas para eventos importantes
sessionTracker.addTag('pageView', { page: 'checkout' });
// Detener la grabación cuando hayas terminado
sessionTracker.stop();Características principales
Seguimiento de eventos
- Captura interacciones y navegación de usuarios
- Registra eventos y etiquetas personalizadas
- Optimizado para rendimiento con muestreo inteligente
Protección de privacidad
- Enmascara automáticamente información sensible
- Respeta atributos
data-sensitive - Omite elementos con clase
pt-ignore - Bloquea elementos con clase
pt-block
Optimización de rendimiento
- Recolección de datos eficiente con muestreo configurable
- Buffer inteligente para minimizar el uso de memoria
- Intervalos de recolección de eventos configurables
Métodos
start(): void
Inicia la grabación de la sesión. No requiere parámetros.
stop(): void
Detiene la sesión de grabación actual.
addTag(tipo: string, datos?: Record<string, any>): void
Añade una etiqueta personalizada a la sesión actual.
addErrorTag(error: TrackedError): void
Añade un evento de error a la sesión.
addRageClickTag(contador: number): void
Marca un evento de clic repetitivo en la sesión.
addConversionTag(paso: string): void
Registra pasos de conversión en la sesión.
isRecording(): boolean
Devuelve true si hay una sesión siendo grabada actualmente.
Mejores prácticas
- Inicialización temprana: Inicia el rastreador lo antes posible en el ciclo de vida de tu aplicación.
- Etiqueta eventos importantes: Usa
addTag()para marcar acciones significativas del usuario. - Manejo de errores: Implementa etiquetado de errores para rastrear y analizar problemas.
- Respeta la privacidad: Usa las clases proporcionadas para excluir o enmascarar información sensible.
- Limpieza: Siempre llama a
stop()cuando termine la sesión para liberar recursos.
Configuración
Puedes personalizar el comportamiento del rastreador de sesiones pasando un objeto de configuración al inicializarlo. Consulta la Guía de Configuración para más detalles.
Solución de problemas
Si encuentras algún problema con el seguimiento de sesiones, consulta la Guía de Solución de Problemas o contacta al soporte.
Nota: Todos los datos de sesión se recopilan y procesan de acuerdo con nuestra política de privacidad y las regulaciones de protección de datos.