Recettes

Modèles de scénarios pratiques pour exploiter Bloomreach Engagement avec les Cartes Apple Wallet et Google Wallet gérées dans The Wallet Crew.

Cette page rassemble des recettes pratiques pour exploiter l'intégration entre Bloomreach Engagement et The Wallet Crew.

Ces recettes complètent la documentation de référence :

• Configuration
• Activités Bloomreach
• Événements
• Les composants de The Wallet Crew

Comment utiliser ces recettes

Les scénarios Bloomreach définissent le ciblage, le timing et la personnalisation. The Wallet Crew exécute les actions Wallet telles que l'actualisation de carte, l'attachement d'avantage et les notifications Wallet.

L'intégrateur Bloomreach (équipe IT ou partenaire d'implémentation) décide généralement quelles activités inclure et comment mapper les données. Configuration couvre la configuration requise et les notions de mappage des données.

La plupart des équipes valident d'abord une recette de bout en bout en environnement de préproduction. Les recettes sont ensuite combinées en scénarios à plusieurs étapes.

Recettes

Envoyer une notification push Wallet (activité Notify)

Notify envoie un message Wallet à une carte. Apple Wallet peut afficher une notification sur l'écran de verrouillage. Google Wallet affiche le message sur la carte.

Exemple :

Lorsqu'une commande est livrée, une notification confirme que l'expédition est en cours.

Comment c'est généralement mis en œuvre

• Utilisez l'activité Notify dans le scénario. Référencez les attributs du scénario pour construire un message personnalisé.
• Si le message fait référence à du contenu de carte mis à jour, exécutez d'abord Mettre à jour la carte puis Notify.
• Utilisez la segmentation et des plafonds de fréquence. Les messages Wallet ont une allure système et peuvent être perçus comme intrusifs en cas d'usage excessif.

1

Définir le déclencheur et la carte cible

Commencez par sélectionner la condition d'entrée du scénario. La plupart des configurations s'appuient sur un événement de commande, une entrée de segment ou une règle temporelle, selon le moment où la mise à jour de la carte doit avoir lieu.

Ensuite, confirmez que le contexte du scénario inclut un identifiant de carte stable. Cela permet de conserver un ciblage cohérent entre les mises à jour et les appareils. Dans la plupart des implémentations Bloomreach, cet identifiant est stocké comme une propriété client telle que passId.

2

Ajouter l'activité Notify

Dans Bloomreach, ajoutez l'activité Notify du catalogue d'activités The Wallet Crew. Définissez le contenu de la notification, puis personnalisez-le à l'aide des attributs du scénario (par exemple le nom du client ou le numéro de commande). Lorsque le message fait référence au contenu de la carte, assurez-vous que les valeurs sont déjà à jour.

3

Se prémunir contre les cartes non installées

Les messages Wallet nécessitent au moins une installation active. Ajoutez une garde pour que Notify ne s'exécute que lorsque l'installation est confirmée.

Schémas de garde courants :

• Déclencher Notify uniquement après wallet_installed.
• Ajoutez une branche qui vérifie les indicateurs d'installation stockés dans Bloomreach.

S'il n'existe aucune installation active, utilisez un canal de secours (e-mail/SMS) pour diffuser un lien « Ajouter à Wallet ».

4

Valider la livraison sur de vrais appareils

La validation doit couvrir iOS et Android. Elle doit aussi couvrir à la fois les journaux et le comportement sur l'appareil.

Vérifiez les deux :

• Journaux d'activité Bloomreach.
• Comportement sur l'appareil (visibilité de la notification et rendu du message).

Lorsque le message fait référence à des champs mis à jour, validez d'abord la mise à jour.

Référence connexe : Activités Bloomreach.

Accorder un avantage et le refléter sur la carte (activité Apply privilege)

Apply privilege attache un avantage à une carte. Un privilege peut être un coupon, un droit d'accès ou un avantage avec un cycle de vie d'expiration et d'utilisation.

Exemple :

Un privilège « VIP Weekend » est accordé à un segment. La carte affiche l'avantage et peut passer à un style « VIP » tant que le privilège est actif.

Comment c'est généralement mis en œuvre

• Utilisez Appliquer un privilège pour attacher l'avantage à la carte.
• Configurez le modèle de carte pour afficher les privilèges et, le cas échéant, modifier le style en fonction des privilèges actifs.
• Suivez éventuellement avec Notify pour annoncer l'avantage.

1

Créez le modèle de privilège dans The Wallet Crew

Commencez par définir le type de privilège et son cycle de vie. Vérifiez ensuite que le modèle de carte peut afficher les privilèges, soit sous forme de liste, soit sous forme de champs dédiés.

2

Créez le scénario Bloomreach

Sélectionnez un déclencheur qui représente l'éligibilité. Les options typiques incluent l'entrée dans un segment, un changement de niveau ou un jalon d'achat.

3

Appliquer un privilège

