Créer des campagnes de Wallet Pass

Une campagne de Wallet Pass vous permet de concevoir un modèle de pass unique pour Apple Wallet ou Google Wallet, de l’émettre à plusieurs utilisateurs et de gérer les mises à jour de manière centralisée.

Vous choisissez quels champs sont Partagés (synchronisant les modifications sur tous les appareils des utilisateurs simultanément) et lesquels sont Personnels (préservant des valeurs uniques comme les noms, les codes-barres ou les soldes pour chaque utilisateur).

Note

Une campagne de Wallet Pass n’est pas liée à une campagne Customer Journey ou à une notification push. C’est un outil pour gérer les modèles de passes, leur émission et leurs mises à jour en temps réel.

Ce que vous pouvez faire avec les campagnes de Wallet Pass

• Concevoir un seul pass dans une campagne, au lieu de configurer chaque pass manuellement dans le constructeur de pass Apple Wallet ou Google Wallet.
• Choisir quels champs se mettent à jour partout (partagés) et lesquels restent spécifiques à chaque pass (personnels).
• Voir combien de passes émis sont affectés par une modification de champ avant de l’enregistrer.
• Remplacer un champ partagé sur un pass, puis redonner le contrôle à la campagne plus tard.
• Joindre des passes émis en dehors d’une campagne pour qu’ils commencent à suivre ses champs partagés.
• Suivre les révisions de la campagne et le statut de livraison de chaque mise à jour.
• Actualiser automatiquement un pass chaque fois que le tag derrière l’un de ses champs change, sans modifier la campagne.

Prérequis

Une campagne utilise la même configuration unique qu’un pass autonome :

Apple Wallet :

• Adhésion active au programme pour développeurs Apple
• Plateforme iOS connectée à l’application
• Certificat de signature de pass téléversé sur Pushwoosh

Google Wallet :

• Compte émetteur actif sur la console Google Pay & Wallet
• Google Wallet configuré pour l’application (ID d’émetteur et clé de compte de service Google Cloud)

Créer une campagne

Pour commencer à créer une campagne, allez dans Campagnes → Wallet Passes → Campagnes et cliquez sur Créer une campagne.

Définir les détails et la plateforme de la campagne

• Plateforme : sélectionnez Apple Wallet ou Google Wallet en haut de la page. Ce choix est permanent pour la campagne.
• Campagne : saisissez un Nom et une Description facultative pour votre référence interne. Aucun des deux n’apparaît sur le pass.
• Format du pass : sous Style de pass (Apple) ou Type de pass (Google), choisissez la mise en page de votre pass :
  • Apple Wallet : Carte d’embarquement, Coupon, Billet d’événement, Carte de magasin, Générique. Voir Choisir un style de pass.
  • Google Wallet : Générique, Offre, Carte de fidélité, Billet d’événement, Carte-cadeau, Vol, Transport. Ce choix ne peut pas être modifié après la création. Voir Choisir un type de pass.

Configurer le design et l’image de marque du pass

Configurez les sections standard du pass :

• Informations de base, Couleurs et Code-barres : définissez le titre du pass, les couleurs de fond et de texte, et le type de code-barres. Pour des instructions détaillées sur chaque section, consultez Concevoir des passes dans le constructeur de pass Apple Wallet ou Concevoir des passes Google Wallet dans le constructeur de pass.
• Champs du pass : ajoutez les champs qui doivent apparaître sur la carte (voir Champs du pass Apple Wallet ou Champs et détails Google Wallet).
• Expiration : définissez les dates pertinentes et les règles d’expiration (voir Expiration Apple Wallet ou Expiration Google Wallet).
• Lieux : définissez la pertinence basée sur la localisation (voir Lieux Apple Wallet ou Lieux Google Wallet).

Conseil

Pour Google Wallet, utilisez Qui peut enregistrer le pass pour contrôler si le pass est lié à un seul compte Google, à un seul appareil, ou accessible à toute personne disposant du lien.

