Créer des campagnes de Pass Wallet

Une campagne de Pass Wallet 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 changements 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 Pass Wallet n’est pas liée à une campagne Customer Journey ou à une notification push. C’est un outil pour gérer les modèles de pass, leur émission et les mises à jour en temps réel des pass.

Ce que vous pouvez faire avec les campagnes de Pass Wallet

• 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 pass émis une modification de champ affecte avant de l’enregistrer.
• Remplacer un champ partagé sur un pass, puis redonner le contrôle à la campagne plus tard.
• Attacher des pass é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.

Prérequis

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

Apple Wallet :

• Un abonnement actif au programme pour développeurs Apple
• La plateforme iOS connectée à l’application
• Un certificat de signature de pass téléversé sur Pushwoosh

Google Wallet :

• Un 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 → Pass Wallet → 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 fidélité, 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 paramètre ne peut pas être modifié après la création. Voir Choisir un type de pass.

Configurer le design et la 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 pass dans le constructeur de pass Apple Wallet ou Concevoir des pass Google Wallet dans le constructeur de pass.
• Champs du pass : ajoutez les champs qui doivent apparaître sur la carte (voir Champs de pass Apple Wallet ou Champs et détails de 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 pass 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é	Géré 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 ne remplace pas ces valeurs lors de la mise à jour.	Nom de l’utilisateur, Numéro de siège, ID de membre, Solde de points

La valeur d’un champ personnel peut inclure un placeholder de 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 du placeholder, ou laisse le champ vide si le placeholder 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 le pass.
• Le tag mélangé avec d’autres textes, 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 le pass, pré-rempli avec cette valeur. Tout tag à l’intérieur est toujours résolu 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.

Télécharger 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. Vérifiez le panneau Prévisualiser en tant qu’utilisateur sur la droite pour voir à quoi ressemble la carte. Vous pouvez saisir un User ID 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 la campagne en bas de la page.

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

Note

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

Émettre des pass aux utilisateurs

Émettre un pass depuis la campagne

1. Dans l’onglet Pass, cliquez sur Émettre le pass.
2. Saisissez le User ID Pushwoosh du destinataire.

3. Cliquez sur Émettre le pass pour confirmer.

Selon la configuration de vos 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.
• Placeholders de tag (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 Pass et dans le tableau Tous les pass 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 à l’appareil de l’utilisateur, partagez le lien d’installation :

1. Ouvrez le menu d’actions du pass dans l’onglet Pass ou dans Tous les pass.
2. Sélectionnez Copier le lien d’installation ou Code QR. Les pass 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 avancent dans un parcours, utilisez l’élément Émettre un Pass Wallet au lieu de l’émettre ici.

Pour plus de façons de distribuer les pass, consultez Partager les pass Apple Wallet ou Partager les pass Google Wallet.

Attacher un pass existant à une campagne

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

1. Dans l’onglet Pass, cliquez sur Attacher des pass.
2. Recherchez des pass par User ID, numéro de série ou code-barres.
3. Sélectionnez les pass et confirmez.

Une fois attachés :

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

Attacher des pass via l'API

Vous pouvez également attacher des pass 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 attaché, 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.
• Le pass ne contient pas les 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 → Pass Wallet → Campagnes affiche son statut, son compteur de révisions, un aperçu en direct du pass et trois onglets principaux : Conception, Pass et Historique.

Changer le statut de la campagne

Utilisez le statut pour suivre l’état de chaque campagne : en cours de conception, émettant activement des pass, ou terminée et archivée.

Pour changer le statut, sélectionnez une option dans la liste déroulante Statut dans l’en-tête de la campagne. Le changement est enregistré immédiatement sans étape de confirmation séparée :

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

Onglet Conception

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

Mettre à jour le design et envoyer les modifications aux pass

La modification de l’un des éléments suivants et le clic sur Enregistrer les modifications affichent une boîte de dialogue de confirmation indiquant combien de pass émis seront mis à jour :

• Informations de base, couleurs ou type de code-barres
• Expiration ou lieux
• Un champ partagé
• Une image de campagne

Confirmez la mise à jour :

• Si aucun pass n’a de remplacement : cliquez sur Mettre à jour pour envoyer les modifications à tous les pass émis.
• Si certains pass ont des remplacements : choisissez de mettre à jour uniquement les pass standard (en préservant les remplacements des utilisateurs) ou de remplacer tous les pass.

La confirmation de la mise à jour incrémente le compteur de révisions de la campagne (par exemple, à Révision 2) et synchronise automatiquement les changements sur les appareils des utilisateurs.

Note

Une modification effectuée alors qu’aucun pass n’est encore émis est enregistrée immédiatement sans boîte de dialogue de confirmation, car il n’y a pas de pass 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 Pass ou Tous les pass) :

• 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 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 pass ont des valeurs personnalisées dans l’onglet Pass sous la colonne Remplacements.

Onglet Pass

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

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

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

Pour émettre de nouveaux pass ou attacher des pass existants, consultez Émettre des pass aux utilisateurs.

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

• Modifier : ouvrez le pass sur la page d’édition de sa plateforme pour changer les champs personnels ou remplacer un champ 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 User ID. Consultez Envoyer un message aux détenteurs de Pass Wallet pour toutes les façons 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 prochain rafraîchissement. Sur Google Wallet, Google ne permet pas de supprimer de force un pass déjà enregistré sur un appareil, il devient donc invalide et se déplace vers les Pass 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 pass qu’elle n’a pas encore atteints. Ces pass restent sur leur révision précédente.
• Réessayer les échecs : tente à nouveau la livraison pour les pass dont la mise à jour a échoué (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 pass déjà émis. Les pass é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.