Ajoutez Appliquer un privilège, puis définissez à la fois le contenu et les règles du cycle de vie.

• titre et description
• validité et expiration (le cas échéant)
• priorité (lorsque plusieurs avantages peuvent se chevaucher)

Chaque Appliquer un privilège exécution crée un nouveau privilège. processId prend en charge la traçabilité et la corrélation des campagnes. Il ne déduplique pas les privilèges.

Pour mettre à jour ou supprimer un privilège, utilisez son privilegeId. Bloomreach ne conserve pas privilegeId par défaut.

Utilisez une Appliquer un privilège activité par carte et campagne. Définissez une deletionDate systématiquement afin que les privilèges de campagne expirés soient nettoyés automatiquement.

4

Actualiser et annoncer (facultatif)

Si le modèle de carte rend les données de privilège à partir de la charge utile de la carte, ajoutez Mettre à jour la carte ensuite. Si l'avantage nécessite de l'attention, suivez avec Notify. L'ordre est généralement mise à jour d'abord, puis notification.

5

Valider en préproduction

La validation doit couvrir la création, le rendu et le comportement du cycle de vie.

• Le privilège existe dans The Wallet Crew.
• La carte le reflète (champs et visuels).
• Le cycle de rédemption se comporte comme prévu.

Référence connexe : Privilège.

Brancher les scénarios selon le cycle de vie de la carte (The Wallet Crew → événements Bloomreach)

The Wallet Crew transmet les événements Wallet à Bloomreach. Ces événements rendent Wallet mesurable et déclenchable comme point de contact CRM.

Exemple :

Après la création de la carte, un scénario attend wallet_installed. Si l'installation n'a pas lieu dans un délai donné, un e-mail de rappel est déclenché à la place.

Schémas de scénario courants

• Bienvenue uniquement après l'installation: lancez une série d'intégration uniquement après wallet_installed.
• Supprimer les notifications Wallet: n'exécutez pas Notify lorsqu'aucune installation active n'existe.
• Signaux de churn: déclenchez un flux de réactivation après wallet_uninstalled.
• Déclencheurs après visite: déclenchez un suivi après wallet_scanned (lorsque Scan API est connecté).

1

Confirmer le transfert des événements

wallet_created, wallet_installed, wallet_uninstalled, et wallet_scanned doivent être visibles dans Bloomreach. Cela dépend de la configuration du connecteur.

Les étapes de validation se trouvent dans Configuration.

2

Démarrer un scénario sur un événement Wallet

Créez un scénario déclenché par un événement Wallet. Utilisez wallet_installed pour les flux avec confirmation d'installation. Utilisez wallet_uninstalled pour les flux de suppression et de reconquête.

3

Ajouter la déduplication et les fenêtres temporelles

Considérez les événements comme « au moins une fois » et prévoyez les doublons.

Mesures de protection courantes :

• Stockez un attribut firstWalletInstalledAt .
• Utilisez des fenêtres temporelles (exemple : ignorer les installations répétées dans les 24 h).

4

Utiliser les propriétés de l'événement pour la segmentation

Utilisez appareil, registrationSource_medium, et registrationSource_tags pour segmenter l'adoption et mesurer la performance des canaux.

Gardez la gouvernance à l'esprit lorsque vous transmettez des identifiants via les événements.

Référence connexe : Événements.

Créer ou mettre à jour un contact Bloomreach à partir du formulaire d'inscription The Wallet Crew (CustomerFlowElement)

CustomerFlowElement relie les soumissions du formulaire The Wallet Crew à Bloomreach. Il crée ou met à jour un contact Bloomreach lorsqu'un client termine un parcours d'inscription.

Exemple :

Après l'installation d'une carte, un formulaire d'inscription collecte le consentement et les données de profil. La soumission crée ou met à jour le contact Bloomreach, puis un scénario d'intégration Bloomreach démarre.

Comment c'est généralement mis en œuvre

• Activer CustomerFlowElement dans le flux Wallet utilisé pour l'inscription.
• Mapper les champs du formulaire aux attributs de contact Bloomreach.
• Définissez des règles de correspondance (e-mail, téléphone, ID membre, etc.) afin que les contacts soient résolus de manière déterministe.

1

Définir la stratégie de résolution du contact

Commencez par choisir quel identifiant Bloomreach est utilisé pour faire correspondre les contacts. L'e-mail est courant car il est largement disponible dans les modèles de données CRM. Lorsqu'un programme dispose d'un identifiant membre stable, cet identifiant constitue souvent une meilleure clé de correspondance car il évite les problèmes liés aux changements d'e-mail.

2

Configurer le flux du formulaire d'inscription

Ajoutez CustomerFlowElement au flux d'inscription, puis mappez les champs du formulaire aux propriétés de contact Bloomreach. Lorsque la gouvernance exige le consentement, assurez-vous que les champs de consentement sont également collectés et mappés.

3

