trackUserActivity

Registra un evento de actividad de un usuario o invitado.

Descripción

Este método registra un único evento de actividad para el usuario autorizado actual o un invitado (por ejemplo, una vista de producto, una búsqueda o una acción en el carrito). Devuelve una Promesa que se resuelve en true si el evento fue registrado, o un objeto IError si hubo un problema.

UserActivity.trackUserActivity(

body*, body.type*, body.productId, body.pageId, body.categoryId, body.query, body.meta

);

Esquema de parámetros

Esquema

body(requerido): ITrackActivity
Cuerpo del evento de actividad. Ejemplo: { type: "product_view", productId: 12345 }

body.type(requerido): TUserActivityType
Tipo de evento de actividad. Uno de: "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".
ejemplo: "product_view"

body.productId: número
Identificador del producto.
ejemplo: 12345

body.pageId: número
Identificador de la página (para page_view, category_view).
ejemplo: 7

body.categoryId: número
Identificador de categoría legado.
ejemplo: 67

body.query: cadena
Consulta de búsqueda (para type=search).
ejemplo: "funda de iphone"

body.meta: Record<string, unknown>
Información meta arbitraria (bloque de origen, variante A/B, profundidad de desplazamiento).

Ejemplos

Ejemplo mínimo

const response = await UserActivity.trackUserActivity({
  type: 'product_view',
  productId: 12345,
});

Ejemplo con atributos

const response = await UserActivity.trackUserActivity({
  type: 'search',
  query: 'iphone case',
  meta: { sourceBlock: 'header_search', variant: 'b' },
});

Ejemplo de respuesta

true

Esquema de respuesta

Esquema: booleano

booleano: boolean
Devuelve true si el evento fue registrado.
ejemplo: true

---