Définir les champs partagés et personnels

Dans la section Champs partagés et personnels, configurez quels champs se mettent à jour globalement sur tous les passes et lesquels conservent des valeurs uniques par utilisateur. Cela contrôle ce qui se passe lorsque vous modifiez la campagne plus tard : les champs partagés se mettent à jour sur chaque pass émis, tandis que les champs personnels restent inchangés.

Activez le bouton Personnel pour tout champ qui doit contenir des valeurs uniques par utilisateur.

Type de champ	Comportement	Exemples
Partagé	Piloté par la campagne. La mise à jour de ce champ synchronise la nouvelle valeur sur chaque pass sur les appareils des utilisateurs.	Date de l’événement, Numéro de porte, Adresse du magasin, Pourcentage de réduction
Personnel	Unique par utilisateur. La campagne n’écrase pas ces valeurs lors d’une mise à jour.	Nom d’utilisateur, Numéro de siège, ID de membre, Solde de points

La valeur d’un champ personnel peut inclure un espace réservé pour un tag, {tag} ou {tag|format|fallback} (par exemple, {Seat}). Pushwoosh le remplit à partir du tag du destinataire lorsqu’il sert le pass. Si le destinataire n’a pas de valeur pour ce tag, Pushwoosh utilise la valeur de secours de l’espace réservé, ou laisse le champ vide si l’espace réservé n’en a pas.

• Juste le tag, rien d’autre, comme {Seat} : le champ n’apparaît pas dans la boîte de dialogue Émettre un pass.
• Le tag mélangé avec un autre texte, comme Siège {Seat}, ou pas de tag du tout : le champ apparaît comme une entrée modifiable dans la boîte de dialogue Émettre un pass, pré-remplie avec cette valeur. Tout tag à l’intérieur se résout toujours par destinataire lorsque Pushwoosh sert le pass.

Conseil

Le code-barres d’un pass est configuré et personnalisé dans la section Code-barres. Voir Code-barres Apple Wallet ou Code-barres Google Wallet pour plus de détails.

Activer la synchronisation des tags

Dans la section Synchronisation des tags, activez Mettre à jour les champs du pass à partir des tags pour que Pushwoosh revérifie périodiquement les espaces réservés pour les tags utilisés dans les champs de la campagne et envoie une nouvelle valeur à tout pass dont le tag a changé.

• Intervalle (minutes) : fréquence à laquelle Pushwoosh relit les tags. La valeur par défaut est 60 et ne peut pas être inférieure à 5. Un pass reçoit au plus une actualisation par intervalle, peu importe le nombre de fois que son tag change entre-temps.
• Notification (Google Wallet uniquement) : choisissez comment le détenteur est informé de l’actualisation : Silencieusement, Message personnalisé (remplissez Texte du message, envoyé avec la mise à jour), ou Notification de champ Google (alerte de mise à jour de champ propre à Google). Google les limite à 3 par pass par 24 heures. Au-delà, les nouvelles valeurs atteignent toujours le pass, mais sans notification.

Note

Apple Wallet n’a pas de notification à l’échelle de la campagne, donc ce sélecteur n’apparaît pas pour les campagnes Apple. Le texte de la notification se trouve sur le champ lui-même. Remplissez Message de modification sur chaque champ dans le constructeur de pass Apple Wallet.

Attention

La synchronisation des tags ne s’exécute que lorsque le statut de la campagne est Actif. Réglez-le sur Brouillon ou Archivé pour suspendre les vérifications planifiées sans désactiver le bouton.

Activer la synchronisation des tags pour une campagne qui a déjà des passes émis n’attend pas la fin du premier intervalle. La prochaine vérification planifiée traite une campagne qui n’a jamais été synchronisée comme étant due immédiatement, et en mode Message personnalisé ou Notification de champ Google, cela peut notifier chaque détenteur en même temps et utiliser le plafond de 3 notifications par 24 heures du pass en une seule fois.

