# É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 pass 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.
* **Relance**: 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 d'é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 d'événement

Les événements sont envoyés sous forme de propriétés plates clé/valeur. Deux préfixes de nom de propriété 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ée stockée sur la Carte.

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

### Définitions d'événements

<details>

<summary><strong>Pass:Created</strong></summary>

Se déclenche lorsque The Wallet Crew génère une nouvelle Carte. Ceci est principalement utile pour l'audit et les flux « créé mais non installé ».&#x20;

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

**Propriétés :**

* `passId`: L'identifiant de la Carte The Wallet Crew.
* `passKind`: Catégorie de Carte au niveau élevé (`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>Pass: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, appareils multiples).

**Nom d'é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 sur la durée de vie, après cette installation.
* `registrationInformation_activeRegistrationCount`: Installations actives, après cette installation.
* `registrationSource_medium`: Média de suivi (email, sms, qr, in\_app, ...).
* `registrationSource_tags`: Tags de suivi capturés lors de l'installation.
* `registrationSource_userAgent`: User agent du navigateur/appareil.
* `registrationSource_origin`: URL d'origine où l'installation a commencé.

</details>

<details>

<summary><strong>Pass:Uninstalled</strong></summary>

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

**Nom d'é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 sur la durée de vie, après cette désinstallation.
* `registrationInformation_activeRegistrationCount`: Installations actives, après cette désinstallation.

</details>

<details>

<summary><strong>Pass:Scanned</strong></summary>

Se déclenche lorsque le code-barres ou le QR code 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://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/develop/guides/scan-api) doit être invoqué par le système de scan.
{% endhint %}

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

**Propriétés :**

* `passId`
* `passKind`
* `passType`
* `identifier_xxx`
* `metadata_xxx`
* `scannedData`: Valeur décodée brute 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. Il peut également être utilisé pour créer 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 (appareils multiples, 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 des scénarios deux fois lors d'installations multiples ?</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 » en tant qu'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 également être utilisés comme déclencheurs pour démarrer ou brancher 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.

Ceci est utilisé pour renommer les noms d'événements, ajouter ou supprimer des propriétés, ou éliminer complètement des événements. Détails : [Extensibilité](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/marketing-automation/bloomreach/extensibility).

</details>
