Activités Bloomreach
Utilisez les scénarios Bloomreach pour créer, mettre à jour et notifier les Cartes Apple Wallet et Google Wallet gérées dans The Wallet Crew.
Les activités Bloomreach sont des étapes de scénario qui appellent les API de The Wallet Crew. Elles transforment une décision CRM (qui/quand/quoi) en une action Wallet (créer, mettre à jour, notifier).
Exemples concrets
Fidélité: un changement de niveau dans Bloomreach met à jour le design et les champs de la Carte.
Offres: une entrée de segment accorde un privilège « VIP Weekend » visible sur la Carte.
Événements: un rappel le jour J déclenche une notification Wallet.
Catalogue des activités
Ces activités sont généralement créées dans Bloomreach comme Préréglage de webhook des intégrations. Chaque activité appelle un endpoint de The Wallet Crew.
L’installation des activités et la configuration de l’authentification HTTP sont couvertes dans Configuration.
Notifier
Notify envoie un message Wallet à une Carte. Sur Apple Wallet, le message est remis sous forme de notification sur l’écran verrouillé. Sur Google Wallet, le message apparaît sur la Carte.
Les notifications Wallet ont un aspect système. Un usage excessif peut nuire à la confiance et aux taux d’opt-in.
Exemples concrets
Commerce de détail: message d’anniversaire : « Joyeux anniversaire ! Profitez de 20 % de réduction aujourd’hui. » L’offre est affichée sur la Carte.
Événements: « Votre événement commence dans 2 heures. Les portes ouvrent à 19 h. » Cela aide à réduire les absences.
Fitness: réengagement : « Vous n’êtes pas venu depuis 2 semaines. » Cela se marie bien avec un avantage.
Appliquer un privilège
Appliquer un privilège associe un avantage à une Carte. Cet avantage peut être un coupon, un droit d’accès ou une prime.
Les privilèges sont des objets de premier plan dans The Wallet Crew. Ils peuvent être affichés sur la Carte et suivis dans le temps.
Appliquer un privilège convient aux avantages ayant un cycle de vie (disponibilité, expiration, utilisation). Pour le concept complet de privilège, voir Privilège.
Exemples concrets
Commerce de détail: privilège « VIP Weekend ». La Carte devient dorée. Le texte indique « 2× points ce week-end ». Notification facultative : « Vous avez été surclassé. »
Fitness: privilège « Bring a friend ». La Carte affiche une entrée invité qui expire dans 7 jours.
Événements: privilège « Fast lane entry » ou « VIP lounge access » pour un sous-ensemble de détenteurs de billets.
Mettre à jour la Carte
La mise à jour de la Carte actualise une Carte afin qu’elle reflète les données les plus récentes. C’est l’activité principale utilisée pour garder la Carte à jour.
Les mises à jour courantes incluent les points, le niveau, le solde, l’expiration, la place, le lieu et les instructions.
Exemples concrets
Fidélité retail: après un achat, mettez à jour la Carte pour que les points, le niveau et la progression vers la prochaine récompense soient corrects.
Événements: changement de place, mise à jour du programme, changement de lieu, instructions d’entrée mises à jour.
Adhésion: renouvellement de l’adhésion, changement de date d’expiration, changements de statut (actif/en pause).
Ajout du mouvement de privilège (avancé)
Le mouvement de privilège met à jour un compteur sur un privilège existant. Cela sert principalement aux cartes de tampon, à la « progression vers la récompense » ou aux packs à entrées multiples.
Cette activité est avancée. Elle nécessite généralement un terminal de point de vente, un scanner ou une application pour émettre des signaux d’acquisition/de dépense.
Exemples concrets
Tampons café: le client achète une boisson → +1 tampon. À 10 tampons, la récompense peut être réclamée.
Packs à entrées multiples: la salle de sport dispose de « 10 entrées ». Chaque enregistrement consomme 1 entrée.
Cadeau d’anniversaire: ajoutez +1 « entrée gratuite » à un privilège de Carte invité. Lorsqu’elle est utilisée, elle redescend.
Créer une Carte (avancé)
Créer une Carte génère une nouvelle Carte et renvoie un lien « Ajouter à Wallet ». C’est utile lorsque Bloomreach est la couche d’orchestration et qu’une Carte n’existe pas encore.
Exemples concrets
Commerce de détail: après l’inscription, créez une Carte de fidélité. Envoyez le lien « Ajouter à Wallet » par e-mail/SMS. Une fois installée, appliquez un privilège « Welcome offer ».
Événements: après l’achat du billet, créez une Carte de billet. Envoyez le lien dans l’e-mail de confirmation. Puis envoyez des rappels avant l’événement.
Adhésion: un nouveau membre rejoint un club. Créez la Carte de membre. Affichez le niveau/le statut et l’expiration sur la Carte.
FAQ
Quelle est la différence entre Mettre à jour la carte et Notify ?
La mise à jour de la Carte modifie ce qui est affiché sur la Carte. Notify est un mécanisme de livraison destiné à attirer l’attention.
Dans la plupart des flux sensibles au temps, la mise à jour de la Carte s’exécute d’abord, puis Notify.
Quand l’application d’un privilège est-elle préférable à la mise à jour de la Carte ?
L’application d’un privilège convient aux avantages ayant un cycle de vie. Les exemples incluent les bons, les droits d’accès et les offres qui expirent.
La mise à jour de la Carte convient aux valeurs d’état. Les exemples incluent les points, le niveau et le solde.
D’où vient l’identifiant de la Carte (passId) dans Bloomreach ?
L’identifiant de la Carte peut être stocké comme propriété client Bloomreach. Il peut aussi être capturé à partir des événements de The Wallet Crew envoyés à Bloomreach.
Quel est le délai attendu pour la mise à jour de la Carte par rapport à Notify ?
Les deux actions sont généralement livrées en quelques secondes. Le délai réel dépend de la connectivité de l’appareil et du comportement d’Apple Wallet par rapport à Google Wallet.
Update Carte déclenche un rafraîchissement de Wallet, puis l’appareil récupère la Carte mise à jour. Notify déclenche l’envoi d’un message Wallet, et peut éventuellement être associé à une mise à jour.
Pour les flux sensibles au temps, un schéma courant effectue d’abord la mise à jour, puis notifie.
Que se passe-t-il si la Carte n’est pas installée ?
L’activité cible toujours un enregistrement de Carte. Si la Carte existe mais n’est installée sur aucun appareil, Update Carte n’a rien à pousser. Notify ne peut pas non plus être délivré sans installation active.
Un schéma typique utilise l’état d’installation comme garde-fou. Si la Carte n’est pas installée, un canal de secours (e-mail ou SMS) envoie à la place un lien « Add to Wallet ».
Mis à jour
Comment tester une activité en toute sécurité dans la préproduction ?
Les tests en préproduction sont plus sûrs lorsque la préproduction et la production sont isolées à la fois au niveau de Bloomreach et de The Wallet Crew. Cela signifie généralement un jeton de projet Bloomreach de préproduction et un environnement The Wallet Crew de préproduction.
Une exécution de test minimale couvre généralement :
une Carte de test pouvant être installée sur un appareil
une action Update Carte qui modifie un champ visible
une action Notify avec un court message
une action Apply privilege qui apparaît sur la Carte
Après chaque exécution, validez le comportement sur l’appareil et les journaux Bloomreach, puis itérez sur la charge utile et le ciblage.