Skip to main content

​
Accéder aux paramètres du Workflow

Ouvrez l’application Workflows depuis la barre latérale, puis naviguez vers la page Settings. La page de paramètres comporte deux onglets :
  • Variable profiles — Configurer des modèles de paramètres d’URL réutilisables.
  • JSON Templates — Définir et gérer les templates de sortie JSON pour les intégrations headless.
Les catégories de branche se configurent avec les tags dans les paramètres Analytics, pour regrouper toute votre nomenclature au même endroit.

​
Variable Profiles

Onglet des paramètres de Variable Profiles montrant les profils configurés Les Variable Profiles sont des modèles réutilisables de paramètres d’URL appliqués lors de l’intégration du Workflow. Ils font gagner du temps lorsque vous avez un ensemble standard de paramètres de suivi (tags UTM, identifiants utilisateur, etc.) utilisés dans plusieurs Workflows.

​
Consulter les profils

L’onglet des Variable Profiles affiche un tableau de tous les profils configurés avec leurs noms et paramètres.

​
Créer un Variable Profile

1

Ouvrir le formulaire

Cliquez sur le bouton Add pour ouvrir le panneau de création de Variable Profile.
2

Configurer le profil

  • Name — Un nom descriptif (ex. « Standard Email Tracking », « Web Campaign UTM »).
  • Parameters — Définissez les paramètres d’URL inclus dans ce profil :
    • Parameter name — La clé du paramètre d’URL (ex. utm_source, user_id).
    • Default value — Une valeur par défaut optionnelle pour le paramètre.
3

Enregistrer

Cliquez sur Save pour créer le profil. Il sera disponible à la sélection lors de l’intégration du Workflow.

​
Modifier un profil

Cliquez sur un profil dans le tableau pour ouvrir le panneau d’édition. Mettez à jour le nom ou les paramètres selon vos besoins.

​
Supprimer un profil

  1. Cliquez sur l’action Delete sur la ligne du profil.
  2. Confirmez la suppression.
Supprimer un Variable Profile n’affecte pas les intégrations de Workflow déjà déployées. Cependant, les futures intégrations ne pourront plus sélectionner ce profil.

​
Conseils

  • Créez des profils séparés pour les différents Channels (email vs. web) car ils utilisent généralement des paramètres de suivi différents.
  • Standardisez les noms de paramètres au sein de votre équipe pour garantir des données Analytics cohérentes.
  • Les Variable Profiles complètent les Nodes URL Parameter dans les Workflows — le profil fournit la structure des paramètres, et le Node URL Parameter lit la valeur à l’exécution.

​
JSON Templates

Onglet des paramètres JSON Templates montrant la liste des templates Les JSON Templates définissent la structure et le contrat des payloads JSON renvoyés par les Output Nodes JSON Template. Ils constituent la source de vérité unique pour ce que vos consommateurs (applications mobiles, frontends, intégrations tierces) recevront.
Cette section est destinée aux équipes techniques et contractuelles qui définissent le schéma. Les équipes marketing utilisent les templates résultants dans l’éditeur de Workflow — consultez l’Output Node JSON Template pour les instructions d’utilisation.

​
Pourquoi utiliser les JSON Templates ?

Les JSON Templates séparent la définition du schéma de la liaison des données :
  • L’équipe technique définit la forme (quels champs existent, lesquels sont statiques, lesquels sont des variables dynamiques).
  • L’équipe marketing décide quelles données remplissent chaque variable en connectant les champs de Datasources dans le Workflow.
Cette séparation signifie que votre frontend peut s’appuyer sur un contrat stable — les champs ne changent jamais de manière inattendue — tandis que le marketing conserve un contrôle total sur les données personnalisées mises en avant.

​
Consulter les templates

L’onglet JSON Templates affiche tous les templates configurés avec leur nom et le nombre de variables. Cliquez sur un template pour ouvrir son panneau d’édition.

​
Créer un template

1

Ouvrir le formulaire de création

Cliquez sur le bouton Create dans le coin supérieur droit de l’onglet JSON Templates. Un panneau s’ouvre à droite.
2

Nommer le template

Saisissez un nom descriptif (ex. « Product Recommendations », « Loyalty Dashboard »).
3

Attribuer des Teams

