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

# Événements

Événements envoyés depuis The Wallet Crew vers Bloomreach pour la segmentation, l’automatisation et la mesure.

The Wallet Crew émet des événements vers Bloomreach afin que les scénarios puissent réagir au comportement du Wallet. Cela fait de la carte Wallet un point de contact CRM mesurable.

<details>

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

* **Intégration**: lorsqu'une Carte est installée, déclencher une série de bienvenue.
* **Réactivation**: lorsqu'une Carte est désinstallée, déclencher un léger flux de réactivation.
* **En magasin**: lorsqu'une Carte est scannée, déclencher une enquête post-visite ou une récompense.

</details>

### Liste des événements

Les événements sont suivis dans Bloomreach avec les noms d'événements suivants :

* `wallet_created`
* `wallet_installed`
* `wallet_uninstalled`
* `wallet_scanned`

### Modèle de données des événements

Les événements sont envoyés sous forme de propriétés clé/valeur plates. Deux préfixes de noms de propriétés sont des modèles :

* `identifier_xxx`: une propriété par identifiant de carte (email, memberId, etc.).
* `metadata_xxx`: une propriété par clé de métadonnées stockée sur la Carte.

Lorsqu'une clé source contient `.`, elle est normalisée en `_`. Exemple : clé d'identifiant `y2.customerId` devient `identifier_y2_customerId`.

### Définitions des événements

<details>

<summary><strong>Carte:Créée</strong></summary>

Se déclenche lorsque The Wallet Crew génère une nouvelle Carte. C'est surtout utile pour l'audit et les flux « créée mais non installée ».

**Nom de l'événement Bloomreach :** `wallet_created`

**Propriétés :**

* `passId`: identifiant de Carte de The Wallet Crew.
* `passKind`: catégorie de Carte de haut niveau (`customerCard`, `eventTicket`, `giftCard`, `offer`, `generic`).
* `passType`: identifiant du modèle utilisé pour créer la Carte.
* `identifier_xxx`: Tous les identifiants présents sur la Carte.
* `metadata_xxx`: Toutes les clés de métadonnées présentes sur la Carte.

</details>

<details>

<summary><strong>Carte:Installée</strong></summary>

Se déclenche lorsqu'un client ajoute une Carte à Apple Wallet ou Google Wallet. Il peut se déclencher plusieurs fois pour la même Carte (réinstallation, plusieurs appareils).

**Nom de l'événement Bloomreach :** `wallet_installed`

**Propriétés :**

* `passId`
* `passKind`
* `passType`
* `identifier_xxx`
* `metadata_xxx`
* `device`: `apple` ou `google`.
* `registrationInformation_totalRegistrationCount`: nombre total d'installations à vie, après cette installation.
* `registrationInformation_activeRegistrationCount`: installations actives, après cette installation.
* `registrationSource_medium`: canal de suivi (email, sms, qr, in\_app, ...).
* `registrationSource_tags`: balises de suivi capturées lors de l'installation.
* `registrationSource_userAgent`: agent utilisateur du navigateur/de l'appareil.
* `registrationSource_origin`: URL d'origine où l'installation a commencé.

</details>

<details>

<summary><strong>Carte:Désinstallée</strong></summary>

Se déclenche lorsqu'un client retire la Carte de son Wallet. C'est un signal de désabonnement et un signal de suppression.

**Nom de l'événement Bloomreach :** `wallet_uninstalled`

**Propriétés :**

* `passId`
* `passKind`
* `passType`
* `identifier_xxx`
* `metadata_xxx`
* `device`: `apple` ou `google`.
* `registrationInformation_totalRegistrationCount`: nombre total d'installations à vie, après cette désinstallation.
* `registrationInformation_activeRegistrationCount`: installations actives, après cette désinstallation.

</details>

<details>

<summary><strong>Carte:Scannée</strong></summary>

Se déclenche lorsque le code-barres ou le code QR de la Carte est scanné. C'est le signal comportemental « en magasin / sur site » le plus fort.

{% hint style="info" %}
Pour que cet événement se déclenche, le [API de scan](/developers-guides/fr/integration-guides/scan-api.md) doit être appelée par le système de scan.
{% endhint %}

**Nom de l'événement Bloomreach :** `wallet_scanned`

**Propriétés :**

* `passId`
* `passKind`
* `passType`
* `identifier_xxx`
* `metadata_xxx`
* `scannedData`: valeur brute décodée capturée au moment du scan.
* `scannedType`: symbologie code-barres/QR.

</details>

### Modèles de scénarios

#### Engagement et réengagement

Un modèle courant utilise `wallet_installed` pour les flux de bienvenue. `wallet_uninstalled` peut alimenter des flux de réactivation et des règles de suppression.

#### Déclencheurs comportementaux

`wallet_scanned` peut déclencher des messages post-visite. Il peut également être utilisé pour construire des segments basés sur des visites récentes en magasin ou sur site.

### FAQ

<details>

<summary><strong>Le même événement peut-il se déclencher plusieurs fois pour la même Carte ?</strong></summary>

Oui. C'est attendu pour les installations (plusieurs appareils, réinstallations) et les scans (visites multiples).

</details>

<details>

<summary><strong>À quelle vitesse les événements apparaissent-ils dans Bloomreach ?</strong></summary>

Cela dépend des conditions réseau et de l'ingestion par Bloomreach. Dans des configurations typiques, les événements sont livrés en quelques secondes.

</details>

<details>

<summary><strong>Comment éviter de déclencher deux fois des scénarios lors de plusieurs installations ?</strong></summary>

Les scénarios peuvent utiliser des règles de déduplication basées sur `passId` et des fenêtres temporelles. Une autre approche courante consiste à stocker des indicateurs « installé une fois » comme attributs client.

</details>

<details>

<summary><strong>Les événements peuvent-ils être utilisés pour la segmentation et pour les déclencheurs de scénario ?</strong></summary>

Oui. Une fois ingérés, les événements peuvent être utilisés dans Bloomreach de la même manière que les autres événements suivis.

Les événements peuvent être utilisés pour créer des segments basés sur la récence et la fréquence. Ils peuvent aussi servir de déclencheurs pour démarrer ou faire bifurquer des scénarios.

</details>

<details>

<summary><strong>Les événements peuvent-ils être renommés / filtrés avant ingestion ?</strong></summary>

Oui. Le connecteur peut intercepter les événements avant de les envoyer à Bloomreach.

Cela sert à renommer les noms d'événements, ajouter ou supprimer des propriétés, ou supprimer entièrement des événements. Détails : [Extensibilité](/connectors/fr/marketing-automation/bloomreach/extensibility.md).

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