> 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/bloomreach-activities.md).

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

<details>

<summary><strong>Exemples réels</strong></summary>

* **Fidélité**: un changement de niveau dans Bloomreach met à jour le design de la carte et ses champs.
* **Offres**: une entrée de segment accorde un privilège « VIP Weekend » visible sur la carte.
* **Événements**: un rappel du jour J déclenche une notification Wallet.

</details>

## 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 seul point de terminaison de The Wallet Crew.

L’installation des activités et la configuration de l’authentification HTTP sont couvertes dans [Configuration](/connectors/fr/marketing-automation/bloomreach/setup.md).

### Notifier

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-d859e669434945910ba0ae9f246c87a021ea8eb3%2Fdocumentation-bloomreach-notify%20(1).png?alt=media" alt="Bloomreach activity icon: Notify" width="188"><figcaption><p>Icône à utiliser lors de l’installation de l’activité Notifier dans Bloomreach.</p></figcaption></figure>

Notifier envoie un message Wallet à une carte. Sur Apple Wallet, le message est délivré sous forme de notification sur l’écran de verrouillage. Sur Google Wallet, le message apparaît sur la carte.

{% hint style="warning" %}
Les notifications Wallet donnent une impression de niveau système. L’abus peut nuire à la confiance et aux taux d’adhésion.
{% endhint %}

<details>

<summary><strong>Exemples réels</strong></summary>

* **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. L’ouverture des portes est à 19 h. » Cela aide à réduire les absences.
* **Fitness**: Réactivation : « Vous n’êtes pas venu depuis 2 semaines. » Cela se combine bien avec un avantage.

</details>

### Appliquer un privilège

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-73868795c9de7196559f27ac56f510eff1b44ca2%2Fdocumentation-bloomreach-apply-privilege.png?alt=media" alt="Bloomreach activity icon: Apply privilege" width="188"><figcaption><p>Icône à utiliser lors de l’installation de l’activité Appliquer un privilège dans Bloomreach.</p></figcaption></figure>

Appliquer un privilège associe un avantage à une carte. Cet avantage peut être un coupon, un droit d’accès ou un privilège.

Les privilèges sont des objets de première classe dans The Wallet Crew. Ils peuvent être affichés sur la carte et suivis dans le temps.

Appliquer un privilège convient aux avantages avec un cycle de vie (disponibilité, expiration, utilisation). Pour le concept complet de privilège, voir [Privilège](/guides-animation/fr/engager-and-animer/privilege-and-activation/privilege.md).

<details>

<summary><strong>Exemples réels</strong></summary>

* **Commerce de détail**: privilège « VIP Weekend ». La carte devient dorée. Le texte indique « 2× points ce week-end ». Notification optionnelle : « Vous avez été surclassé. »
* **Fitness**: privilège « Amène un ami ». La carte affiche une entrée invité qui expire dans 7 jours.
* **Événements**: privilège « entrée rapide » ou « accès au salon VIP » pour une partie des détenteurs de billets.

</details>

### Mettre à jour la carte

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-b530369aa00a8d308d32bade799037acbf8024ca%2Fdocumentation-bloomreach-update-pass.png?alt=media" alt="Bloomreach activity icon: Update pass" width="188"><figcaption><p>Icône à utiliser lors de l’installation de l’activité Mettre à jour la carte dans Bloomreach.</p></figcaption></figure>

Mettre à jour la carte actualise une carte pour qu’elle reflète les données les plus récentes. C’est l’activité principale utilisée pour maintenir la carte à jour.

Les mises à jour typiques incluent les points, le niveau, le solde, l’expiration, le siège, le lieu et les instructions.

<details>

<summary><strong>Exemples réels</strong></summary>

* **Fidélité retail**: après un achat, mettez à jour la carte afin que les points, le niveau et la progression vers la prochaine récompense soient corrects.
* **Événements**: changement de siège, mise à jour de l’horaire, 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).

</details>

### Ajouter un mouvement de privilège (avancé)

Le mouvement de privilège met à jour un compteur sur un privilège existant. Il est surtout utilisé pour les cartes à tampons, la « progression vers la récompense » ou les packs multi-entrées.

{% hint style="warning" %}
Cette activité est avancée. Elle nécessite généralement un POS, un lecteur de codes-barres ou une application pour émettre des signaux de gain/dépense.
{% endhint %}

<details>

<summary><strong>Exemples réels</strong></summary>

* **Tampons café**: le client achète une boisson → +1 tampon. À 10 tampons, la récompense devient échangeable.
* **Lots multi-entrées**: la salle de sport propose « 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.

</details>

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

<details>

<summary><strong>Exemples réels</strong></summary>

* **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 « Offre de bienvenue ».
* **É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.

</details>

## FAQ

<details>

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

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.

</details>

<details>

<summary><strong>Quand Appliquer un privilège est-il préférable à Mettre à jour la carte ?</strong></summary>

Appliquer un privilège convient aux avantages avec un cycle de vie. Exemples : bons, droits d’accès et offres qui expirent.

Mettre à jour la carte convient aux valeurs d’état. Exemples : points, niveau et solde.

</details>

<details>

<summary><strong>D’où provient l’identifiant de la carte (passId) dans Bloomreach ?</strong></summary>

L’identifiant de la carte peut être stocké comme propriété client Bloomreach. Il peut aussi être récupéré à partir des événements de The Wallet Crew envoyés à Bloomreach.

</details>

<details>

<summary><strong>Quel est le délai attendu pour Mettre à jour la carte par rapport à Notifier ?</strong></summary>

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 une actualisation Wallet, puis l’appareil récupère la carte mise à jour. Notifier déclenche la livraison d’un message Wallet et peut éventuellement être associé à une mise à jour.

Pour les flux sensibles au temps, un schéma courant consiste à mettre à jour d’abord, puis à notifier.

</details>

<details>

<summary><strong>Que se passe-t-il si la carte n’est pas installée ?</strong></summary>

L’activité cible tout de 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 à 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 ».

</details>

<details>

<summary><strong>Comment tester une activité en toute sécurité sur un environnement de préproduction ?</strong></summary>

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

</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.