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.

Los eventos que envías alimentan el motor de recomendaciones de OneEntry, que potencia bloques de personalización como recomendaciones personales, vistas recientes, compra repetida y tendencias.

🚀 Inicio Rápido​

Inicializa el módulo desde defineOneEntry:


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

Registra un evento de vista de producto (funciona para un usuario autorizado o un invitado):

// Track that the visitor opened a product page.
const ok = await UserActivity.trackUserActivity({
  type: "product_view",
  productId: 12345,
  meta: { sourceBlock: "catalog" },
});

console.log(ok); // true on success

trackUserActivity() toma un único objeto en el cuerpo y se resuelve en true al tener éxito. Es un proceso de "disparar y olvidar" — no bloquees el renderizado por ello.

✨ 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 campo que coincide con la acción: incluye productId para eventos de productos, pageId para vistas de páginas/categorías, 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 al tener é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 el renderizado 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.

🔗 Documentación Relacionada​