Émettre un pass Wallet

L’élément Émettre un pass Wallet crée un pass Apple Wallet ou Google Wallet pour un voyageur à partir d’une campagne de pass Wallet. Après son exécution, vous pouvez insérer le lien d’installation ou de sauvegarde dans un message ultérieur du même Journey.

Note

Cet élément ne fait qu’émettre le pass. Il ne le livre pas à l’utilisateur. Ajoutez un élément Envoyer un Push ou Envoyer un E-mail après celui-ci pour envoyer le lien d’installation. Voir Livrer le pass au voyageur ci-dessous.

Exemples de cas d’utilisation

Carte d’embarquement après l’enregistrement

Émettez une carte d’embarquement Apple ou Google Wallet dès qu’un voyageur s’enregistre. Personnalisez le siège et la porte à partir de l’événement d’enregistrement, puis envoyez le lien d’installation par push avant le départ.

• Déclencheur : CheckInCompleted
• Champs personnels : mappez Seat et Gate aux attributs d’événement correspondants
• Livraison : Envoyer un Push avec apple_install_link ou google_save_link

Carte de fidélité à l’inscription

Émettez une carte de fidélité la première fois qu’un voyageur rejoint un programme de récompenses. Personnalisez-la avec son solde de points de départ.

• Déclencheur : LoyaltySignup
• Champs personnels : mappez Points à l’attribut points de l’événement
• Livraison : Envoyer un E-mail juste après, avec le lien de sauvegarde dans le message de bienvenue

Billet d’événement après l’achat

Émettez un billet dès qu’un voyageur finalise l’achat d’un billet. Personnalisez le siège ou la rangée à partir de la commande.

• Déclencheur : TicketPurchased
• Champs personnels : mappez Seat et Row aux attributs de la commande
• Livraison : e-mail de confirmation avec apple_install_link pour que le voyageur puisse ajouter le billet en un seul clic

Prérequis

Avant d’ajouter cet élément :

• Campagne de pass Wallet : créez au moins une campagne de pass Wallet pour l’application. Émettre un pass Wallet ne peut émettre des pass qu’à partir d’une campagne existante. Il ne peut pas en concevoir une.
• Apple Wallet : connectez la plateforme iOS et terminez la configuration du pass Apple Wallet pour l’application. Voir aussi Démarrer avec les pass Apple Wallet.
• Google Wallet : configurez Google Wallet pour Android pour l’application. Voir aussi Démarrer avec les pass Google Wallet.

Prérequis complets de la campagne pour les deux plateformes : Prérequis des campagnes de pass Wallet.

Ajouter l’élément

1. Faites glisser l’élément Émettre un pass Wallet sur le canevas après l’étape qui doit déclencher l’émission.
2. Double-cliquez sur l’élément pour ouvrir ses paramètres.
3. Saisissez un nom reconnaissable dans Nom de l’étape, par exemple Carte de fidélité. Vous utiliserez ce nom plus tard lorsque vous insérerez le lien du pass dans un élément Envoyer un Push ou Envoyer un E-mail.
4. Dans Campagne Apple Wallet et Campagne Google Wallet, sélectionnez une campagne pour l’une ou l’autre plateforme, ou les deux. Chaque menu déroulant accepte une seule campagne. Laissez un menu déroulant vide pour ignorer cette plateforme.

Conseil

La sélection des deux plateformes permet à la même étape du Journey de couvrir à la fois les voyageurs sur iPhone et Android. Chaque plateforme émet (ou réutilise, voir Entrées répétées et conditions de suppression ci-dessous) son propre pass indépendamment pour le même voyageur.

Les deux menus déroulants ne listent que les campagnes de cette application pour la plateforme correspondante, en excluant déjà celles qui sont archivées.

Note

Une campagne en Brouillon est toujours listée et émet des pass exactement comme une campagne Active, donc sortir une campagne du statut Brouillon n’est pas un prérequis ici.

Remplir les champs personnels

