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.

Considérez-le comme le signal d'analyse derrière la personnalisation - les événements que vous envoyez alimentent le moteur de recommandation de OneEntry, qui alimente des blocs comme recommandations personnelles, récemment consultés, achat répété et tendances.

📖 Explication Simple​

Chaque fois qu'un visiteur fait quelque chose de significatif, vous enregistrez un événement :

  • 👀 Vue de produit - le visiteur a ouvert une page de produit
  • 📄 Vue de page / catégorie - le visiteur a parcouru une page ou une catégorie
  • 🔎 Recherche - le visiteur a recherché quelque chose
  • 🛒 Actions sur le panier / liste de souhaits - articles ajoutés ou retirés
  • 💰 Achat - le visiteur a acheté un produit
  • ⭐ Évaluation - le visiteur a évalué un produit

OneEntry utilise ce flux d'événements pour comprendre chaque visiteur et personnaliser ce qu'il voit.

✨ 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 l'événement 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() renvoie true en cas de succès - c'est un appel sans attente et ne doit pas bloquer l'interface utilisateur.

📊 Tableau de Référence Rapide​

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

❓ Questions Fréquemment Posées (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 lors de 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.

Définition du module UserActivity​


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

🔗 Documentation Connexe​