Démarrer avec les passes Apple Wallet

Les passes Apple Wallet sont des cartes numériques, telles que des cartes de fidélité, des coupons, des billets d’événement, des cartes d’embarquement et des cartes de magasin, que vos utilisateurs conservent dans l’application Wallet sur iPhone et Apple Watch. Avec Pushwoosh, vous pouvez concevoir un pass visuellement dans le Control Panel, le partager, puis envoyer des mises à jour à tout moment sans demander aux utilisateurs de réinstaller quoi que ce soit.

Lorsque vous modifiez un pass, Pushwoosh notifie chaque appareil qui l’a ajouté, et iOS récupère discrètement la nouvelle version. Le code-barres, le solde, le numéro de porte ou la date d’expiration sur le téléphone de l’utilisateur se met à jour automatiquement.

Ce que vous pouvez faire avec les passes Apple Wallet

Avec les passes Apple Wallet dans Pushwoosh, vous pouvez :

• Concevoir des passes visuellement avec des couleurs, des champs, un logo, une image de bannière et un code-barres, sans écrire pass.json à la main.
• Créer des cartes de fidélité, des coupons, des billets d’événement, des cartes d’embarquement et des cartes de magasin génériques.
• Distribuer les passes aux utilisateurs sous forme de fichier .pkpass, de lien d’installation ou de code QR.
• Mettre à jour le contenu du pass et livrer les modifications aux appareils qui ont ajouté le pass.

Prérequis

Assistance d'un développeur requise

L’émission de passes Apple Wallet nécessite un compte Apple Developer et des certificats de signature. Partagez cette section avec votre équipe de développeurs pour effectuer la configuration unique.

Avant de concevoir votre premier pass, confirmez les points suivants :

• Programme Apple Developer : Vous avez besoin d’un abonnement actif pour enregistrer les ID de type de pass et créer des certificats de signature. S’inscrire ou gérer votre compte
• Plateforme iOS : Votre application doit avoir iOS connecté dans Pushwoosh avant de pouvoir ajouter un certificat de signature de pass. Configurer iOS

Commencer à travailler avec les passes Apple Wallet

Une fois les prérequis en place, suivez ce processus :

1. Configurer les passes Wallet dans Pushwoosh

   Avant de pouvoir concevoir des passes, Pushwoosh doit disposer de votre certificat de signature Apple pour l’application. Votre équipe de développeurs le crée dans Apple Developer et le télécharge sur Pushwoosh. Il s’agit d’une configuration unique par application.

   Comment configurer le certificat de signature

2. Concevoir le pass

   Dans le constructeur de passes, choisissez un style de pass, définissez les champs et l’image de marque, et vérifiez l’aperçu en direct.

3. Générer un .pkpass signé

   Une fois que vous avez créé et validé le pass, dans le constructeur de passes, sélectionnez Générer. Pushwoosh prépare les images aux résolutions requises et signe le fichier avec votre certificat.

4. Distribuer le pass

   Envoyez aux utilisateurs le fichier .pkpass, le lien d’installation ou le code QR. Voir Partager le pass avec les utilisateurs via les canaux Pushwoosh. Lorsque les utilisateurs ajoutent le pass à Wallet, leur appareil s’enregistre pour les futures mises à jour.

5. Mettre à jour le contenu du pass

   Modifiez le pass dans le constructeur de passes ou via l’API et enregistrez. Pushwoosh notifie les appareils enregistrés, et iOS télécharge la nouvelle version en arrière-plan. Les utilisateurs n’ont pas besoin de réinstaller le pass.

Afficher et gérer les passes existants

Dans le Control Panel, allez à Campaigns → Apple Wallet pour ouvrir la liste des passes. La page répertorie chaque pass pour l’application, y compris son nom, son style, l’User ID auquel il est associé, ainsi que la date et l’heure de sa dernière mise à jour.

Dans la liste des passes, ouvrez le menu des actions (⋮) pour :

• Modifier : changer le nom et la description du pass, les valeurs et les libellés des champs, les messages, les couleurs, le message du code-barres, l’expiration et le statut, et les emplacements. Le style et les images du pass restent verrouillés après la création. Lorsque vous enregistrez, chaque appareil qui a ajouté le pass reçoit la mise à jour.

Les mises à jour sont livrées sous forme de notifications push silencieuses

Lorsque vous enregistrez une modification, Pushwoosh signe à nouveau le pass et notifie chaque appareil enregistré avec une notification push sans contenu. iOS récupère la nouvelle version de lui-même — aucune réinstallation n’est requise.

• Télécharger : télécharger le fichier .pkpass signé.
• Code QR : afficher un code QR d’installation que les utilisateurs peuvent scanner pour ajouter le pass à Wallet et enregistrer leur appareil pour les mises à jour. Dans cette fenêtre, vous pouvez également utiliser Copier le lien d’installation sous le QR.
• Copier le lien d’installation : copier l’URL d’installation pour partager le pass dans vos canaux de messagerie. En savoir plus.
• Supprimer : supprimer le pass. Les copies déjà installées sur les appareils cessent de recevoir des mises à jour et deviennent invalides lors de leur prochain rafraîchissement.

Partager le pass avec les utilisateurs via les canaux Pushwoosh

Le lien d’installation que vous copiez dans le constructeur (Copier le lien d’installation) est une URL normale. L’ouvrir sur un iPhone ajoute le pass à Apple Wallet. Vous pouvez utiliser ce lien dans les mêmes canaux Pushwoosh que vous utilisez déjà pour atteindre votre public :

• E-mail : ajoutez le lien à un bouton ou un lien texte dans l’éditeur d’e-mails, par exemple, un appel à l’action « Ajouter à Apple Wallet ».
• Notifications push : définissez le lien comme action d’ouverture de la notification afin qu’un appui ouvre le pass.
• SMS : incluez le lien dans le contenu SMS.

Un lien par pass

Chaque lien d’installation est lié à un seul pass (il contient le numéro de série et le jeton de ce pass), donc un lien fonctionne pour un pass partagé, ce qui est pratique pour un coupon commun ou un billet d’événement. Pour donner à chaque destinataire son propre pass, générez un pass par utilisateur avec l’API PassKit et envoyez à chaque utilisateur son propre lien. Les passes Wallet s’installent uniquement sur les appareils Apple — iPhone et Apple Watch.

Gérer les passes via l’API

Tout ce que fait le constructeur de passes est également disponible par programmation via l’API PassKit Designer : créer, mettre à jour, lister, télécharger et supprimer des passes.

API PassKit Apple Wallet