> 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

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 concrets</strong></summary>

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

</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 endpoint 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="/files/c683d5f0ee5cdfd05f27c67b547000914a1aae1e" alt="Bloomreach activity icon: Notify" width="188"><figcaption></figcaption></figure>

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.

{% hint style="warning" %}
Les notifications Wallet ont un aspect système. Un usage excessif peut nuire à la confiance et aux taux d’opt-in.
{% endhint %}

<details>

<summary><strong>Exemples concrets</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. 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.

</details>

### Appliquer un privilège

<figure><img src="/files/c3fdddf449f2750fddcece7f5bbdbab0ec7aa661" alt="Bloomreach activity icon: Apply privilege" width="188"><figcaption></figcaption></figure>

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](https://github.com/TheWalletCrew/docs/tree/main/documentation/privilege-and-activation/privilege.md).

<details>

<summary><strong>Exemples concrets</strong></summary>

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

</details>

### Mettre à jour la Carte

<figure><img src="/files/30f8cf293e5454deaccfcb359429049b2fe55ca1" alt="Bloomreach activity icon: Update pass" width="188"><figcaption></figcaption></figure>

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.

<details>

<summary><strong>Exemples concrets</strong></summary>

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

</details>

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

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

<details>

<summary><strong>Exemples concrets</strong></summary>

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

</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’une Carte n’existe pas encore.

<details>

<summary><strong>Exemples concrets</strong></summary>

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

</details>

## FAQ

<details>

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

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.

</details>

<details>

<summary><strong>Quand l’application d’un privilège est-elle préférable à la mise à jour de la Carte ?</strong></summary>

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.

</details>

<details>

<summary><strong>D’où vient 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 capturé à partir des événements de The Wallet Crew envoyés à Bloomreach.

</details>

<details>

<summary><strong>Quel est le délai attendu pour la mise à jour de la Carte par rapport à Notify ?</strong></summary>

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.

</details>

<details>

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

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

</details>

<details>

<summary><strong>Comment tester une activité en toute sécurité dans la 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 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.

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