# 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 la conception 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 sous forme de **Préréglage de webhook** intégrations. Chaque activité appelle un point de terminaison The Wallet Crew.

L'installation de l'activité et la configuration de l'authentification HTTP sont abordées 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>

Notifier envoie un message Wallet à une Carte. Sur Apple Wallet, le message est livré sous forme de notification sur l'écran verrouillé. Sur Google Wallet, le message apparaît sur la Carte.

{% hint style="warning" %}
Les notifications Wallet donnent une impression de niveau système. Un usage excessif peut nuire à la confiance et aux taux d'adhésion.
{% 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 le 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 un avantage.

Les privilèges sont des objets de premier ordre 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/blob/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 « Amenez un ami ». La Carte affiche une entrée invité qui expire dans 7 jours.
* **Événements**: privilège d'« accès file rapide » ou d'« accès au salon VIP » 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>

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

* **Fidélité en magasin**: 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 de l'adhésion, changement de date d'expiration, changements de statut (actif/en pause).

</details>

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

Le mouvement de privilège met à jour un compteur sur un privilège existant. Cela sert principalement 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 terminal de point de vente, un scanner ou une application pour émettre des signaux de gain/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 devient échangeable.
* **Packs multi-entrées**: 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 « Add to 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 « 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 de membre. 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 Notify ?</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 ayant un cycle de vie. Par exemple : bons, droits d'accès et offres à expiration.

Mettre à jour la Carte convient aux valeurs d'état. Par exemple : points, niveau et solde.

</details>

<details>

<summary><strong>D'où provient l'identifiant de Carte (passId) dans Bloomreach ?</strong></summary>

L'identifiant de Carte peut être stocké comme propriété client Bloomreach. Il peut également être capturé à partir des événements 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 exécuté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.

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 met d'abord à 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, 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 le statut d'installation comme garde. Si la Carte n'est pas installée, un canal de repli (e-mail ou SMS) distribue à la place un lien « Add to Wallet ».

</details>

<details>

<summary><strong>Comment tester une activité en toute sécurité dans l'environnement de staging ?</strong></summary>

Les tests en staging sont plus sûrs lorsque le staging et la production sont isolés à la fois chez Bloomreach et chez The Wallet Crew. Cela signifie généralement un jeton de projet Bloomreach de staging et un environnement de staging The Wallet Crew.

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 bref message
* 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.