Activités Bloomreach
Utilisez des scénarios Bloomreach pour créer, mettre à jour et notifier des 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 de carte (créer, mettre à jour, notifier).
Exemples concrets
Fidélité: un changement de niveau dans Bloomreach met à jour la conception et les champs de la carte.
Offres: l’entrée d’un segment accorde un privilège « VIP Weekend » visible sur la carte.
Événements: un rappel le jour J déclenche une notification Wallet.
Catalogue d’activités
Ces activités sont généralement créées dans Bloomreach sous forme de intégrations prédéfinies Webhook . Chaque activité appelle un endpoint The Wallet Crew.
L’installation de l’activité et la configuration de l’authentification HTTP sont abordées dans Configuration.
Notifier

Notifier envoie un message Wallet à une carte. Sur Apple Wallet, le message est remis sous forme de notification sur l’écran de verrouillage. Sur Google Wallet, le message apparaît sur la carte.
Les notifications Wallet donnent une impression de niveau 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 s’affiche sur la carte.
Événements: « Votre événement commence dans 2 heures. L’ouverture des portes est à 19 h. » Cela aide à réduire les absences.
Fitness: Réengagement : « Vous n’êtes pas venu depuis 2 semaines. » Cela se combine bien avec un avantage.
Appliquer un privilège

Appliquer un privilège attache un avantage à une carte. Cet avantage peut être un coupon, un droit d’accès ou un avantage.
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.
Un privilège peut aussi inclure des images, comme un visuel principal pour l’avantage. Lorsque le privilège est appliqué depuis Bloomreach, cette image est configurée dans la charge utile de l’activité Bloomreach.
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é. »
Campagne de vente au détail: privilège « Private Sale ». La carte est mise à jour avec une image vedette de campagne configurée dans Bloomreach, ainsi qu’un titre et des dates de validité.
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

Mettre à jour 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 maintenir la carte exacte.
Les mises à jour typiques incluent les points, le niveau, le solde, l’expiration, le siège, 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 siège, mise à jour du planning, changement de lieu, instructions d’entrée mises à jour.
Adhésion: renouvellement d’adhésion, changement de date d’expiration, changements de statut (actif/en pause).
Ajouter un mouvement de privilège (avancé)
Le mouvement de privilège met à jour un compteur sur un privilège existant. Il est בעיקר utilisé pour les cartes à poinçons, la « progression vers une récompense » ou les packs à entrées multiples.
Cette activité est avancée. Elle nécessite généralement qu’un POS, un scanner ou une application émette des signaux d’acquisition/consommation.
Exemples concrets
Tampons café: le client achète une boisson → +1 tampon. À 10 tampons, la récompense devient échangeable.
Packs à entrées multiples: la salle de sport a « 10 entrées ». Chaque enregistrement consomme 1 entrée.
Cadeau d’anniversaire: ajoutez +1 « entrée gratuite » à un privilège de carte invité. Lorsqu’il est utilisé, le compteur 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’aucune carte n’existe encore.
Exemples concrets
Commerce de détail: après l’inscription, créez une carte de fidélité. Envoyez le lien d’ajout à 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 d’adhésion. Affichez le niveau/statut et l’expiration sur la carte.
FAQ
Quelle est la différence entre Mettre à jour la carte et Notifier ?
Mettre à jour la carte modifie ce qui est affiché sur la carte. Notifier est un mécanisme de diffusion destiné à attirer l’attention.
Dans la plupart des flux sensibles au temps, Mettre à jour la carte s’exécute d’abord, puis Notifier.
Quand Appliquer un privilège est-il préférable à Mettre à jour la carte ?
Appliquer un privilège convient aux avantages ayant un cycle de vie. Exemples : bons d’achat, droits d’accès et offres qui expirent.
Mettre à jour la carte convient aux valeurs d’état. Exemples : points, niveau et solde.
D’où vient l’identifiant de carte (passId) dans Bloomreach ?
L’identifiant de carte peut être stocké comme propriété client Bloomreach. Il peut aussi être capturé à partir des événements The Wallet Crew envoyés à Bloomreach.
Quel est le délai attendu pour Mettre à jour la carte par rapport à Notifier ?
Les deux actions sont généralement livrées en quelques secondes. Le timing réel dépend de la connectivité de l’appareil et du comportement d’Apple Wallet par rapport à Google Wallet.
Mettre à jour la carte déclenche un rafraîchissement Wallet, puis l’appareil récupère la carte mise à jour. Notifier déclenche la remise d’un message Wallet et peut éventuellement être associé à une mise à jour.
Pour les flux sensibles au temps, une pratique courante consiste à mettre à jour d’abord, puis à notifier.
Que se passe-t-il si la carte n’est pas installée ?
L’activité cible quand même un enregistrement de carte. Si la carte existe mais n’est installée sur aucun appareil, Mettre à jour la carte n’a rien vers quoi pousser. Notifier ne peut pas non plus être livré sans installation active.
Un schéma courant utilise l’état d’installation comme garde-fou. Si la carte n’est pas installée, un canal de secours (e-mail ou SMS) distribue à la place un lien « Ajouter à Wallet ».
Mis à jour


Comment tester une activité en toute sécurité dans l’environnement de staging ?
Les tests de staging sont plus sûrs lorsque staging et production sont isolés à la fois au niveau de Bloomreach et de The Wallet Crew. Cela signifie généralement un token de projet Bloomreach de staging et un environnement The Wallet Crew de staging.
Une exécution de test minimale couvre généralement :
une carte de test pouvant être installée sur un appareil
une action Mettre à jour la carte qui modifie un champ visible
une action Notifier avec un message court
une action Appliquer un privilège 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.