> 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

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 plates clé/valeur. Deux préfixes de noms de propriétés sont des motifs :

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

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

### Définitions des événements

<details>

<summary><strong>Carte:Created</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éés mais non installés ».

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

**Propriétés :**

* `passId`: l'identifiant de Carte de The Wallet Crew.
* `passKind`: catégorie de Carte de haut niveau (`customerCard`, `eventTicket`, `giftCard`, `offer`, `generic`).
* `CarteType`: identifiant de 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:Installed</strong></summary>

Se déclenche lorsqu'un client ajoute une Carte à Apple Wallet ou Google Wallet. Cela 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`
* `CarteType`
* `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`: support 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:Uninstalled</strong></summary>

Se déclenche lorsqu'un client supprime 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`
* `CarteType`
* `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:Scanned</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 soit déclenché, le [Scan API](https://github.com/TheWalletCrew/docs/tree/main/develop/guides/scan-api.md) doit être invoqué par le système de scan.
{% endhint %}

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

**Propriétés :**

* `passId`
* `passKind`
* `CarteType`
* `identifier_xxx`
* `metadata_xxx`
* `scannedData`: valeur brute décodée capturée au moment du scan.
* `scannedType`: symbologie du 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 reconquête et des règles de suppression.

#### Déclencheurs comportementaux

`wallet_scanned` peut déclencher des messages post-visite. Cela peut aussi être utilisé pour créer des segments basés sur les 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 (plusieurs visites).

</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 Bloomreach. Dans des configurations typiques, les événements sont transmis 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 comme déclencheurs de scénarios ?</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 lancer des scénarios ou en créer des branches.

</details>

<details>

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

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

C'est utilisé pour renommer les noms d'événements, ajouter ou supprimer des propriétés, ou ignorer 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.