Guide utilisateur
Segmentez et activez les cas d'utilisation wallet courants à partir des flows et campagnes Klaviyo.
Klaviyo reste la couche d'orchestration.
The Wallet Crew fournit deux briques clés dans Klaviyo :
propriétés de profil pour cibler les clients en fonction de l'état de Wallet
liens de téléchargement de la Carte personnalisés avec
neostore.authenticationToken
Exemples concrets
Une campagne de rappel cible les clients qui n'ont pas installé la Carte.
Un flux post-installation accueille les clients avec un message de bienvenue spécifique à Wallet.
Un flux post-installation déclenche une notification Wallet avec un message d'intégration.
Une mise à jour de l'abonnement à une liste dans le formulaire d'inscription de The Wallet Crew alimente la messagerie basée sur le consentement dans Klaviyo.
Envoyer un e-mail aux clients sans Carte installée
Ce modèle cible les profils où le jeton existe, mais où le statut Wallet indique « non installée ».
Construire le segment
Un segment dynamique peut être créé pour correspondre à :
neostore.authenticationTokenest définiet au moins un statut de fournisseur Wallet n'est pas installé
Le statut Wallet est généralement exposé sous forme de propriétés de profil similaires à :
neostore.wallet.loyaltyCard.Appleneostore.wallet.loyaltyCard.Google
La logique des segments utilise souvent :
le statut Apple n'est pas égal à
InstalléOU le statut Google n'est pas égal à
Installé
Les propriétés de statut Wallet dépendent du type de Carte et de la configuration du tenant.
La validation la plus sûre consiste à inspecter un profil synchronisé dans Klaviyo et à copier le chemin de la propriété.
La validation peut commencer en prévisualisant quelques profils correspondants et en vérifiant leurs propriétés de statut Wallet.
Insérer un lien de téléchargement de la Carte
Les modèles Klaviyo peuvent insérer le jeton avec :
{{person | lookup:'neostore.authenticationToken' }}
Deux destinations courantes existent.
Mise en page de téléchargement / d'inscription de la Carte
https://app.neostore.cloud/<tenantId>/mail?neo.authToken={{person | lookup:'neostore.authenticationToken' }}Page de la Carte (confirmation)
https://app.neostore.cloud/<tenantId>/mail/confirm?neo.authToken={{person | lookup:'neostore.authenticationToken' }}<tenantId> est l'identifiant du tenant.
Le nom d'hôte peut être différent lorsqu'un domaine personnalisé est configuré pour le tenant.
La validation peut commencer en mode aperçu de Klaviyo en confirmant que l'URL rendue contient un élément non vide neo.authToken valeur.
Envoyer un e-mail après l'installation de la Carte
Ce modèle démarre un flux après l'enregistrement d'une métrique d'installation.
Ajouter le contenu du message
Le modèle de lien de la page de la Carte peut être réutilisé pour la messagerie post-installation. C'est utile pour les messages de « bienvenue » et de « prochaine étape ».
Dans de nombreux cas, l'URL de confirmation (/mail/confirm) est préférée ici, car la Carte existe déjà.
Le nom exact de la métrique dépend de la configuration du connecteur.
La métrique apparaît dans Klaviyo dès que le premier événement est reçu.
Envoyer une notification Wallet
Les notifications Wallet peuvent être déclenchées à partir d'un flux Klaviyo en utilisant une action webhook appelant le listener Klaviyo de The Wallet Crew.

Ce modèle convient à tout moment à forte intention du parcours client. Les événements du cycle de vie Wallet, les commandes, les visites en magasin et les jalons peuvent devenir des déclencheurs. L'orchestration Klaviyo peut ensuite combiner la segmentation, le timing et les règles de fréquence pour que les messages Wallet restent opportuns et pertinents.


