This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

É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.

Exemples concrets
  • 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.

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

Carte:Created

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.

Carte:Installed

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é.

Carte:Uninstalled

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.

Carte:Scanned

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.

Pour que cet événement soit déclenché, le Scan API doit être invoqué par le système de scan.

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.

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

Le même événement peut-il se déclencher plusieurs fois pour la même Carte ?

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

À quelle vitesse les événements apparaissent-ils dans Bloomreach ?

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

Comment éviter de déclencher deux fois des scénarios lors de plusieurs installations ?

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.

Les événements peuvent-ils être utilisés pour la segmentation et comme déclencheurs de scénarios ?

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.

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

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é.

Mis à jour