Aller au contenu principal

Introduction

Abonnez-vous aux notifications et mises à jour liées aux produits.

🔐 Cette méthode nécessite une autorisation.

Que fait ce module ?

Le module Events vous permet de faire s'abonner les utilisateurs aux notifications de produits - comme recevoir un e-mail lorsqu'un produit est de nouveau en stock, ou une alerte lorsque le prix baisse.

Considérez-le comme un système d'abonnement aux produits - les utilisateurs peuvent s'abonner à des produits spécifiques et recevoir des notifications lorsque quelque chose change.

Explication simple

Imaginez que vous gérez une boutique en ligne et que vous souhaitez tenir les utilisateurs informés des produits :

  • Produit de nouveau en stock - Avertir les utilisateurs qui attendent cet article
  • Baisse de prix - Alerter les utilisateurs qui surveillent ce produit
  • Nouveau produit ajouté - Notifier les abonnés d'une catégorie spécifique
  • Alerte de stock limité - Informer les utilisateurs intéressés avant qu'il ne soit épuisé

Au lieu de suivre manuellement qui veut quoi :

  • Configurez les événements de produit dans le panneau d'administration OneEntry
  • Les utilisateurs s'abonnent aux produits qui les intéressent
  • Notifications automatiques lorsque quelque chose change
  • Gérez tous les abonnements en un seul endroit

Exemple du monde réel :

Sans le module Events (manuel) :
- L'utilisateur veut une alerte de réapprovisionnement → Code de suivi personnalisé
- Le prix du produit baisse → Logique de notification manuelle
- Chaque produit nécessite un traitement séparé

Avec le module Events (automatisé) :
- L'utilisateur s'abonne au produit → Stocké automatiquement
- Produit réapprovisionné → Tous les abonnés notifiés
- Tous les abonnements gérés de manière centralisée

Concepts clés

Qu'est-ce qu'un événement produit ?

Un événement produit est une notification déclenchée par des changements apportés à un produit :

  • Déclencheur - Ce qui arrive au produit (par exemple, "de nouveau en stock")
  • Notification - Ce que reçoivent les abonnés (e-mail, notification push, message socket)
  • Abonnés - Utilisateurs qui se sont inscrits pour les mises à jour de ce produit
  • Modèle - Le contenu du message de notification

Canaux de notification

Trois façons de notifier les abonnés :

CanalDescriptionMeilleur pour
E-mailEnvoyer des messages e-mailAlertes de réapprovisionnement, baisses de prix, bulletins d'information
Notification PushAlertes mobiles/navigateurAlertes urgentes, ventes flash
Socket.IOMessages websocket en temps réelMises à jour d'inventaire en direct, synchronisation instantanée des prix
IntégrationsMessages d'intégrationFlux de travail de notification personnalisés

En savoir plus sur les intégrations

Exemple de flux d'événements

1. L'utilisateur s'abonne à un produit

2. Le statut du produit change (réapprovisionné, changement de prix, etc.)

3. L'événement détecte le changement

4. L'événement envoie des notifications à tous les abonnés

5. Les abonnés reçoivent le message

Ce que vous devez savoir

Déclencheurs d'événements produits courants

Événements produits typiques que vous pourriez configurer :

  • Produit de nouveau en stock
  • Alerte de baisse de prix
  • Alerte de stock faible
  • Produit discontinué
  • Nouvelle variante disponible
  • Offre spéciale sur le produit

En savoir plus sur les déclencheurs d'événements.

Variables de modèle

Utilisez des espaces réservés dans les modèles de notification pour inclure des détails sur le produit comme le nom, le prix et la disponibilité.


Tableau de référence rapide - Méthodes courantes

MéthodeCe qu'elle fait
getAllSubscriptions()Obtenir tous les abonnements de produits
subscribeByMarker()S'abonner à un événement produit par marqueur
unsubscribeByMarker()Se désabonner d'un événement produit par marqueur

Remarque : Les événements sont configurés dans le panneau d'administration OneEntry. Le SDK gère les abonnements - utilisez-le pour abonner/désabonner les utilisateurs des événements produits.


Questions fréquentes (FAQ)

Comment créer ou modifier des événements produits ?

Les événements sont gérés dans le panneau d'administration OneEntry :

  1. Connectez-vous à l'administration OneEntry
  2. Allez dans la section Événements
  3. Créez ou modifiez des événements produits
  4. Configurez les déclencheurs, canaux et modèles
  5. Activez l'événement

Quelle est la différence entre Notification Push et Socket.IO ?

Notification Push - Envoyée à l'appareil (fonctionne même lorsque l'application est fermée)

  • Apparaît dans le centre de notifications
  • L'utilisateur peut appuyer pour ouvrir l'application
  • Meilleur pour : Alertes de réapprovisionnement, baisses de prix

Socket.IO - Message websocket en temps réel (uniquement lorsque l'application est ouverte)

  • Livraison instantanée aux clients connectés
  • Mises à jour en direct sans actualisation
  • Meilleur pour : Affichage d'inventaire en direct, mises à jour de prix en temps réel

Puis-je déclencher manuellement un événement produit depuis mon code ?

Le SDK ne prend pas en charge les déclencheurs manuels. Les événements se déclenchent automatiquement en fonction des déclencheurs configurés dans OneEntry lorsque les données du produit changent.


Puis-je personnaliser les modèles de notification ?

Oui ! Dans le panneau d'administration OneEntry :

  • Modèles d'e-mail HTML
  • Style personnalisé
  • Support multilingue
  • Variables spécifiques au produit

Notes importantes

Convention de nommage des événements

Utilisez des marqueurs clairs et descriptifs pour les événements produits :

Bon marqueurs :
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued

Mauvais marqueurs :
- event1
- notification
- product_event
- test

Meilleures pratiques

  • Utilisez des marqueurs d'événements descriptifs qui incluent "produit"
  • Incluez des détails pertinents sur le produit dans les modèles de notification
  • Localisez les messages d'événements pour différents marchés
  • Gérez les erreurs d'abonnement avec soin
  • Permettez aux utilisateurs de se désabonner facilement

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


Définition du module Events


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


Documentation connexe