> 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 envoie des événements de carte Wallet via l'API d'événements Bloomreach de la marque. Chaque événement est associé au client via l'identifiant ou les identifiants enregistrés de la carte.

<details>

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

* **Intégration**: lorsqu'une carte est installée, déclenchez une série de bienvenue.
* **Récupération**: lorsqu'une carte est désinstallée, déclenchez un léger parcours de réactivation.
* **En magasin**: lorsqu'une carte est scannée, déclenchez un sondage post-visite ou une récompense.
* **Engagement sur les liens**: lorsqu'un lien de carte suivi est ouvert, déclenchez un suivi ciblé.

</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`
* `wallet_linkOpened`

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

Les événements sont envoyés sous forme de propriétés clé/valeur plates. Chaque événement inclut ces propriétés de base :

* `passType` (chaîne) : identifiant du type de carte.
* `passId` (chaîne) : identifiant de la carte.
* `passKind` (chaîne) : type de carte, par exemple `CustomerCard` ou `EventTicket`.
* `identifier_<name>` (chaîne) : une propriété pour chaque identifiant de carte.
* `metadata_<name>` (chaîne) : une propriété pour chaque entrée de métadonnées de carte non nulle.

Les points dans un nom d'identifiant deviennent des underscores. Par exemple, `y2.customerId` devient `identifier_y2_customerId`.

Les propriétés de métadonnées avec une `null` valeur sont omises.

### Définitions des événements

<details>

<summary><strong>Carte:Created</strong></summary>

Envoyé lorsque The Wallet Crew crée une carte Wallet. Cet événement n'a aucune propriété au-delà de l'ensemble de base.

**Nom d'événement Bloomreach :** `wallet_created`

</details>

<details>

<summary><strong>Carte:Installed</strong></summary>

Envoyé lorsqu'une carte est installée sur un appareil. Il peut se déclencher plusieurs fois pour la même carte.

**Nom d'événement Bloomreach :** `wallet_installed`

**Propriétés supplémentaires :**

* `device` (chaîne) : `Apple` ou `Google`.
* `registrationInformation_totalRegistrationCount` (chaîne) : nombre total d'inscriptions.
* `registrationInformation_activeRegistrationCount` (chaîne) : inscriptions actives.
* `registrationSource_medium` (chaîne) : inclus lorsqu'il est défini.
* `registrationSource_origin` (chaîne) : inclus lorsqu'il est défini.
* `registrationSource_userAgent` (chaîne) : inclus lorsqu'il est défini.
* `registrationSource_tags` (chaîne) : balises séparées par des virgules, incluses lorsqu'elles sont définies.

Tous `registrationSource_*` les propriétés sont absentes lorsque l'inscription ne comporte aucune information source.

</details>

<details>

<summary><strong>Carte:Uninstalled</strong></summary>

Envoyé lorsqu'une carte est désinstallée d'un appareil.

**Nom d'événement Bloomreach :** `wallet_uninstalled`

**Propriétés supplémentaires :**

* `device` (chaîne) : `Apple` ou `Google`.
* `registrationInformation_totalRegistrationCount` (chaîne) : nombre total d'inscriptions.
* `registrationInformation_activeRegistrationCount` (chaîne) : inscriptions actives.

</details>

<details>

<summary><strong>Carte:Scanned</strong></summary>

Envoyé lorsqu'une carte est scannée.

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

**Nom d'événement Bloomreach :** `wallet_scanned`

**Propriétés supplémentaires :**

* `scannedData` (chaîne) : valeur scannée.
* `scannedType` (chaîne) : type scanné.

</details>

<details>

<summary><strong>Carte:LinkOpened</strong></summary>

Envoyé lorsqu'un titulaire de carte appuie sur un lien suivi intégré dans une carte Wallet.

**Nom d'événement Bloomreach :** `wallet_linkOpened`

**Propriétés supplémentaires :**

* `link_targetUrl` (chaîne) : toujours inclus.
* `link_device` (chaîne) : `Apple` ou `Google`, inclus lorsqu'il est connu.
* `link_origin` (chaîne) : inclus lorsqu'il est connu. Cela identifie l'emplacement dans la carte à partir duquel le lien a été touché, par exemple `BackField`, `FeaturedAction` ou `LinksModule`. La référence d'origine [référence d'origine](https://app.gitbook.com/s/OnaDC4sjKAx53j0QV843/integration-guides/wallet/link-tracking) répertorie chaque valeur et ce qu'elle signifie sur chaque Wallet.
* `link_sourceId` (chaîne) : inclus lorsqu'il est défini. Cela identifie le lien individuel à cet emplacement, tel qu'une clé de champ ou un identifiant de message.
* `link_language` (chaîne) : inclus lorsque le lien a été touché dans un texte localisé. Il s'agit de la langue vue par le titulaire de la carte.
* `link_userAgent` (chaîne) : inclus lorsqu'il est connu.

</details>

### Modèles de scénarios

#### Engagement et réengagement

Un schéma courant utilise `wallet_installed` pour les parcours de bienvenue. `wallet_uninstalled` peut alimenter des parcours de récupération 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.

#### Engagement sur les liens

`wallet_linkOpened` peut déclencher des suivis après que les clients ont ouvert des liens de carte suivis. Le `link_origin` propriété prend en charge des scénarios spécifiques à un emplacement : [Suivi des liens](https://app.gitbook.com/s/OnaDC4sjKAx53j0QV843/integration-guides/wallet/link-tracking) répertorie les valeurs qu'il peut prendre ainsi que l'identifiant source associé à chacune, et [Mesurer les clics sur les liens dans les cartes](https://app.gitbook.com/s/EsokFUBfsbM9mlwavmMB/monitor/measure-link-clicks) explique ce que le suivi fait à l'URL de destination avant que le client n'y accède.

### 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 classiques, les événements sont livrés en quelques secondes.

</details>

<details>

<summary><strong>Comment éviter de déclencher deux fois les 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 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 être utilisés comme 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 l'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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.