Tester une soumission réelle

Exécutez une soumission réelle avec une carte de préproduction. Vérifiez ensuite que le contact est créé ou mis à jour dans Bloomreach, et que les identifiants utilisés pour la correspondance restent cohérents lors des soumissions suivantes.

4

Déclencher des scénarios en aval

Déclenchez des scénarios en aval après l'upsert du contact. Un schéma courant ne démarre qu'après wallet_installed, puis utilise la soumission du formulaire comme étape de complétion du profil.

Référence connexe : Les composants de The Wallet Crew.

Afficher les données Bloomreach sur la carte (CarteDataProvider + Mettre à jour la carte)

PassDataProvider récupère les attributs client de Bloomreach et les expose au rendu de la carte. Cela fait de Bloomreach une source de données pour les valeurs affichées sur les cartes Apple Wallet et Google Wallet.

Exemple :

Lorsqu'un attribut de niveau change dans Bloomreach, un scénario s'exécute Mettre à jour la carte afin que la carte affiche immédiatement le nouveau niveau.

Remarque opérationnelle clé

Les données Bloomreach apparaissent sur la carte après une actualisation. Une actualisation peut être déclenchée par Mettre à jour la carte dans un scénario.

Tutoriel (Bloomreach comme source de données de carte)

1

Identifier les champs détenus par Bloomreach

Commencez par les champs de profil stables détenus par Bloomreach, comme le libellé du niveau, les points, le magasin préféré ou les attributs de personnalisation. Conservez les valeurs transactionnelles dans leur système de référence lorsque des contraintes d'exactitude ou d'audit s'appliquent.

2

Configurer CarteDataProvider

Activez CarteDataProvider pour le projet, puis confirmez quelles propriétés Bloomreach sont récupérées. Les conventions de nommage et les règles de mappage doivent être validées tôt pour éviter toute dérive des champs entre les environnements.

3

Afficher les attributs dans le modèle de carte

Référencez dans les champs du modèle les valeurs exposées par CarteDataProvider. Validez ensuite les valeurs rendues sur une carte de préproduction, y compris les valeurs vides et les cas limites.

4

Déclencher des actualisations depuis Bloomreach

Créez un scénario déclenché par des changements de profil et ajoutez Mettre à jour la carte. Lorsque le changement est sensible au temps, suivez avec Notify afin qu'il soit visible sans ouvrir la carte.

Référence connexe : Les composants de The Wallet Crew.

Combiner des recettes en campagnes à plusieurs étapes

Ces recettes sont conçues comme des blocs de construction. En pratique, les scénarios enchaînent souvent la création de carte, l'actualisation de carte, l'attachement d'avantage et la messagerie.

Chaînes courantes :

• Mettre à jour la carte → Notify
• wallet_installed → série d'intégration
• Soumission du formulaire d'inscription → upsert du contact → avantages fondés sur le niveau

FAQ

Quelle est la différence entre Mettre à jour la carte et Notify ?

Mettre à jour la carte modifie ce qui est affiché sur la carte. Notify attire l'attention via un message Wallet.

Lorsque le message fait référence à du contenu mis à jour, le schéma courant exécute d'abord Mettre à jour la carte, puis Notify.

Que se passe-t-il si Notify ou Mettre à jour la carte s'exécute sur une carte qui n'est pas installée ?

L'activité cible toujours un enregistrement de carte, mais il n'existe aucune installation active d'appareil vers laquelle pousser. Notify ne peut pas être livré sans installation active.

Un repli courant utilise l'e-mail pour diffuser un lien « Ajouter à Wallet », puis reprend les actions Wallet après wallet_installed.

Comment tester Notify sans perturber les vrais utilisateurs ?

La plupart des équipes isolent la préproduction aux deux niveaux.

Un jeton de projet Bloomreach de préproduction est utilisé avec un tenant The Wallet Crew de préproduction.

Les tests sont exécutés avec un petit ensemble de cartes de test installées sur des appareils internes.

Comment empêcher Notify si la carte n'est pas installée ?

Utilisez l'état d'installation comme garde.

Les schémas courants consistent à déclencher Notify uniquement après wallet_installed, ou à maintenir un attribut « isInstalled » dans Bloomreach.

Lorsque la garde échoue, utilisez un repli e-mail/SMS pour diffuser un lien « Ajouter à Wallet ».

Le même événement d'installation ou de scan peut-il se produire plusieurs fois ?

Oui. Les installations peuvent se répéter (réinstallation, plusieurs appareils). Les scans peuvent se répéter (plusieurs visites).

La logique de scénario utilise souvent des règles de déduplication basées sur passId et des fenêtres temporelles.

Bloomreach peut-il être la source de vérité pour les champs de la carte ?

Oui, lorsque CarteDataProvider est utilisé pour récupérer des attributs de profil. Les valeurs transactionnelles (commandes, utilisations, soldes) restent souvent détenues par d'autres systèmes.