# É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 flux de réactivation léger.
* **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 à plat. Deux préfixes de noms de propriétés suivent des modèles :

* `identifier_xxx`: une propriété par identifiant de Carte (e-mail, 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: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éée mais non installée ».

**Nom de l’événement Bloomreach :** `Wallet_created`

**Propriétés :**

* `passId`: identifiant de Carte du 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:Installed</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`
* `appareil`: `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 (e-mail, 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 retire la Carte de son Wallet. C’est un signal d’attrition et un signal de suppression.

**Nom de l’événement Bloomreach :** `Wallet_uninstalled`

**Propriétés :**

* `passId`
* `passKind`
* `passType`
* `identifier_xxx`
* `metadata_xxx`
* `appareil`: `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/blob/main/develop/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 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 (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 Bloomreach. Dans les 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 stocke 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 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 ignorer complètement des événements. Détails : [Extensibilité](/connectors/fr/marketing-automation/bloomreach/extensibility.md).

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