Campagnes Wallet
Un template de pass définit l'apparence et le contenu par défaut d'un pass, et un formulaire d'inscription le distribue. Une campagne Wallet est la troisième pièce : elle vous permet de pousser une mise à jour coordonnée vers des pass déjà émis, sans recréer le template ni demander aux clients de télécharger un nouveau pass. La modification est appliquée directement au pass présent dans Apple Wallet ou Google Wallet.
Les campagnes Wallet existent en deux types. Une campagne temporaire met à jour les pass pendant une période définie puis les rétablit, ce qui convient aux ventes flash, promotions saisonnières, événements ou campagnes de fêtes. Une campagne scénarisée est pilotée par vos scénarios Actito : un événement de départ de scénario déclenche le flux, et un bloc d'action applique la campagne pour mettre à jour les champs du pass de chaque profil qui le traverse. Elle n'a pas de date de fin : chaque mise à jour écrase la valeur précédente, qui reste alors sur le pass, sans retour au template. Un cas d'usage typique est l'ajout de points de fidélité et de visites après un achat. Vous choisissez le type au moment de créer la campagne, et il est enregistré comme le mode de campagne.
Pour créer et gérer les campagnes, allez dans Hub > Wallet > Gérer les campagnes wallet. Cette zone liste vos campagnes et vous permet d'en créer une nouvelle, de consulter une campagne active ou d'en arrêter une.
Exclusivité des champs entre campagnes
Pour que le rendu sur les pass de vos clients reste prévisible, un champ donné ne peut être mis à jour que par une seule campagne active à la fois, quel que soit son type. Deux campagnes ne se disputent jamais le même champ, ce qui rendrait ambiguë la valeur finalement affichée sur le pass. Plusieurs campagnes peuvent donc tourner en parallèle, tant qu'elles mettent à jour des champs différents.
Le champ notification (messageWithNotification) est la seule exception : il n'est pas soumis à l'exclusivité, plusieurs campagnes peuvent donc envoyer leur propre notification en même temps.
En plus de cela, vous ne pouvez exécuter qu'une seule campagne temporaire à la fois sur un template donné. Une nouvelle campagne temporaire ne peut pas être activée tant qu'une autre est encore dans sa période d'activité.
Par exemple, une campagne temporaire Rentrée des classes met à jour heroImage, stripImage, le champ Offres et la notification, tandis qu'une campagne scénarisée Fidélité post-achat met à jour le champ points, le champ visites et la notification. Ces deux campagnes peuvent tourner en même temps : elles touchent des champs de contenu différents, et le champ notification qu'elles partagent est exempté de l'exclusivité.
Choisir un type de campagne
Lorsque vous créez une campagne depuis Campagnes Wallet, vous choisissez d'abord son type sur l'écran Choisir un type de campagne, puis vous démarrez À partir de zéro.
- Temporaire
- Scénarisée
Une campagne temporaire personnalise les pass wallet pendant une période définie. Les pass existants peuvent être mis à jour et les profils notifiés tant que la campagne est active, et tout revient au template une fois la période terminée. Cas d'usage typiques : ventes flash, promotions saisonnières, événements ou campagnes de fêtes.
Une campagne scénarisée met à jour automatiquement les pass wallet, et notifie éventuellement les profils, en fonction d'événements de scénario. Un événement de départ de scénario déclenche le flux, et un bloc d'action applique la campagne pour mettre à jour les champs du pass de chaque profil qui l'atteint. Les mises à jour sont appliquées individuellement à chaque déclenchement du scénario : chacune écrase la valeur précédente et reste sur le pass, sans période fixe ni retour en arrière. Cas d'usage typiques : mises à jour de points de fidélité, changements de palier, récompenses d'anniversaire ou renouvellement d'adhésion.
Les deux types utilisent le même assistant en cinq étapes décrit ci-dessous. Les différences entre temporaire et scénarisée sont signalées aux étapes concernées.
Étape 1 - Détails de la campagne
La première étape définit ce que la campagne cible et, pour une campagne temporaire, quand elle s'exécute.
| Champ | Description |
|---|---|
| Nom de la campagne | Le nom interne de votre campagne. Visible uniquement par vous et votre équipe dans le tableau de bord. Les clients ne le voient jamais. |
| Langues | Cochez les langues pour lesquelles la campagne fournira du contenu. La liste reflète les langues configurées pour votre licence. Vous pouvez définir la langue par défaut lorsque plusieurs langues sont cochées. |
| Template de pass Wallet | Le template auquel la campagne s'applique. Chaque pass généré à partir de ce template, et, en option, chaque pass déjà émis à partir de celui-ci, entre dans le périmètre. |
| Entité | L'entité dans laquelle la campagne s'exécute. |
| Table de profils | En lecture seule. Elle est automatiquement définie sur la table de profils liée au template de pass sélectionné. |
| Période d'activité | Campagnes temporaires uniquement. La plage de dates durant laquelle la campagne est active. Utilisez Sélectionnez une plage de dates pour définir les dates de début et de fin. Pour rappel, vous ne pouvez pas exécuter deux campagnes temporaires sur le même template en même temps. |
Une campagne scénarisée n'a pas de période d'activité : elle continue d'appliquer ses mises à jour sans fin déterminée, la plage de dates n'apparaît donc pas pour ce type.
Pour une campagne temporaire, la période d'activité détermine quand les mises à jour sont appliquées et retirées.
L'activation d'une campagne est traitée une fois par jour, à 9:00. De ce fait, vous ne pouvez pas définir une date de début le jour même : la date de début la plus proche possible pour une campagne temporaire est le lendemain.
Lorsque vous ouvrez Sélectionnez une plage de dates, un calendrier sur deux mois vous permet de définir les dates de début et de fin. Les jours déjà couverts par une campagne temporaire planifiée sur ce template sont signalés (voir la légende Campagne(s) planifiée(s)) et ne peuvent pas être sélectionnés, puisqu'une seule campagne temporaire peut être active sur un template à la fois. Les jours passés, ainsi que le jour même, ne sont pas non plus sélectionnables.
Pour une campagne temporaire, les pass générés pendant que la campagne est active (par exemple, un client qui s'inscrit pendant la campagne) reçoivent automatiquement les valeurs de la campagne ; une fois la période terminée, les nouveaux pass générés reviennent aux valeurs par défaut du template.
Étape 2 - Sélection des champs
Cette étape contrôle quelles parties du pass la campagne est autorisée à modifier. Les champs non sélectionnés continuent d'utiliser les valeurs par défaut du template, aussi bien pour les pass déjà émis que pour les pass générés pendant que la campagne est active.
Les champs disponibles dépendent du template de pass sélectionné à l'étape 1. Ils sont regroupés en Couleurs, Images, Champs et Notification, chacun avec une sous-section Recto. Cochez ceux que la campagne est autorisée à mettre à jour.
Chaque champ porte une ou plusieurs icônes indiquant la plateforme wallet à laquelle il s'applique : Apple, Google ou les deux. Certains champs n'existent que sur une seule plateforme, les icônes vous indiquent donc où une mise à jour prendra réellement effet.
Le groupe Notification contient messageWithNotification, le champ qui porte le message push envoyé au porteur du pass lorsque le pass est mis à jour. Cochez-le pour permettre à la campagne de définir ce message. Consultez Notifications Wallet pour comprendre le fonctionnement des notifications et leur configuration.
Un champ déjà réservé par une autre campagne active apparaît grisé et ne peut pas être sélectionné. C'est ce qui garantit l'exclusivité des champs : une seule campagne peut mettre à jour un champ donné à la fois. Si vous avez besoin d'un tel champ, attendez que l'autre campagne le libère.
Le compteur à côté de chaque en-tête de groupe indique combien de ses champs sont actuellement sélectionnés, par exemple Couleurs (0), Images (0), Champs (0), Notification (0).
Étape 3 - Versions du pass
Une fois les champs sélectionnés, vous définissez les valeurs que la campagne va appliquer. Vous renseignez les valeurs dans la langue par défaut définie à la première étape. Ce sont aussi les valeurs utilisées pour prévisualiser le pass.
Une campagne peut contenir jusqu'à cinq versions de pass, affichées dans le panneau Versions à gauche. La version de base est la Version de secours : elle contient les valeurs par défaut et s'applique à tout profil qui ne correspond à aucune autre version. Utilisez Ajouter pour créer des versions supplémentaires ciblant des audiences spécifiques.
Ajouter une version
Utilisez Ajouter pour ouvrir le panneau Ajouter une nouvelle version et créer une version qui s'applique uniquement aux profils correspondant à un ensemble de conditions.
Donnez un Nom de la version, puis définissez son audience sous Sources de données :
- Choisissez si un profil doit respecter toutes les (ET) ou au moins une (OU) des conditions.
- Utilisez Ajouter une source et Sélectionnez une source pour baser une condition sur l'ensemble des données du modèle de données, Ajouter un module pour ajouter une condition, et Ajouter un groupe OU pour combiner des conditions.
Une fois enregistrée, la version apparaît dans la liste Versions à côté de la Version de secours.
Renseigner le contenu
Sélectionnez une version dans la liste, puis définissez ses valeurs. Vous le faites séparément pour chaque plateforme wallet, à l'aide des onglets Apple et Google.
- Apple
Dans l'onglet Apple, définissez les valeurs pour la version Apple Wallet du pass. La section Images vous permet de charger une image pour remplacer la valeur actuelle, et la section Champs vous permet de saisir une valeur pour remplacer la personnalisation définie dans le template. La valeur par défaut du template est affichée sous chaque champ.
Dans l'onglet Google, définissez les valeurs pour la version Google Wallet du pass, séparément de l'onglet Apple. Seuls les champs qui s'appliquent à Google apparaissent ici.
Utilisez Personnalisation pour insérer un attribut de profil au lieu d'une valeur statique, afin que chaque pass se résolve avec les données propres au destinataire plutôt qu'avec une valeur fixe unique. Vous pouvez aussi réutiliser ou créer une personnalisation directement depuis un champ.
Utilisez le sélecteur de langue en haut à droite pour renseigner les valeurs de chaque langue déclarée à l'étape 1. L'aperçu à droite est fourni à titre informatif et peut ne pas refléter l'apparence finale du pass.
Ordre des versions
Un même profil peut correspondre à plusieurs versions en même temps. Dans ce cas, Actito applique la première version correspondante, en suivant l'ordre des versions dans la liste, de haut en bas. Classez vos versions de la plus spécifique à la plus générale afin que chaque profil se résolve sur la version voulue. La Version de secours s'applique à tout profil qui ne correspond à aucune autre version.
Étape 4 - Contrôle et test
Cette étape vous permet de prévisualiser le rendu de la campagne pour de vrais profils avant de l'activer.
Choisissez un Groupe de test pour charger un ensemble de profils de test. Pour chaque profil, le tableau affiche :
| Colonne | Signification |
|---|---|
| Profil de test | Le profil issu du groupe de test sélectionné. |
| Ciblé | Indique si le profil détient déjà un pass généré à partir de ce template. Seuls les profils ciblés peuvent être prévisualisés : si un profil n'est pas ciblé, il n'existe aucun pass à mettre à jour, donc aucun aperçu n'est disponible pour lui. |
| Langue | La langue qui sera utilisée pour ce profil. |
| Commentaire | Une note facultative attachée au profil de test. |
| Version | La version de campagne qui s'applique à ce profil, selon l'ordre des versions défini à l'étape 3. Elle affiche Aucune lorsque le profil n'est pas ciblé. |
| Actions | Utilisez l'icône en forme d'œil pour ouvrir un aperçu du contenu de la campagne pour ce profil précis. |
Un clic sur l'icône en forme d'œil ouvre un Aperçu du pass pour ce profil, avec un onglet Apple et un onglet Google pour vérifier les deux versions wallet.
Il n'est pas possible d'envoyer un test pour ce type de campagne. Utilisez la colonne "Actions" pour consulter le contenu de la campagne pour chaque profil de votre groupe de test.
Étape 5 - Activer
La dernière étape récapitule tout ce que vous avez configuré et vous permet d'activer la campagne.
Le Résumé récapitule votre configuration. La section Données générales affiche le nom, le Mode de campagne (temporaire ou scénarisée), les langues, le template de pass, l'entité et, pour une campagne temporaire, la période d'activité. Deux autres sections récapitulent la sélection des champs et les versions du pass. Développez chaque section pour vérifier votre configuration avant d'activer.
Les mises à jour sont transmises aux fournisseurs wallet de façon progressive. Google applique une limite de 20 mises à jour par seconde ; sur une audience importante, le déploiement vers tous les pass peut donc prendre un certain temps après l'activation.
Mettre à jour tous les pass existants
Pour une campagne temporaire, le bouton Mettre à jour tous les pass existants contrôle le périmètre de la campagne :
| Bouton | Comportement |
|---|---|
| Activé | Les mises à jour définies sont appliquées à tous les pass existants liés au template de pass, en plus des pass générés pendant que la campagne est active. Les pass existants sont mis à jour à partir de la date d'activation de la campagne. |
| Désactivé | Seuls les pass générés pendant que la campagne est active reçoivent les mises à jour. Les pass déjà présents dans les wallets des clients restent inchangés. |
Une campagne scénarisée n'affiche pas ce bouton : elle applique ses mises à jour au fur et à mesure que l'activité de vos clients les déclenche, plutôt qu'en une seule passe sur les pass existants.
Lorsque vous êtes prêt, cliquez sur Activer pour lancer la campagne.
Pour une campagne scénarisée, l'activation ne lance pas un run daté. Elle rend la campagne disponible dans vos scénarios : ajoutez-la à un bloc d'action pour que, lorsqu'un profil atteint cette étape après un événement de départ, la campagne mette à jour les champs de pass sélectionnés pour ce profil.
Pour une campagne temporaire, activer avec Mettre à jour tous les pass existants activé modifie les pass déjà présents dans les wallets de vos clients. Vérifiez bien vos valeurs de champ et votre période d'activité avant d'activer, et rappelez-vous qu'une seule campagne temporaire peut être active sur un template à la fois.
Consulter une campagne active
Une fois une campagne activée, vous pouvez l'ouvrir depuis la liste Gérer les campagnes wallet pour consulter sa définition. La vue est en lecture seule et affiche les mêmes informations que le résumé de l'étape 5 : données générales, sélection des champs et versions du pass. Utilisez-la pour confirmer ce qu'une campagne active fait actuellement, sans aucun risque de la modifier.
Arrêter une campagne
Une campagne temporaire se termine de deux façons : automatiquement, lorsque sa période d'activité atteint la date de fin, ou manuellement, lorsque vous l'arrêtez vous-même. Une campagne scénarisée n'a pas de date de fin ; elle continue de mettre à jour ses champs jusqu'à ce que vous l'arrêtiez ou qu'une autre campagne les reprenne.
Lorsqu'une campagne temporaire se termine, tous les pass liés au template reviennent au contenu par défaut défini dans le template de pass. Pour l'arrêter avant sa date de fin, ouvrez-la depuis la liste Gérer les campagnes wallet et cliquez sur Arrêter : le retour à l'état initial est alors appliqué immédiatement. L'arrêt libère aussi les champs que la campagne réservait, afin qu'une autre campagne puisse les utiliser.
Une campagne scénarisée ne revient jamais en arrière. Comme elle n'a pas de moment de fin, chaque valeur qu'elle pousse reste simplement sur le pass jusqu'à ce que la mise à jour suivante la remplace. Arrêter une campagne scénarisée laisse les dernières valeurs en place ; cela sert uniquement à libérer les champs pour qu'une autre campagne puisse les utiliser.
Arrêter une campagne temporaire rétablit immédiatement chaque pass concerné à l'état de base du template de pass, y compris les pass déjà présents dans les wallets de vos clients. Pour réappliquer des valeurs par la suite, vous devez lancer une nouvelle campagne.
Enchaîner des campagnes
Il existe une exception à ce retour à l'état initial. Si une seconde campagne temporaire est planifiée pour démarrer sur le même template juste au moment où la première se termine (périodes d'activité qui se suivent), les pass ne reviennent pas à l'état de base du template entre les deux. Ils passent directement du contenu de la première campagne à celui de la seconde.