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*

);

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.
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: "iphone case"

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

Details

Esquema: boolean

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

---