Aller au contenu principal

trackUserActivity

Enregistrer un événement d'activité d'un utilisateur ou d'un invité.

Description​

Cette méthode enregistre un événement d'activité unique pour l'utilisateur autorisé actuel ou l'invité (par exemple, une vue de produit, une recherche ou une action sur le panier). Elle renvoie une Promise qui se résout en true si l'événement a été enregistré, ou un objet IError s'il y a eu un problème.

.trackUserActivity(

);

Schéma des paramètres​

Schéma

body(obligatoire): ITrackActivity
Corps de l'événement d'activité
exemple:

{ type: "product_view", productId: 12345 }

body.type(obligatoire): TUserActivityType
Type de l'événement d'activité.
exemple: "product_view"

body.productId: number
Identifiant du produit.
exemple: 12345

body.pageId: number
Identifiant de la page (pour page_view, category_view).
exemple: 7

body.categoryId: number
Identifiant de catégorie hérité.
exemple: 67

body.query: string
Requête de recherche (pour type=search).
exemple: "iphone case"

body.meta: Record<string, unknown>
Informations méta arbitraires (bloc source, variante A/B, profondeur de défilement).

Exemples​

Exemple minimal​

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

Exemple avec des attributs​

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

Exemple de réponse​

true

Schéma de réponse​

Details

Schéma: boolean boolean: boolean
Renvoie true si l'événement a été enregistré.
exemple: true