Attributs de propriétés du parcours journey-properties
Dans l’éditeur d’expression simple et dans l’éditeur d’expression avancé, sous les catégories Événement et Source de données, vous pouvez accéder à la catégorie Propriétés du parcours. Cette catégorie contient des champs techniques liés au parcours d’un profil donné. Il s’agit des informations récupérées par le système à partir de parcours actifs, telles que l’ID du parcours ou les erreurs spécifiques rencontrées.
Elle contient par exemple des informations sur les éléments suivants :
-
version du parcours : uid du parcours, uid de la version du parcours, uid de l’instance, etc.
-
erreurs : extraction de données, exécution d’actions, etc.
-
étape en cours, dernière étape en cours, etc.
-
profils ignorés
La liste des champs est disponible dans cette section.
Vous pouvez utiliser ces champs pour créer des expressions. Pendant l’exécution du parcours, les valeurs sont récupérées directement à partir de celui-ci.
Voici quelques exemples de cas d’utilisation :
-
Enregistrer les profils ignorés : vous pouvez envoyer tous les profils exclus d’un message par une règle de limitation à un système tiers à des fins de journalisation. Pour ce faire, vous configurez un chemin en cas de temporisation et d’erreur et ajoutez une condition pour filtrer selon un type d’erreur spécifique, par exemple : « Ignorer les gens par règle de limitation ». Vous pouvez ensuite envoyer les profils ignorés à un système tiers par le biais d’une action personnalisée.
-
Envoyer des alertes en cas d’erreurs : vous pouvez envoyer une notification à un système tiers chaque fois qu’une erreur se produit sur un message. Pour ce faire, vous configurez un chemin en cas d’erreur, ajoutez une condition et une action personnalisée. Vous pouvez envoyer une notification sur un canal Slack, par exemple, avec la description de l’erreur rencontrée.
-
Affiner les erreurs du reporting : au lieu d’avoir un seul chemin pour les messages d’erreur, vous pouvez définir une condition par type d’erreur. Vous pourrez ainsi affiner le reporting et consulter toutes les données de types d’erreur.
Liste de champs journey-properties-fields
Type d’erreur de la dernière activité (nœud) en erreur. Types possibles :
- Événements : événements, réactions, SQ (exemple : qualification d’audience)
- Contrôle de flux : Fin, Condition, Attente
- Actions : Actions ACS, Saut, Action personnalisée
Code d’erreur de la dernière activité (nœud) en erreur. Erreurs possibles :
- Codes d’erreur HTTP
- limité
- timedOut
- erreur (exemple : par défaut en cas d’erreur inattendue. Ne devrait pas/extrêmement rarement se produire)
Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.
Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.
- TL;DR: Cette page décrit la catégorie Propriétés du Parcours dans l’éditeur d’expression, un ensemble de champs techniques relatifs à l’instance de parcours dynamique (identifiants, erreurs, nœuds actuels/précédents, temps écoulés) qui peuvent être utilisés pour créer des expressions pour la journalisation, les alertes et les rapports spécifiques aux erreurs.
Intentions:
- Accédez aux champs Propriétés du Parcours dans l’éditeur d’expression simple ou avancé pour référencer les métadonnées des parcours en direct
- Créez une condition qui filtre les profils ignorés par type d’erreur pour les acheminer vers un système de journalisation tiers
- Envoyez des alertes d’erreur à un canal externe (par exemple, Slack) en référençant le dernier code d’erreur et le nom du nœud dans une action personnalisée
- Affinez le rapport d’erreurs de parcours en créant des chemins de condition distincts par type d’erreur à l’aide de
lastNodeTypeInErroretlastErrorCode - Identifiants de version de parcours de référence, identifiants d’instance et nom de sandbox dans les expressions pour le suivi et le contrôle
Glossaire:
- Propriétés du Parcours : catégorie dans l’éditeur d’expression contenant des champs de métadonnées techniques pour l’instance d’exécution de parcours en cours (spécifiques au produit)
- instanceUID : identifiant unique de l’instance de parcours pour une d’exécution de profil donnée (spécifique au produit)
- lastErrorCode : code d’erreur de l’activité ayant échoué la plus récente dans le parcours. Les valeurs possibles incluent les codes HTTP,
capped,timedOuteterror(spécifiques au produit) - lastNodeTypeInError : type de la dernière activité ayant rencontré une erreur. Il peut s’agir d’événements, de contrôle de flux ou d’actions (spécifique au produit)
- externalKey : identifiant individuel (par exemple, identifiant de profil) ayant déclenché l’d’instance de parcours (spécifique au produit)
Mécanismes de sécurisation :
- Les valeurs des champs Propriétés du parcours sont directement extraites du parcours actif au moment de l’exécution. Elles ne sont pas disponibles pour la validation de pré-exécution.
- Le champ
lastErrorCodeutilise des valeurs prédéfinies : codes d’erreur HTTP,capped,timedOuteterror - Les propriétés du parcours sont disponibles dans les éditeurs d’expression simple et avancé, dans la catégorie Propriétés du Parcours .
Terminologie:
- Nom canonique : Propriétés du Parcours — Acronyme : none — variantes : champs techniques du parcours, champs de métadonnées du parcours
- Synonymes : « Propriétés du Parcours » = « Champs techniques du parcours » ; « instanceUID » = « Identifiant de l’instance du parcours »
- Ne pas confondre : journeyUID (identifie la définition de parcours) ≠ instanceUID (identifie l’exécution du parcours par un profil spécifique)
FAQ:
- Q : Où puis-je trouver les champs Propriétés du Parcours dans l’éditeur d’expression ? — Ils apparaissent dans les éditeurs d’expression simple et avancé sous la catégorie Propriétés du Parcours, sous Événements et Sources de données.
- Q : Comment puis-je consigner les profils ignorés par une règle de limitation ? — Ajoutez un filtre de condition de chemin d’erreur sur
lastErrorCode == "capped"et envoyez ces profils à un système tiers via une action personnalisée. - Q : Quelle est la différence entre
journeyUIDetinstanceUID? —journeyUIDidentifie la définition du parcours ;instanceUIDidentifie une instance d’exécution spécifique pour un profil donné. - Q : Quel code d’erreur est renvoyé en cas d’erreur système inattendue ? — Le code
error, qui est utilisé par défaut pour les erreurs inattendues et qui devrait se produire rarement. - Q : Puis-je utiliser les champs Propriétés du Parcours pour envoyer des alertes Slack sur les échecs d’action ? — Oui ; référencez
lastNodeNameInErroretlastErrorCodedans une action personnalisée pour inclure les détails de l’erreur dans une notification Slack.