Le comportement des notifications diffère entre Apple Wallet et Google Wallet.
Détails : Notifications push.
Ajouter une action webhook
Utilisez le point de terminaison du listener Klaviyo de The Wallet Crew :
https://app.neostore.cloud/api/<tenantId>/webhooks/listeners/klaviyo/passes/pushUpdate
Le webhook doit inclure le X-API-KEY en-tête avec une clé API The Wallet Crew qui inclut tenant.klaviyo.listener l'autorisation d'écriture.
Utilisez le payload JSON ci-dessous
Le payload identifie la Carte et ajoute un message de notification dans additionalData.
La propriété utilisée pour résoudre l'identifiant de la Carte peut varier selon le type de Carte et la configuration du tenant.
La validation peut commencer en inspectant un profil Klaviyo et en confirmant quelle propriété stocke l'identifiant de la Carte.
Comportement d'abonnement et de désabonnement
Les mises à jour de l'abonnement à une liste peuvent être pilotées par les champs de consentement de The Wallet Crew.
Cela nécessite :
une clé privée Klaviyo avec les autorisations Lists + Subscriptions
une seule liste
listIdconfiguré, ou une implémentation de script multi-listes
Détails de configuration : Configuration du consentement et de l'abonnement à une liste.
Lorsque le consentement est capturé lors de l'inscription, le connecteur peut abonner le profil à la liste configurée. Lorsque le consentement est retiré, le connecteur peut mettre à jour le statut de l'abonnement en conséquence.
Dépannage lors de la création des campagnes
Le lien s'affiche mais le jeton est vide
Vérifier
neostore.authenticationTokenexiste sur le profil.Vérifiez que le profil est passé par le flux de synchronisation utilisé pour le rétro-remplissage.
Vérifiez que le modèle utilise
lookup:'neostore.authenticationToken'.Vérifiez que le profil quitte le segment utilisé pour le rétro-remplissage du jeton (exemple :
Profils non synchronisés TWC) une fois que le flux de synchronisation s'exécute.Si le jeton manque sur de nombreux profils, revenez sur Configuration.
Les clients arrivent sur la mauvaise page
Deux URL existent.
/mailouvre la mise en page d'inscription./mail/confirmouvre la page de la Carte.
La logique du segment pour le statut installé est incorrecte
Vérifiez que le segment contrôle à la fois les propriétés Apple et Google.
Vérifiez que la casse de la valeur stockée correspond à la condition du segment (exemple :
Installé).
FAQ
Qui est généralement responsable des campagnes ?
Les campagnes, les segments et les flows sont gérés dans Klaviyo.
The Wallet Crew gère l'exécution Wallet et les événements du cycle de vie Wallet.
Quel lien doit être utilisé : /mail ou /mail/confirm?
/mail est généralement utilisé pour les parcours de téléchargement et d'inscription de la Carte.
/mail/confirm est généralement utilisé lorsqu'une Carte existe déjà et que l'objectif est d'ouvrir directement la page de la Carte.
Une notification Wallet peut-elle être envoyée si la Carte n'est pas installée ?
Non. Les notifications Wallet nécessitent au moins une installation active sur un appareil.
Une solution de repli courante consiste à utiliser d'abord l'e-mail ou le SMS pour distribuer un lien de téléchargement de la Carte, puis à déclencher des notifications Wallet après un événement d'installation.
Quelle est la manière la plus sûre de tester les notifications Wallet ?
La plupart des équipes utilisent d'abord un environnement de préproduction et conservent une petite liste de cartes de test internes installées sur des appareils réels.
Le comportement et les limites des notifications dépendent des règles d'Apple Wallet et de Google Wallet. Référence : Notifications push.
Comment éviter d'envoyer trop de notifications Wallet ?
Les notifications Wallet sont très visibles. Une utilisation excessive peut provoquer des désabonnements et de la lassitude.
Klaviyo peut imposer des plafonds de fréquence et des segments d'éligibilité. Une règle de protection courante cible uniquement les profils avec un statut de Carte installée et une activité récente.


Comment valider que la personnalisation fonctionne avant d'envoyer une campagne ?
La validation peut commencer en mode aperçu de Klaviyo en vérifiant que l'URL rendue contient un
neo.authToken.La validation du profil peut être effectuée en confirmant
neostore.authenticationTokenqu'il existe sur quelques profils de test. Détails de configuration : Configuration.