Sous Champs personnels sur le pass, définissez une valeur pour chaque champ qui apparaît.

La liste reste vide jusqu’à ce que vous sélectionniez une campagne ci-dessus. Elle affiche alors les champs Personnels de cette campagne, les mêmes que ceux que vous remplissez dans la boîte de dialogue Émettre un pass de la campagne. Si vous changez de campagne, la liste se met à jour pour correspondre.

Pour chaque champ, ouvrez le menu déroulant des valeurs et choisissez l’une des options suivantes :

• Valeur statique : saisissez une valeur unique pour chaque voyageur qui atteint cet élément. Par exemple, tapez SUMMER2026 dans un champ OFFER pour que chaque pass émis par cet élément porte le même code promotionnel.

• Un événement survenu plus tôt dans le parcours du voyageur à travers le Journey. Choisissez ensuite un Attribut d’où extraire la valeur du champ. Par exemple, choisissez l’événement d’entrée et son attribut offer_code pour remplir le champ OFFER avec la valeur propre à chaque voyageur au lieu d’une valeur unique pour tout le monde. Pushwoosh lit cet attribut à partir des données d’événement propres au voyageur lorsque cet élément s’exécute, de sorte que le pass de chaque voyageur obtient sa propre valeur.

Note

Deux types de champs ne sont pas listés ici, car ils ne nécessitent aucune saisie de votre part :

• Un champ écrit simplement comme {Seat} se remplit automatiquement pour chaque voyageur.
• Les champs Partagés de la campagne portent la même valeur sur chaque pass. Vous définissez cette valeur une seule fois, dans la campagne elle-même.

Avec des campagnes sélectionnées pour les deux plateformes, la liste affiche les champs des deux. Un champ qui n’existe que dans une seule campagne n’est rempli que pour le pass de cette plateforme.

Note

Si l’événement source ne s’est jamais déclenché pour un voyageur, ou si l’attribut est vide, le pass utilise à la place la valeur propre de la campagne pour ce champ, définie dans Définir les champs partagés et personnels. Le voyageur n’est pas supprimé.

Lorsque vous avez terminé, cliquez sur Appliquer pour enregistrer les paramètres de l’élément.

Entrées répétées et conditions de suppression

Si le même voyageur atteint à nouveau cet élément, par exemple après avoir bouclé dans le Journey, Pushwoosh renvoie le pass qui lui a déjà été émis au lieu d’en créer un nouveau. Chaque voyageur détient au maximum un pass par campagne.

Émettre un pass Wallet supprime le voyageur, sans nouvelle tentative automatique, dans deux cas :

• Le voyageur n’a aucun User ID, pas même le HWID de l’appareil par défaut qu’une session SDK normale définit automatiquement. Cela se produit lorsqu’un voyageur entre dans le Journey sans en avoir, par exemple via une entrée basée sur l’API ou une charge utile d’événement qui n’a pas de champ User ID.
• L’émission du pass a échoué pour une campagne configurée, par exemple parce qu’elle a été supprimée ou archivée après que vous ayez ajouté l’élément. Lorsque les deux plateformes sont configurées, la tentative est d’abord faite pour Apple. Si elle échoue, le voyageur est supprimé avant même que la tentative soit faite pour Google, donc un résultat partiel ne se produit jamais.

Voir Pas de User ID et Échec de l’émission du pass pour savoir quoi vérifier.

Livrer le pass au voyageur

Lorsque vous personnalisez un push ou un e-mail ultérieur, vous pouvez extraire des valeurs de cette étape Émettre un pass Wallet par le Nom de l’étape que vous lui avez donné. Voici les attributs que vous pouvez insérer :

Attribut	Plateforme	Contient
apple_install_link	Apple Wallet	URL pour installer le pass
google_save_link	Google Wallet	URL pour sauvegarder le pass

Seul l’attribut pour la ou les plateforme(s) que vous avez configurée(s) sur l’élément est disponible.

Attention

