Saltar al contenido principal

Introducción

Registra lo que hacen tus usuarios e invitados, y conviértelo en experiencias personalizadas.

Más información sobre la interfaz de usuario del módulo https://doc.oneentry.cloud/docs/category/useractivity

🎯 ¿Qué hace este módulo?​

El módulo UserActivity te permite rastrear eventos de actividad para el usuario o invitado actual: vistas de productos, vistas de páginas, búsquedas, acciones en el carrito y lista de deseos, compras y calificaciones.

Piénsalo como la señal analítica detrás de la personalización - los eventos que envías alimentan el motor de recomendaciones de OneEntry, que potencia bloques como recomendaciones personales, vistas recientes, compra repetida y tendencias.

📖 Explicación Simple​

Cada vez que un visitante hace algo significativo, registras un evento:

  • 👀 Vista de producto - el visitante abrió una página de producto
  • 📄 Vista de página / categoría - el visitante navegó por una página o categoría
  • 🔎 Búsqueda - el visitante buscó algo
  • 🛒 Acciones en carrito / lista de deseos - artículos añadidos o eliminados
  • 💰 Compra - el visitante compró un producto
  • ⭐ Calificación - el visitante calificó un producto

OneEntry utiliza este flujo de eventos para entender a cada visitante y personalizar lo que ven.

✨ Conceptos Clave​

Funciona para usuarios e invitados​

La actividad está vinculada al contexto actual: un usuario autorizado (a través del módulo AuthProvider) o un invitado. Para los invitados, el SDK envía un encabezado x-guest-id para que los eventos se atribuyan al visitante anónimo correcto. Consulta Modo invitado para más detalles.

Tipos de eventos​

El tipo de evento es uno de un conjunto fijo de valores: product_view, page_view, category_view, search, product_add_to_cart, product_remove_from_cart, product_add_to_wishlist, product_remove_from_wishlist, product_purchase, product_rating.

📋 Lo Que Necesitas Saber​

  • Envía el evento que coincida con la acción: incluye productId para eventos de producto, pageId para vistas de página/categoría, y query para búsquedas.
  • El campo meta acepta datos arbitrarios (bloque de origen, variante A/B, profundidad de desplazamiento) para tus propias analíticas.
  • trackUserActivity() se resuelve en true en caso de éxito - es un proceso de "disparar y olvidar" y no debe bloquear la interfaz de usuario.

📊 Tabla de Referencia Rápida​

MétodoDescripción
trackUserActivity()Registra un evento de actividad de un usuario o invitado

❓ Preguntas Comunes (FAQ)​

¿Necesito autorizar al usuario para rastrear la actividad?​

No. La actividad se registra para el contexto actual - un usuario autorizado o un invitado. En el navegador, el SDK genera y persiste un id de invitado automáticamente; en el servidor, pasa un guestId por visitante.

¿Para qué sirve el campo meta?​

meta es un objeto de forma libre para cualquier información extra que desees adjuntar a un evento, como el bloque de origen, una variante de prueba A/B, o la profundidad de desplazamiento.

🎓 Mejores Prácticas​

  • Rastrear eventos a medida que ocurren, pero no bloquees la representación en la llamada de red.
  • Envía productId / pageId / query que coincida con el tipo de evento.
  • Mantén los ids de invitados estables para que la actividad de un invitado sea consistente a través de las solicitudes.

Definición del módulo UserActivity​


const { UserActivity } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 Documentación Relacionada​