Téléverser les images de la campagne

1. Dans la section Images de la campagne, cliquez sur Choisir une image à côté d’un emplacement d’image.
2. Sélectionnez une image existante de votre Médiathèque ou glissez-déposez un nouveau fichier pour le téléverser.
3. Répétez pour chaque emplacement d’image disponible :
   • Apple Wallet : Icône, Logo, Arrière-plan, Pied de page, Bandeau et Miniature (voir Images Apple Wallet).
   • Google Wallet : Logo et Image principale.

Note

• Les images doivent faire moins de 10 Mo et 25 mégapixels.
• Apple Wallet : contrairement à un pass autonome, où les images sont verrouillées après la création, une mise à jour d’image de campagne atteint chaque pass émis.
• Google Wallet : un pass autonome vous permet déjà de changer son logo et son image principale à tout moment via Modifier. Une image de campagne fonctionne de la même manière, sauf qu’une seule modification atteint chaque pass émis en même temps au lieu d’un seul.

Prévisualiser et créer la campagne

1. Consultez le panneau Prévisualiser en tant qu’utilisateur à droite pour voir à quoi ressemble la carte. Vous pouvez saisir un ID utilisateur de test pour prévisualiser les champs personnalisés.

Conseil

Cliquez sur Valider le pass pour vérifier le design par rapport aux exigences d’Apple ou de Google avant d’enregistrer, sans encore créer la campagne.

2. Cliquez sur Créer une campagne en bas de la page.

Pushwoosh crée la campagne avec le statut Brouillon et ouvre son espace de travail, avec les onglets Design, Passes et Historique.

Note

La création d’une campagne enregistre uniquement le design du pass et n’envoie pas de passes aux utilisateurs. Pour distribuer les passes à votre audience, passez à Émettre des passes aux utilisateurs.

Émettre des passes aux utilisateurs

Émettre un pass depuis la campagne

1. Dans l’onglet Passes, cliquez sur Émettre un pass.
2. Saisissez l’ID utilisateur Pushwoosh du destinataire.

3. Cliquez sur Émettre un pass pour confirmer.

Selon la configuration des Champs personnels, la modale les gère comme suit :

• Champs modifiables : apparaissent avec des valeurs par défaut que vous pouvez modifier pour cet utilisateur.
• Espaces réservés pour les tags (comme {Seat}) : n’apparaissent pas dans la boîte de dialogue. Pushwoosh les remplit automatiquement à partir des tags de l’utilisateur.

Vous pouvez également modifier n’importe quel champ personnel sur un pass individuel à tout moment après son émission.

Pushwoosh génère le pass à partir du design actuel de la campagne et le liste dans l’onglet Passes et dans le tableau Tous les passes de l’application (Apple Wallet ou Google Wallet).

Livrer le pass au destinataire

L’émission d’un pass crée l’enregistrement du pass dans Pushwoosh. Pour le livrer sur l’appareil de l’utilisateur, partagez le lien d’installation :

1. Ouvrez le menu d’actions du pass dans l’onglet Passes ou dans Tous les passes.
2. Sélectionnez Copier le lien d’installation ou Code QR. Les passes Apple Wallet offrent également l’option Télécharger pour le fichier .pkpass signé.
3. Envoyez le lien ou le fichier au destinataire par push, e-mail, SMS ou via un Customer Journey. Pour émettre un pass et livrer son lien automatiquement au fur et à mesure que les voyageurs progressent dans un parcours, utilisez l’élément Émettre un Wallet Pass au lieu de l’émettre ici.

Pour plus de moyens de distribuer les passes, voir Partager les passes Apple Wallet ou Partager les passes Google Wallet.

Joindre un pass existant à une campagne

Vous pouvez joindre des passes autonomes (créés en dehors de toute campagne) à une campagne pour qu’ils commencent à recevoir des mises à jour partagées.