L’élément n’émet un pass que pour la ou les plateforme(s) que vous avez configurée(s), et non en fonction de l’appareil réel du voyageur. Un voyageur sur l’autre plateforme passe quand même à la sortie par défaut, mais avec un lien qu’il ne peut pas utiliser. Configurez à la fois Apple Wallet et Google Wallet si votre public utilise les deux plateformes.

1. Ajoutez un élément Envoyer un Push ou Envoyer un E-mail après Émettre un pass Wallet.
2. Dans le corps du message, tapez l’espace réservé du lien d’installation avec des barres verticales, par exemple {apple_install_link|regular|}. N’utilisez pas un simple {apple_install_link}. Voir Contenu dynamique ou modèles Liquid pour la syntaxe complète.
3. Activez Personnaliser le message avec les attributs d’événement.
4. Dans le tableau, cochez la case Remplacer l’espace réservé à côté de votre espace réservé. Ses menus déroulants Événement source et Attribut dynamique restent désactivés jusqu’à ce que vous le fassiez.
5. Dans Événement source, choisissez votre étape Émettre un pass Wallet par le Nom de l’étape que vous lui avez donné, par exemple Carte de fidélité.
6. Dans Attribut dynamique, choisissez apple_install_link ou google_save_link pour correspondre à l’espace réservé que vous avez utilisé.

Note

Pour Envoyer un Push, resélectionnez le préréglage après avoir modifié le message pour que le mappage prenne en compte le nouvel espace réservé. Pour Envoyer un E-mail, un espace réservé avec des barres verticales fonctionne également dans la ligne d’objet, pas seulement dans le corps du message.

Chaque pass émis a également un numéro de série (apple_serial_number ou google_serial_number dans le contexte du point). Transmettez-le à vos propres systèmes avec un élément Données vers l’application ou Webhook, par exemple pour l’enregistrer dans un CRM ou un outil de support. Pour trouver le pass correspondant dans Pushwoosh par son numéro de série, utilisez l’onglet Passes de la campagne de pass Wallet ou l’API AttachPasses, lorsque vous avez besoin d’attacher un pass autonome à une campagne.

Attention

Le panneau de l’élément affiche les entrées et les suppressions, y compris la raison pour laquelle un voyageur a été supprimé : Pas de User ID ou Échec de l’émission du pass. Pour savoir combien de pass ont été réellement émis, consultez les statistiques de l’élément Envoyer un Push ou Envoyer un E-mail en aval.

Scénario d’exemple : offre de fidélité d’un café

Un café souhaite accueillir chaque nouveau membre de son programme de fidélité avec un pass de réduction qu’il peut ajouter au portefeuille de son téléphone.

1. Créez l’événement CoffeeClubJoined et assurez-vous qu’il inclut un attribut pour l’offre de bienvenue, par exemple offer_code. En savoir plus sur la création d’événements
2. Définissez cet événement comme déclencheur du Journey, afin que chaque nouveau membre y entre dès son adhésion.

3. Ajoutez Émettre un pass Wallet après le déclencheur.
4. Nommez-le Carte de fidélité.
5. Sélectionnez la campagne de fidélité, par exemple Réduction café, pour la Campagne Apple Wallet (et aussi la Campagne Google Wallet, si vous prenez en charge Android).
6. Sous Champs personnels sur le pass, définissez OFFER sur l’événement d’entrée du déclencheur.
7. Choisissez offer_code comme Attribut.

8. Ajoutez un élément Envoyer un E-mail juste après Émettre un pass Wallet.
9. Personnalisez-le avec apple_install_link (ou google_save_link) pour que l’e-mail de bienvenue inclue un lien en un clic pour ajouter le pass.

Lorsque CoffeeClubJoined se déclenche, le voyageur entre dans le Journey, Émettre un pass Wallet émet son pass avec l’offer_code de cet événement, et Envoyer un E-mail envoie le message de bienvenue avec le lien pour l’ajouter.