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

Catégorie
Nom du champ
Libellé
Description
Version de parcours
journeyUID
Identifiant de parcours
journeyVersionUID
Identifiant de version du parcours
journeyVersionName
Nom de la version du parcours
journeyVersionDescription
Description de la version du parcours
journeyVersion
Version de parcours
Instance de parcours
instanceUID
Identifiant d’instance de parcours
Identifiant de l’instance
externalKey
Clé externe
Identifiant individuel déclenchant le parcours
organizationId
Identifiant de l’organisation
Organisation de la marque
sandboxName
Nom du sandbox
Nom du sandbox
Identité
profileId
Identifiant d’identité du profil
Identifiant du profil dans le parcours
espace de noms
Espace de noms d’identité de profil
Espace de noms du profil dans le parcours (exemple : ECID)
Nœud actuel
currentNodeId
Identifiant de nœud actuel
Identifiant de l’activité actuelle (nœud)
currentNodeName
Nom du nœud actuel
Nom de l’activité actuelle (nœud)
Nœud précédent
previousNodeId
Identifiant de nœud précédent
Identifiant de l’activité précédente (nœud)
previousNodeName
Nom du nœud précédent
Nom de l’activité précédente (nœud)
Erreurs
lastNodeUIDInError
Dernier identifiant de nœud en erreur
Identifiant de la dernière activité (nœud) en erreur
lastNodeNameInError
Nom du dernier nœud en erreur
Nom de la dernière activité (nœud) en erreur
lastNodeTypeInError
Dernier type de nœud en erreur

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
lastErrorCode
Dernier code d’erreur

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)
lastExecutedActionErrorCode
Code d’erreur de la dernière action exécutée
Code d’erreur de la dernière action en erreur
lastDataFetchErrorCode
Code d’erreur de la dernière récupération de données
Code d’erreur de la dernière récupération de données à partir des sources de données
Heure
lastActionExecutionElapsedTime
Temps écoulé avant l’exécution de la dernière action
Temps passé à exécuter la dernière action
lastDataFetchElapsedTime
Temps écoulé avant la dernière récupération des données
Temps passé à exécuter la dernière récupération de données à partir de sources de données
Référence des connaissances sur l’IA

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 lastNodeTypeInError et lastErrorCode
  • 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, timedOut et error (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 lastErrorCode utilise des valeurs prédéfinies : codes d’erreur HTTP, capped, timedOut et error
  • 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 journeyUID et instanceUID ?journeyUID identifie la définition du parcours ; instanceUID identifie 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 lastNodeNameInError et lastErrorCode dans une action personnalisée pour inclure les détails de l’erreur dans une notification Slack.
recommendation-more-help
journey-optimizer-help