1. Dans l’onglet Passes, cliquez sur Joindre des passes.
2. Recherchez des passes par ID utilisateur, numéro de série ou code-barres.
3. Sélectionnez les passes et confirmez.

Une fois joints :

• Les champs partagés commencent à suivre la campagne et se mettent à jour chaque fois que vous modifiez le modèle de pass.
• Les valeurs personnelles déjà présentes sur le pass (telles que les détails de l’utilisateur ou les soldes uniques) sont préservées.

Joindre des passes via l'API

Vous pouvez également joindre des passes par programmation en utilisant la méthode API AttachPasses (jusqu’à 500 numéros de série par requête).

Si un pass ne peut pas être joint, l’API renvoie la raison spécifique pour ce numéro de série :

• Le pass est déjà assigné à une autre campagne.
• Le style du pass ne correspond pas au format de la campagne.
• Il manque au pass des champs de campagne requis.
• Le numéro de série n’existe pas ou appartient à une autre plateforme.

Gérer une campagne existante

L’ouverture d’une campagne créée depuis Campagnes → Wallet Passes → Campagnes affiche son statut, son compteur de révisions, un aperçu en direct du pass et trois onglets principaux : Design, Passes et Historique.

Changer le statut de la campagne

Utilisez le statut pour suivre où en est chaque campagne : en cours de conception, en émission active de passes, ou terminée et archivée.

Pour changer le statut, sélectionnez une option dans le menu déroulant Statut dans l’en-tête de la campagne. La modification est enregistrée immédiatement sans étape de confirmation distincte :

• Brouillon ou Actif : vous permet d’émettre de nouveaux passes, de joindre des passes existants et d’envoyer des mises à jour de design.
• Archivé : met en pause l’émission de nouveaux passes. Vous ne pouvez pas émettre ou joindre de passes tant que la campagne est archivée, mais les passes précédemment émis continuent de fonctionner et de recevoir des mises à jour partagées.

Onglet Design

Dans l’onglet Design, vous pouvez mettre à jour le modèle de pass, changer les couleurs, modifier les champs partagés et personnels, téléverser de nouvelles images de campagne ou modifier les paramètres de synchronisation des tags.

Mettre à jour le design et envoyer les modifications aux passes

1. Dans l’onglet Design, modifiez les informations de base, les couleurs, le type de code-barres, l’expiration, les lieux, un champ partagé ou une image de campagne.
2. Cliquez sur Enregistrer les modifications.
3. Dans la boîte de dialogue Appliquer la modification de la campagne, confirmez la mise à jour :
   • Aucun pass ne remplace le champ modifié : cliquez sur Mettre à jour N, conserver les modifications manuelles pour envoyer la modification à tous les N passes.
   • Certains passes remplacent le champ modifié : la boîte de dialogue nomme le champ et indique combien de passes le remplacent. Cliquez sur Mettre à jour N, conserver les modifications manuelles pour envoyer la modification à tous les passes sauf ceux-là, ou sur Écraser les N pour l’envoyer à tous les N passes, y compris ceux qui ont été remplacés. L’écrasement efface la modification manuelle.

Quel que soit le bouton sur lequel vous cliquez, la mise à jour est enregistrée comme une nouvelle révision (par exemple, Révision 2), vous pouvez donc vérifier ce qui a changé et quand dans l’onglet Historique.

Note

Une modification effectuée alors qu’aucun pass n’a encore été émis est enregistrée immédiatement sans boîte de dialogue de confirmation, car il n’y a pas de passes existants à mettre à jour.

Remplacer un champ partagé sur un pass individuel

Si vous devez personnaliser un champ partagé pour un utilisateur spécifique, modifiez ce champ directement sur son pass individuel (depuis l’onglet Passes ou Tous les passes) :

