# 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 (create, update, notify).

<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-même déclenche une notification Wallet.

</details>

## Catalogue d'activités

Ces activités sont généralement créées dans Bloomreach en tant que **préréglage Webhook** d'intégrations. Chaque activité appelle un point de terminaison de The Wallet Crew.

L'installation de l'activité et la configuration de l'authentification HTTP sont couvertes dans [Configuration](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/marketing-automation/bloomreach/setup).

### Notifier

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FXkcDGnBkRtQC5BGfVwdy%2Fimage.png?alt=media&#x26;token=9eebae9f-c5dc-4f04-9b45-a2ddc5a23ed2" alt="Bloomreach activity icon: Notify" width="188"><figcaption></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 l'impression d'un niveau système. Leur abus 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. L'accès ouvre à 19 h. » Cela aide à réduire les absences.
* **Fitness**: Relance : « Vous n'êtes pas venu depuis 2 semaines. » Cela s'associe bien à un avantage.

</details>

### Appliquer un privilège

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F20VwJ1rCEIzy25bWd0FS%2Fimage.png?alt=media&#x26;token=b6145331-d1c8-4590-b071-4a95c9711569" alt="Bloomreach activity icon: Apply privilege" width="188"><figcaption></figcaption></figure>

Appliquer un privilège attache un avantage à une Carte. Cet avantage peut être un coupon, un droit d'accès ou un bénéfice.

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 ayant un cycle de vie (disponibilité, expiration, rédemption). Pour le concept complet de privilège, voir [Privilège](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/engage-and-animate/privilege-and-activation/privilege).

<details>

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

* **Commerce de détail**: privilège « VIP Weekend ». La Carte devient or. Le texte indique « 2× points ce week-end ». Optionnel : notifier : « 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 « Entrée coupe-file » ou « Accès salon VIP » pour un sous-ensemble de détenteurs de billet.

</details>

### Mettre à jour la Carte

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FngnQR2LCcK9qsGcGWrLU%2Fimage.png?alt=media&#x26;token=fee0accf-e403-46e3-835f-efcf71c993bb" alt="Bloomreach activity icon: Update pass" width="188"><figcaption></figcaption></figure>

Mettre à jour la Carte actualise une Carte pour qu'elle reflète les dernières données. C'est l'activité principale utilisée pour garder la Carte précise.

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é 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 d'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 principalement utilisé pour les cartes à poinçons, la « progression vers une récompense » ou les packs à entrées multiples.

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

<details>

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

* **Timbres de café**: Le client achète une boisson → +1 tampon. À 10 tampons, la récompense devient échangeable.
* **Packs à entrées multiples**: La salle de sport propose « 10 entrées ». Chaque enregistrement consomme 1 entrée.
* **Cadeau d'anniversaire**: Ajouter +1 « entrée gratuite » à un privilège de Carte invité. Lors de la rédemption, elle diminue à nouveau.

</details>

### Créer une Carte (avancé)

Créer une Carte génère une nouvelle Carte et renvoie un lien « Ajouter au 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 d'ajout au Wallet par e-mail/SMS. Une fois installée, appliquez un privilège « Offre de bienvenue ».
* **Événements**: Après l'achat d'un 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 la date d'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 ayant un cycle de vie. Les exemples incluent les bons, les droits d'accès et les offres qui expirent.

Mettre à jour la Carte convient aux valeurs d'état. Les exemples incluent les points, le niveau et le 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é en tant que propriété client Bloomreach. Il peut aussi ê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 vs Notifier ?</strong></summary>

Les deux actions sont généralement délivrées en quelques secondes. Le timing réel dépend de la connectivité de l'appareil et du comportement d'Apple Wallet vs Google Wallet.

Mettre à jour la Carte déclenche une actualisation du 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 à pousser. Notifier ne peut pas non plus être livré sans une installation active.

Un schéma typique utilise le statut 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 au Wallet ».

</details>

<details>

<summary><strong>Comment tester une activité en toute sécurité en staging ?</strong></summary>

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

Un test minimal 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 logs Bloomreach, puis itérez sur la charge utile et le ciblage.

</details>