> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/bloomreach/recipes.md).

# Recettes

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](/connectors/fr/marketing-automation/bloomreach/setup.md)
* [Activités Bloomreach](/connectors/fr/marketing-automation/bloomreach/bloomreach-activities.md)
* [Événements](/connectors/fr/marketing-automation/bloomreach/events.md)
* [Les composants de The Wallet Crew](/connectors/fr/marketing-automation/bloomreach/the-wallet-crew-components.md)

### 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](/connectors/fr/marketing-automation/bloomreach/setup.md) 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.

{% hint style="info" %}
**Exemple :**

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

**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.

{% stepper %}
{% step %}

#### 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`.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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 ».
{% endstep %}

{% step %}

#### 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.
{% endstep %}
{% endstepper %}

Référence connexe : [Activités Bloomreach](/connectors/fr/marketing-automation/bloomreach/bloomreach-activities.md).

### 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.

{% hint style="info" %}
**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.
{% endhint %}

**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.

{% stepper %}
{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
  {% endstep %}
  {% endstepper %}

Référence connexe : [Privilège](https://github.com/TheWalletCrew/docs/tree/main/documentation/privilege-and-activation/privilege.md).

### 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.

{% hint style="info" %}
**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.
{% endhint %}

**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é).

{% stepper %}
{% step %}

#### 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](/connectors/fr/marketing-automation/bloomreach/setup.md).
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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).
  {% endstep %}

{% step %}

#### 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.
{% endstep %}
{% endstepper %}

Référence connexe : [Événements](/connectors/fr/marketing-automation/bloomreach/events.md).

### 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.

{% hint style="info" %}
**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.
{% endhint %}

**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.

{% stepper %}
{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}
{% endstepper %}

Référence connexe : [Les composants de The Wallet Crew](/connectors/fr/marketing-automation/bloomreach/the-wallet-crew-components.md).

### 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.

{% hint style="info" %}
**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.
{% endhint %}

**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)**

{% stepper %}
{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}
{% endstepper %}

Référence connexe : [Les composants de The Wallet Crew](/connectors/fr/marketing-automation/bloomreach/the-wallet-crew-components.md).

### 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

<details>

<summary><strong>Quelle est la différence entre Mettre à jour la carte et Notify ?</strong></summary>

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.

</details>

<details>

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

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`.

</details>

<details>

<summary><strong>Comment tester Notify sans perturber les vrais utilisateurs ?</strong></summary>

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.

</details>

<details>

<summary><strong>Comment empêcher Notify si la carte n'est pas installée ?</strong></summary>

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 ».

</details>

<details>

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

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.

</details>

<details>

<summary><strong>Bloomreach peut-il être la source de vérité pour les champs de la carte ?</strong></summary>

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.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/marketing-automation/bloomreach/recipes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.