• Créer un remplacement : l’enregistrement d’une valeur personnalisée sur un pass individuel détache ce champ des mises à jour à l’échelle de la campagne. Les futures mises à jour de la campagne, y compris une actualisation planifiée par synchronisation des tags, ignoreront ce pass pour ce champ spécifique.
• Supprimer un remplacement : pour restaurer le contrôle de la campagne, modifiez le pass et cliquez sur Utiliser la valeur de la campagne à côté du champ remplacé.

Vous pouvez suivre quels passes ont des valeurs personnalisées dans l’onglet Passes sous la colonne Champs épinglés.

Onglet Passes

L’onglet Passes liste chaque pass émis par la campagne, y compris son numéro de série, l’ID utilisateur du destinataire, les champs épinglés actifs, la révision actuelle et la date de la dernière mise à jour.

Si la synchronisation des tags est activée, l’onglet affiche également une ligne Tags synchronisés au-dessus du tableau avec la date et l’heure de la dernière exécution planifiée, ou pas encore avant la première.

Utilisez les filtres du tableau pour trouver des passes spécifiques :

• Avec des champs épinglés : affiche les passes qui ont au moins un champ modifié sur mesure.
• En retard sur la révision : affiche les passes qui n’ont pas encore reçu la dernière mise à jour de la campagne.

Pour émettre de nouveaux passes ou joindre des passes existants, voir Émettre des passes aux utilisateurs.

Ouvrez le menu d’actions d’une ligne (⋮) pour gérer ce pass :

• Modifier : ouvrez le pass sur la page de modification de sa plateforme pour changer les champs personnels ou en remplacer un partagé.
• Télécharger : sur les campagnes Apple Wallet, téléchargez le fichier .pkpass signé. Les campagnes Google Wallet n’affichent pas cette option, car Google Wallet n’a pas d’équivalent de fichier téléchargeable.
• Envoyer un message : ouvrez le compositeur de push unique pour envoyer un message au destinataire du pass par ID utilisateur. Voir Envoyer un message aux détenteurs de Wallet Pass pour toutes les manières de les contacter.
• Code QR : affichez un code QR d’installation que les utilisateurs peuvent scanner pour ajouter le pass et enregistrer leur appareil pour les mises à jour.
• Copier le lien d’installation : copiez l’URL d’installation pour partager le pass dans vos canaux de messagerie.
• Supprimer : supprimez le pass. Cette action est irréversible. Sur Apple Wallet, les copies déjà installées cessent de recevoir des mises à jour et deviennent invalides lors de leur prochaine actualisation. Sur Google Wallet, Google ne permet pas de forcer la suppression d’un pass déjà enregistré sur un appareil, il devient donc invalide et est déplacé vers les Passes expirés de l’utilisateur pendant que Pushwoosh supprime son enregistrement. La suppression d’un pass ici ne supprime pas la campagne ni aucun autre pass émis.

Onglet Historique

L’onglet Historique liste toutes les révisions de la campagne par ordre chronologique, en montrant quels champs ont été modifiés dans chaque version.

Le statut de livraison de la mise à jour la plus récente apparaît sous les onglets :

• Annuler : arrête l’envoi de la mise à jour aux passes qu’elle n’a pas encore atteints. Ces passes restent sur leur révision précédente.
• Réessayer les échecs : tente à nouveau la livraison pour les passes qui n’ont pas pu être mis à jour (marqués comme échoués après 5 tentatives).

Une fois qu’une nouvelle révision est enregistrée, les anciennes mises à jour ne peuvent plus être réessayées ou annulées.

Supprimer une campagne

Ouvrez la campagne et cliquez sur Supprimer la campagne en haut à droite de la page.

La suppression d’une campagne ne supprime ni n’invalide les passes déjà émis. Les passes émis conservent leur contenu et leurs images actuels, mais cessent de recevoir des mises à jour partagées. Toute modification future devra être effectuée sur chaque pass individuellement.