Sélectionnez une ou plusieurs Teams qui doivent avoir accès à ce template. Cela contrôle la visibilité — seuls les Workflows appartenant aux Teams correspondantes verront ce template dans la configuration de leur Node.
4

Définir le schéma JSON

Utilisez l’éditeur JSON pour écrire la définition du template. Chaque champ est une paire clé-valeur dont la valeur décrit comment il sera résolu :
  • Champs statiques — { "type": "static", "value": <défaut> } — Valeurs codées en dur qui ne changent jamais à l’exécution.
  • Champs de dépendance — { "type": "dependency", "variable": "<nomVariable>" } — Emplacements dynamiques liés aux champs de Datasources par l’équipe marketing.
À l’exécution, les valeurs statiques sont renvoyées telles quelles et les valeurs de dépendance sont remplacées par les données réelles de la Datasource liée.
5

Configurer les variables

Pour chaque champ de dépendance dans la définition, ajoutez une entrée de variable :
  • Name — Doit correspondre exactement à la valeur variable de la définition (ex. productName).
  • Description — Optionnelle ; aide l’équipe marketing à comprendre ce que représente la variable.
  • Value — Choisissez comment la variable résout ses données :
    • Array — récupérer toutes les valeurs de la Datasource (ex. une liste de produits).
    • Scalar — récupérer une seule valeur, choisie automatiquement (ex. un score de fidélité unique).
    • Datasource item #1 … #20 — toujours récupérer une position fixe dans la Datasource (ex. toujours le 2e produit).
6

Choisir une variable de redirection au clic (optionnel)

Utilisez le menu Variable de redirection au clic pour choisir la variable qui contient une URL (ex. productUrl). Lorsqu’un visiteur clique sur le lien de suivi des clics du Workflow, il est redirigé vers cette URL et le clic est enregistré.Seules les variables Scalar et Datasource item peuvent être sélectionnées. Laissez Aucune redirection si le template n’a pas vocation à être cliqué.
7

Enregistrer

Cliquez sur Save pour créer le template. Il devient immédiatement disponible à la sélection dans les Output Nodes JSON Template de vos Workflows.

​
Modifier un template

Cliquez sur un template dans la liste pour ouvrir son panneau d’édition. Vous pouvez mettre à jour le nom, la définition JSON, les variables et la variable de redirection au clic. Les modifications prennent effet à la prochaine publication de tout Workflow utilisant ce template.
Modifier le schéma (ajouter/supprimer des champs ou renommer des variables) peut casser les intégrations existantes. Coordonnez-vous avec les frontends consommateurs avant d’effectuer des changements structurels.

​
Supprimer un template

  1. Ouvrez le panneau d’édition du template.
  2. Cliquez sur le bouton Delete.
  3. Confirmez la suppression dans la modale.
Supprimer un template fera échouer la validation de publication de tout Workflow le référençant. Assurez-vous qu’aucun Workflow actif ne dépend du template avant de le supprimer.

​
Bonnes pratiques pour la définition JSON

  • Restez plat quand c’est possible. Les objets imbriqués sont supportés mais les schémas plats sont plus faciles à consommer pour les équipes frontend.
  • Utilisez des noms de clés significatifs. Des clés comme productName, loyaltyScore, recommendedItems sont auto-documentées.
  • Fournissez des valeurs statiques par défaut réalistes. Utilisez des valeurs qui reflètent le type attendu (ex. { "type": "static", "value": "default text" } pour les chaînes, { "type": "static", "value": 0 } pour les nombres).
  • Documentez le contrat en externe. Partagez la forme de sortie à l’exécution (avec les variables résolues) avec votre équipe frontend/mobile pour qu’elle puisse construire des clients typés.

​
Configuration des variables

Chaque variable représente un emplacement dynamique dans le payload JSON :

​
Validation à la publication

Lorsqu’un Workflow avec des Output Nodes JSON Template est publié, le système valide :
  1. Le template existe — L’identifiant de template référencé doit pointer vers un template existant.
  2. Cohérence inter-branches — Tous les Nodes JSON Template de toutes les branches doivent référencer le même template. Cela garantit que chaque branche produit la même forme JSON.
Si la validation échoue, la publication est bloquée avec un message d’erreur clair indiquant quel Node ou quelle branche présente une incohérence.