Aller au contenu principal

Introduction

Enregistrez ce que vos utilisateurs et invités font, et transformez-le en expériences personnalisées.

Plus d'informations sur l'interface utilisateur du module https://doc.oneentry.cloud/docs/category/useractivity

🎯 Que fait ce module ?​

Le module UserActivity vous permet de suivre les événements d'activité pour l'utilisateur ou l'invité actuel - vues de produits, vues de pages, recherches, actions sur le panier et la liste de souhaits, achats et évaluations.

Les événements que vous envoyez alimentent le moteur de recommandation de OneEntry, qui alimente des blocs de personnalisation tels que recommandations personnelles, récemment consultés, achat répété et tendances.

🚀 Démarrage rapide​

Initialisez le module depuis defineOneEntry :


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

Enregistrez un événement de vue de produit (fonctionne pour un utilisateur autorisé ou un invité) :

// 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() prend un seul objet de corps et se résout en true en cas de succès. C'est un appel asynchrone — ne bloquez pas le rendu dessus.

✨ Concepts clés​

Fonctionne pour les utilisateurs et les invités​

L'activité est liée au contexte actuel : un utilisateur autorisé (via le module AuthProvider) ou un invité. Pour les invités, le SDK envoie un en-tête x-guest-id afin que les événements soient attribués au bon visiteur anonyme. Consultez Mode invité pour plus de détails.

Types d'événements​

Le type d'événement est l'un d'un ensemble fixe de valeurs : 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.

📋 Ce que vous devez savoir​

  • Envoyez le champ qui correspond à l'action : incluez productId pour les événements de produit, pageId pour les vues de page/catégorie, et query pour les recherches.
  • Le champ meta accepte des données arbitraires (bloc source, variante A/B, profondeur de défilement) pour vos propres analyses.
  • trackUserActivity() se résout en true en cas de succès - c'est un appel asynchrone et ne doit pas bloquer l'interface utilisateur.

📊 Tableau de référence rapide​

MéthodeDescription
trackUserActivity()Enregistrez un événement d'activité d'un utilisateur ou d'un invité

❓ Questions fréquentes (FAQ)​

Dois-je autoriser l'utilisateur pour suivre l'activité ?​

Non. L'activité est enregistrée pour le contexte actuel - un utilisateur autorisé ou un invité. Dans le navigateur, le SDK génère et conserve automatiquement un identifiant d'invité ; sur le serveur, passez un guestId par visiteur.

À quoi sert le champ meta ?​

meta est un objet libre pour toute information supplémentaire que vous souhaitez attacher à un événement, comme le bloc source, une variante de test A/B ou la profondeur de défilement.

🎓 Meilleures pratiques​

  • Suivez les événements au fur et à mesure qu'ils se produisent, mais ne bloquez pas le rendu sur l'appel réseau.
  • Envoyez productId / pageId / query qui correspondent au type d'événement.
  • Gardez les identifiants d'invité stables afin que l'activité d'un invité soit cohérente à travers les requêtes.

🔗 Documentation connexe​